> ## 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

> Создавайте, ротируйте и отзывайте учётные данные, которые используются для аутентификации запросов к Public API Living Security.

Ключи API аутентифицируют запросы к Public API `/v1`. Каждый ключ принадлежит
[сервисной учётной записи](/ru/developers/developer-hub/service-accounts) и
создаётся на странице сведений об этой учётной записи в
[Developer Hub](/ru/developers/developer-hub/overview).

Используйте ключ API с ограниченной областью действия для закрытой внутренней интеграции, если защищённое хранение и ротация секрета соответствуют вашим требованиям. Клиент OAuth и обмен токенами не требуются. Если ваша организация требует использовать краткосрочные токены доступа OAuth, см. раздел [Аутентификация](/ru/developers/v1/authentication).

## Структура ключа

* **Идентификатор** — начинается с `ak_`. Его безопасно указывать в заявках, журналах
  и конфигурации; сам по себе он не предоставляет никаких прав.
* **Секрет** — начинается с `lsk_live_`. Это учётные данные, которые предъявляет ваша
  интеграция. Он отображается **один раз** — при создании или ротации — и
  не может быть получен позже. В списке ключей отображаются только последние четыре
  символа (например, `lsk_live_…xQc4`), чтобы вы могли сопоставить строку с
  учётными данными, которыми располагает вызывающая сторона.
* **Разрешения** — подмножество разрешений владеющей сервисной учётной записи,
  выбираемое при создании. Ключ никогда не может делать больше, чем позволяет его учётная запись.
* **Срок действия** — обязательный параметр. У каждого ключа есть дата окончания срока действия.

<Warning>
  Сохраняйте секреты в менеджере секретов сразу после их отображения. Никогда не
  добавляйте их в систему управления версиями, не встраивайте в клиентский код и не передавайте
  в чатах. Любой, кто обладает секретом, может выполнять действия с разрешениями этого ключа.
</Warning>

## Создание ключа

На странице сведений о сервисной учётной записи создайте ключ, выполнив четыре шага:
задайте имя, выберите разрешения, необходимые именно этому ключу, выберите срок действия
— 30, 90 или 365 дней либо произвольный период до одного года — и проверьте настройки. По завершении
секрет отображается один раз.

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

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

При ротации выпускается новый секрет и начинается период перекрытия — 1 час,
24 часа или 7 дней, — в течение которого **старый секрет продолжает работать**. Это
позволяет внедрять новый секрет в ваши развёртывания в удобном для вас темпе:

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

  <Step title="Обновите ваши интеграции">
    Замените старый секрет везде, где он настроен. Статус ключа
    отображается как «в перекрытии» до окончания периода.
  </Step>

  <Step title="Проверьте до завершения периода">
    Используйте [журналы запросов](/ru/developers/developer-hub/request-logs), чтобы убедиться,
    что трафик перешёл на новый секрет. После окончания перекрытия старый секрет
    перестаёт проходить аутентификацию.
  </Step>
</Steps>

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

## Немедленный отзыв

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

Запросы с отозванным ключом возвращают `401` с кодом
[`credential_revoked`](/ru/developers/v1/errors/credential_revoked). Если
необходимо одновременно остановить все ключи, которыми располагает интеграция, отключите
её сервисную учётную запись.


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