> For the complete documentation index, see [llms.txt](https://docs.metasleuth.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metasleuth.io/ru/blocksec-aml-api/introduction/api-security-settings.md).

# API Security Settings

Защитите доступ с помощью IP Allowlist, Request Signing или обоих методов. Настраивайте защиту Address Label API и Risk Score API отдельно.

Откройте [Settings → APIs → API Keys](https://metasleuth.io/system/settings/personal/apis), найдите нужный API и выберите **Security Settings**. Если API-ключа нет, сначала создайте его.

## Выбор методов защиты

* **IP Allowlist** ограничивает доступ публичными исходящими IP-адресами ваших серверов.
* **Request Signing** проверяет запросы с помощью API-секрета, хранящегося в приложении.

Если включены оба метода, каждый запрос должен пройти обе проверки. Установка или снятие флажка не применяет изменения: проверьте настройки и выберите **Save Changes**.

Сохранённая настройка подписи с отложенным обязательным применением считается завершённой настройкой защиты. До указанного времени запросы без подписи подчиняются другим действующим проверкам безопасности.

## Настройка IP Allowlist

1. Выберите **IP Allowlist**.
2. Введите публичные исходящие IPv4- или IPv6-адреса серверов либо диапазоны CIDR.
3. Используйте **Add IP** для одной записи или **Bulk Add** для вставки нескольких записей, по одной в строке.
4. Проверьте весь список и выберите **Save Changes**. При необходимости подтвердите изменения.

Можно сохранить до **10 уникальных записей на API-ключ**. Каждый IP-адрес или диапазон CIDR считается одной записью. Дубликаты удаляются, но пересекающиеся сети автоматически не объединяются.

Используйте публичные исходящие адреса, например адреса NAT-шлюзов, через которые приложение подключается к API. IP браузера автоматически не добавляется. Перед применением списка включите исходящие IP всех серверов приложения.

Не поддерживаются подстановочные знаки (`*`, `?`), домены, URL, порты, диапазоны в виде начального/конечного адреса, частные и loopback-адреса, а также диапазоны, разрешающие все адреса, например `0.0.0.0/0` или `::/0`.

Изменения IP Allowlist действуют **сразу после сохранения**. Запросы с удалённых IP отклоняются. Bulk Add меняет только несохранённый список; для применения выберите Save Changes.

### Изменение или отключение IP Allowlist

Измените записи и сохраните их для замены действующего списка. Для отключения снимите флажок **IP Allowlist** и сохраните. Сохранённые записи остаются для дальнейшего использования.

Если ключ требует защиты, перед удалением последнего действующего метода уже должен действовать другой. При смене методов следуйте проверкам в Security Settings.

## Включение Request Signing

1. Выберите **Request Signing** и создайте API-секрет.
2. Скопируйте секрет и сохраните его в безопасном месте. Он **отображается только один раз**; после закрытия диалога просмотреть его снова нельзя.
3. Выберите **I have saved this API secret.**
4. Выберите **In 24 hours** или **Immediately**, затем **Save Changes** и подтвердите.

При **In 24 hours** новый секрет работает после сохранения. Переведите все приложения на подписанные запросы до указанного времени обязательного применения. До этого запросы без подписи подчиняются другим правилам доступа. Недействительные подписи отклоняются даже в переходный период.

При **Immediately** каждый запрос должен иметь действительную подпись сразу после сохранения. Прежде чем выбрать этот вариант, убедитесь, что приложение готово.

Заголовки подписи, примеры кода и устранение неполадок см. в [Request Signing](https://docs.metasleuth.io/ru/blocksec-aml-api/introduction/request-signing.md). Тестовые вызовы являются реальными рабочими запросами и могут расходовать квоту API.

### Состояние подписи

| Состояние   | Значение                                                                            |
| ----------- | ----------------------------------------------------------------------------------- |
| Not enabled | Первоначальная настройка подписи ещё не сохранена.                                  |
| Scheduled   | Настройка сохранена; с указанного времени подписанные запросы станут обязательными. |
| Active      | Каждый запрос должен содержать действительную подпись.                              |

При ротации секрета подпись остаётся Active. Метка **Not saved** у нового секрета означает, что замена ещё не применена.

## Ротация API-секрета

Выполняйте ротацию при потере, раскрытии или плановой замене секрета. API-ключ не меняется. Если старый секрет мог быть раскрыт, выберите **Immediately**; 24-часовое сосуществование оставляет старый секрет действительным до истечения срока или отзыва.

1. В Request Signing выберите значок ротации для создания нового секрета.
2. Скопируйте и безопасно сохраните новое значение, затем подтвердите сохранение.
3. Выберите **время истечения старого секрета** и нажмите **Save Changes**:
   * **In 24 hours**: оба секрета работают в течение 24 часов после сохранения. Обновите все приложения до истечения старого секрета.
   * **Immediately**: новый секрет заменяет старый сразу после сохранения. Запросы со старой подписью отклоняются.

До сохранения текущий секрет не меняется. Отмена удаляет несохранённую замену.

Нельзя начать новую ротацию, пока идёт текущая. Дождитесь истечения старого секрета или используйте **Revoke Old Secret** для досрочного завершения перехода. Досрочный отзыв немедленно отклоняет запросы, подписанные старым секретом.

## Отключение Request Signing

Снимите флажок **Request Signing**, выберите **Save Changes** и подтвердите. Подпись немедленно отключается, все связанные API-секреты отзываются, а запланированное обязательное применение и текущая ротация прекращаются.

Обновите приложения, чтобы они не отправляли подписи с отозванными секретами. Для повторного включения создайте новый секрет.

Если IP Allowlist остаётся включённым, запросы по-прежнему должны идти с разрешённого IP. Без активных методов используется только аутентификация API-ключом. Ключи с обязательной защитой должны сохранять хотя бы один действующий метод.

## Сохранение или отмена изменений

Выбранные методы и список IP применяются только после успешного сохранения. **Cancel** отменяет несохранённые изменения. При ошибке сохранения проверьте текущую конфигурацию перед повтором; тайм-аут не обязательно означает, что запрос завершился неудачей.

Ошибки ответов API см. в разделе [Формат ответа](https://docs.metasleuth.io/ru/blocksec-aml-api/introduction/response-format.md).
