Перейти к основному содержимому Перейти к дополнительному содержимому

Управление ключами API

Ключ API является уникальным идентификатором, позволяющим однозначным образом определить пользователя, разработчика или вызывающую программу в API. Посредством ключей API часто отслеживается и контролируется использование интерфейса для того, чтоб исключить нарушение API.

Обзор страницы «Ключи API»

По умолчанию ключи API отключены в Консоль управления. Ключи API активируются в разделе Параметры. Администратор клиента может отозвать ключи API, однако изменить настройки ключей API и генерировать или удалять ключи API разрешается только пользователям с ролью разработчика. Администратор клиента может назначить роль разработчика какому-либо из пользователей. Администратор клиента может назначить роль разработчика самому себе.

В таблице ключей API выводятся следующие данные о ключах API: имя, идентификатор, владелец, последнее обновление, дата создания, дата окончания срока действия и состояние. Поле поиска используется для данных по первым трем полям: Имя ключа, Идентификатор ключа и Владелец.

Состояния API ключей

Ключи API-ключи могут иметь следующие состояния:

  • Активный: ключ API используется.
  • Устарел: срок действия ключа истек.
  • Отозванный: ключ API был отозван, и его больше нельзя использовать.

Пользователи с правами администратора могут отслеживать действия с ключами API, которые были зарегистрированы в разделе События в Консоль управления. При обнаружении подозрительных действий, таких как активное использование конкретного ключа API, администратор можете отозвать ключ API. Откройте подробный список, нажав стрелку в правой части таблицы, и скопируйте идентификатор ключа API. Затем найдите ключ API, который нужно отозвать, указав его идентификатор в разделе API ключи.

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

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

Активирование ключей API в клиенте

Параметр Включить ключи API можно включить на странице Параметры в Консоль управления. По умолчанию ключи API отключены в Консоль управления.

Свойства для ключей API
Свойство Описание
Включить ключи API

Этот переключатель включает или отключает все ключи API в клиенте. Включить ключи API может только администратор клиента.

Изменить максимальный срок действия токена

При изменении значения срока действия токена все новые токены будут иметь новое значение срока действия. Уже существующие API не будут затронуты этим изменением, они будут иметь то же значение срока действия, что и раньше.

Максимальный предел для значения не установлен.

Изменить максимальное количество ключей API на пользователя

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

Максимальный предел значения ― 1000.

Выполните следующие действия.

  1. В Консоль управления перейдите на страницу Параметры.
  2. В разделе Ключи API переместите кнопку-переключатель Активировать ключи API (Enable API keys) во включенное положение.
  3. Если применимо, измените настройки Изменить максимальный срок действия токена и Изменить максимальное число ключей на одного пользователя.

Создание ключа API из хаба

Ключи API можно генерировать из хаба. Прежде чем начать, следует убедиться, что выполнены следующие три условия:

  • Используется лицензия. Лицензия необходима для создания ключа API.

  • Параметр Включить API ключи включен в Консоль управления.
  • Администратор клиента назначил вам роль разработчика.

Выполните следующие действия.

  1. Войдите в свой клиент, например https://<tenantname>.com.

  2. Щелкните свой профиль в правом верхнем углу и выберите Параметры профиля.

  3. Выберите Ключи API.

  4. Щелкните Создать новый ключ.

  5. Добавьте описание ключа API и выберите срок действия ключа API.

  6. Щелкните Создать.

    Будет создан ключ API.

  7. Скопируйте ключ API и сохраните в безопасном месте.

После создания можно изменить имя ключа API. Кроме того, можно удалить ключ.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!