> For the complete documentation index, see [llms.txt](https://docs.newlandsgate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.newlandsgate.com/avtorizaciya/rukovodstvo-po-generacii-klyuchei.md).

# Руководство по генерации ключей

Перед началом работы с API необходимо создать и настроить ключи доступа в личном кабинете.

**API Key** — это уникальный публичный идентификатор для доступа к API, который используется для распознавания пользователя в системе.

**Secret API Key** — это закрытый ключ, который используется для аутентификации и подписи запросов к API через HMAC-SHA256.

#### Создание ключей API <a href="#id-1.-sozdanie-klyuchei-api" id="id-1.-sozdanie-klyuchei-api"></a>

1. Перейдите в **настройки личного кабинета**.
2. Нажмите кнопку **«Создать ключи доступа»**.

<figure><img src="https://2902284824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNCPgs2UDDjLMjH7FnJzC%2Fuploads%2FFp4LLCD6lN6XtsTr62lF%2Fimage%20(5).png?alt=media&amp;token=08f5edcc-d2e1-411a-a547-1d287f9eea5d" alt="" width="444"><figcaption></figcaption></figure>

<figure><img src="https://2902284824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNCPgs2UDDjLMjH7FnJzC%2Fuploads%2F92AjOXbWOcWVaVNHM1o0%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(21).png?alt=media&amp;token=d916d6b4-87aa-4efc-9a5b-5e72d127d14a" alt="" width="474"><figcaption></figcaption></figure>

**ВАЖНО: Безопасность ключей**

* **Скопируйте и сохраните** оба ключа сразу после создания. **Secret API Key** отображается только один раз.
* **Никогда не передавайте** свой `Secret API Key` третьим лицам и не публикуйте в публичных репозиториях.
* **Храните** `Secret API Key` в безопасном месте (например, в зашифрованном хранилище или менеджере секретов вашего сервера).
* При потере ключей их необходимо пересоздать в настройках.
* Одновременно может быть активна **только одна пара ключей**. Создание новых ключей сделает предыдущие недействительными.

<figure><img src="https://2902284824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNCPgs2UDDjLMjH7FnJzC%2Fuploads%2FpwNDLEuOznhU8VKfM32Y%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(9).png?alt=media&amp;token=015b8afb-1b8f-4fe5-bb2d-945050c20364" alt="" width="516"><figcaption></figcaption></figure>