> 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/authentication.md).

# Аутентификация

Каждый API-запрос должен содержать API-ключ. Для защиты доступа можно настроить IP Allowlist, Request Signing или оба метода в Security Settings.

## Получение API-ключа

1. Войдите в [MetaSleuth](https://metasleuth.io).
2. Откройте [Settings → APIs → API Keys](https://metasleuth.io/system/settings/personal/apis).
3. Создайте или просмотрите API-ключ нужного сервиса.

Address Label API и Risk Score API используют отдельные API-ключи и API-секреты. Используйте учётные данные соответствующего сервиса.

Если вы получили индивидуальный API-сервис через отдел продаж, обратитесь к своему представителю за учётными данными и инструкциями по настройке.

## Использование API-ключа

Добавляйте заголовок `Api-Key` в каждый запрос. Храните ключ в тайне и используйте только в серверных приложениях. Не включайте его в систему контроля версий, сборки браузерных или мобильных приложений, URL или журналы. Используйте HTTPS с проверкой сертификатов.

Пример ниже читает ключ из переменной окружения. При работе с учётными данными избегайте трассировки оболочки (`set -x`) и подробных HTTP-журналов.

Следующий пример использует ваш ключ Risk Score API:

```sh
curl --request GET \
  --header "Api-Key: ${MS_API_KEY}" \
  'https://aml.blocksec.com/address-compliance/api/v3/chain-list'
```

Этот пример включает только аутентификацию по API-ключу. Если включён IP Allowlist, отправляйте запрос с разрешённого публичного исходящего IP. Если требуется Request Signing, добавьте заголовки из [Request Signing](/ru/blocksec-aml-api/introduction/request-signing.md).

## Дополнительные проверки безопасности

| Метод защиты    | Требования к запросу                                                                                                         |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| IP Allowlist    | Публичный IP источника должен совпадать с разрешённым IP-адресом или входить в разрешённый диапазон CIDR.                    |
| Request Signing | После введения обязательной подписи каждый запрос должен содержать действительную подпись, метку времени и уникальный nonce. |
| Оба метода      | Запрос должен пройти обе проверки.                                                                                           |

Рекомендуем включить хотя бы один метод защиты. Если на странице управления API указан срок настройки, завершите её вовремя, чтобы избежать перерыва в доступе. Одно лишь создание секрета не завершает настройку.

Порядок настройки см. в [API Security Settings](/ru/blocksec-aml-api/introduction/api-security-settings.md), инструкции по подписи — в [Request Signing](/ru/blocksec-aml-api/introduction/request-signing.md).
