> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Keys

> Створюйте, ротуйте та відкликайте облікові дані, які автентифікують запити до Living Security Public API.

API-ключі автентифікують запити до `/v1` Public API. Кожен ключ належить до
[service account](/uk/developers/developer-hub/service-accounts) і
створюється на сторінці відомостей цього облікового запису в
[Developer Hub](/uk/developers/developer-hub/overview).

Використовуйте API-ключ з обмеженими правами доступу для приватної серверної інтеграції, якщо безпечне зберігання
і ротація секрету відповідають вашим вимогам. Клієнт OAuth або обмін
токенами не потрібні. Якщо
ваша організація натомість вимагає короткострокових токенів доступу OAuth, див. розділ [Authentication](/uk/developers/v1/authentication).

## Будова ключа

* **Ідентифікатор** — починається з `ak_`. Його безпечно вказувати в тікетах, журналах
  і конфігурації; сам по собі він нічого не надає.
* **Секрет** — починається з `lsk_live_`. Це облікові дані, які
  передає ваша інтеграція. Він показується **один раз** — під час створення або ротації — і
  його неможливо отримати пізніше. У списку ключів відображаються лише останні чотири
  символи (наприклад, `lsk_live_…xQc4`), щоб ви могли зіставити рядок із
  обліковими даними, якими володіє викликач.
* **Дозволи** — підмножина дозволів службового облікового запису-власника,
  яку обирають під час створення. Ключ ніколи не може робити більше, ніж дозволяє його обліковий запис.
* **Термін дії** — обов’язковий. Кожен ключ має дату завершення терміну дії.

<Warning>
  Зберігайте секрети в менеджері секретів одразу після їх відображення. Ніколи не додавайте
  їх до системи контролю версій, не вбудовуйте в клієнтський код і не передавайте
  в чаті. Будь-хто, хто має секрет, може діяти з дозволами цього ключа.
</Warning>

## Створення ключа

На сторінці відомостей службового облікового запису створіть ключ, виконавши чотири кроки:
надайте йому назву, оберіть дозволи, потрібні саме цьому ключу, виберіть термін дії
— 30, 90 або 365 днів чи власний період до одного року — і перевірте налаштування. Секрет
відображається після завершення, один раз.

Обмежуйте кожен ключ мінімальним набором дозволів, потрібним його викликачу, навіть якщо
обліковий запис дозволяє більше. Якщо ключ буде скомпрометовано, його дозволи
визначають масштаб наслідків.

## Ротація без простою

Ротація видає новий секрет і запускає період перекриття — 1 годину,
24 години або 7 днів, — протягом якого **старий секрет продовжує працювати**. Це
дає змогу поступово впровадити новий секрет у ваші середовища у зручному для вас темпі:

<Steps>
  <Step title="Виконайте ротацію ключа">
    Оберіть період перекриття, який охоплює найповільніший шлях розгортання. Новий
    секрет відображається один раз — збережіть його одразу.
  </Step>

  <Step title="Оновіть свої інтеграції">
    Замініть старий секрет скрізь, де він налаштований. Статус ключа
    відображається як in-overlap до завершення періоду.
  </Step>

  <Step title="Перевірте до завершення періоду">
    Скористайтеся [request logs](/uk/developers/developer-hub/request-logs), щоб переконатися,
    що трафік перейшов на новий секрет. Коли перекриття завершиться, старий секрет
    перестане автентифікувати запити.
  </Step>
</Steps>

Виконуйте ротацію також завчасно до завершення терміну дії: ключі, термін дії яких наближається до завершення,
позначаються у списку ключів як такі, що спливають. Ключ із простроченим терміном дії перестає автентифікувати —
запити з ним повертають `401` з кодом
[`credential_expired`](/uk/developers/v1/errors/credential_expired).

## Негайне відкликання

Відкликання набирає чинності негайно й незворотне — періоду перекриття
немає, скасувати дію неможливо. Відкликайте ключ одразу, щойно підозрюєте, що його секрет
було розкрито; натомість виконуйте ротацію, коли замінюєте справні облікові дані.

Запити з відкликаним ключем повертають `401` з кодом
[`credential_revoked`](/uk/developers/v1/errors/credential_revoked). Якщо
потрібно одразу зупинити всі ключі, якими володіє інтеграція, натомість вимкніть її
службовий обліковий запис.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.