Для чего нужен перманентный API-токен?
Как создать перманентный API-токен?
Как удалить API-токен
Раздел API-токены
Уведомления об истечении срока действия API-токенов
Особенности работы API-токена и SSO
API-токен — это специальный код с определенным сроком действия, который позволяет вашему приложению получить доступ к аккаунту через API.
Для чего нужен перманентный API-токен?
В API-документации описано получение стандартного токена авторизации со сроком действия 1 час. Для его обновления используется запрос Refresh token, срок действия этого токена — 24 часа. Такие сроки действия хорошо подходят для разовых запросов.
Если вы хотите настроить автоматизированный процесс работы с нашим CDN-сервисом (например, автоматическая очистка кеша), используйте перманентный API-токен, создать который можно в личном кабинете.
Важно. Пожалуйста, обратитесь к API-документации продукта, чтобы проверить, поддерживает ли он перманентные API-токены.
Используйте заголовок APIKey перед сгенерированным токеном, например: Authorization: APIKey 7711$eyJ0eXAiOiJKV.
Как создать перманентный API-токен?
Для одного аккаунта может быть выпущено не более 50 перманентных токенов.
В личном кабинете перейдите в Профиль.
Откройте раздел API-токены.
Нажмите Создать токен.
Откроется форма создания API-токена.
В поле «Имя» укажите название создаваемого токена.
В поле «Описание» можно внести дополнительные сведения о токене. Это необязательное поле.
В разделе «Роль» укажите права, которые присваиваются создаваемому токену.
Важно! Пользователь может создать токен с ролью равной своей или ниже. Это значит, что пользователь с ролью «User» не может создать токен с ролью «Administrators».
В разделе Срок действия выберите срок действия токена:
«Бессрочный» - срок действия токена неограничен.
«Задать срок действия» - при выборе этого пункта обязательно задайте срок истечения срока действия токена в поле ниже.
После заполнения всех обязательных полей кнопка Создать станет активной. Нажмите ее для генерации API-токена.
Откроется окно с API-токеном.
Важно! Сгенерированный токен не хранится в системе. Просмотреть его в личном кабинете можно только один раз во время его создания. Скопируйте и сохраните токен.
После того как вы сохранили сгенерированный токен нажмите Ок, токен скопирован. Информация о токене будет отображена в разделе API-токены.
Как удалить API-токен
Только пользователи с ролью «Administrators» могут удалять любые токены, выпущенными для аккаунта. Пользователи с другими ролями могут удалять только те токены, которые были выпущены только этими пользователями.
В Личном кабинете перейдите в Профиль.
Откройте раздел API-токены.
Напротив необходимого API-токена нажмите на знак трех точек и выберите Удалить API-токен.
Раздел API-токены
В этом разделе отображаются все выпущенные API-токены, а также информация о том, кто выпустил токен, какая роль ему присвоена, когда токен был использован, срок его действия и статус.
Важно! Только пользователи с ролью «Administrators» могут видеть и управлять всеми токенами, выпущенными для аккаунта. Пользователи с другими ролями видят и могут управлять только теми токенами, которые были выпущены этими пользователями.
Для быстрого поиска токена можно воспользоваться фильтрацией по:
Пользователю, который выпустил токен - фильтр «Издатель».
Роли, присвоенной токену - фильтр «Роли».
Статусу токена: активный/истек/удален - фильтр «Статус».
Уведомления об истечении срока действия API-токенов
Уведомления об истечении срока действия API-токенов отображаются в личном кабинете и по умолчанию пересылаются на почту пользователям, которые выписали токен и пользователям с ролью «Administrators».
Настроить уведомления можно в разделе Уведомления вкладки Профиль.
Пользователи уведомляются по почте:
За 7 дней до истечения токена.
За 1 день до истечения токена.
Раздел API-токены будет отмечен восклицательным знаком, если в аккаунте есть токены, которые истекают через 7 или менее дней.
В разделе API-токены напротив токенов, нуждающихся во внимании, будут стоять специальные символы:
Если токен истекает через 7 или менее дней.
Если токен уже истёк.
Если токен удален.
Особенности работы API-токена и SSO
При авторизации через SAML SSO наша система не располагает информацией о статусе разрешений, выданных пользователю провайдером.
Даже если провайдер отозвал у пользователя права доступа, его токены останутся активными для доступа к управлению аккаунтом.
Важно! Если вам необходимо ограничить доступ по перманентному API-токену для пользователя с авторизацией через SSO, удалите соответствующий токен из Личного кабинета.