Добавляем токены для обращения к сервисам

Обновлено 23 января 2024

SaluteBot

Code

Graph

Чат-боты могут обращаться в различные сервисы для обмена данными. При этом для аутентификации запросов чат-боту необходимы токены.

Для повышения безопасности токены хранятся и используются в чат-ботах в зашифрованном виде. Токены хранятся в глобальных переменных, которые передаются в соответствующих блоках и сервисах. Например, в качестве параметров запросов сервиса http, если вы разрабатываете сценарий в Code.

Добавлять и изменять токены могут только администраторы проекта. Пользователи могут просматривать список токенов чат-бота и копировать переменные, в которых хранятся токены.

Вы можете использовать собственные токены для хранения сертификатов и ключей, которые используются при выполнении http-запросов (блок HTTP-запрос или сервис http).

Системные токены добавляются автоматически при подключении соответствующих сервисов.

Добавление собственных токенов

Используйте переменные с токенами в параметрах запросов и заголовках в блоке HTTP-запрос.

Чтобы добавить собственный токен:

1. Откройте проект и перейдите в раздел Токены:

   • Если вы разрабатываете сценарий в Graph выберите Настройки → Токены.
   • Если вы разрабатываете сценарий в Code выберите Настройки → Редактор → Токены.

2. Выберите вкладку Мои токены.

3. Нажмите кнопку Добавить.

4. В окне Добавить токен заполните следующие поля:

   • В поле Имя переменной укажите имя переменной, в которой будет храниться токен. Переменную можно использовать в любом месте сценария. Максимальная длина имени переменной — 40 символов. Имя может содержать только цифры от 0 до 9, латинские буквы верхнего и нижнего регистров (Aa-Zz), и нижнее подчеркивание _.

   Имя переменной должно быть уникальным.

   • В поле Значение укажите необходимый токен. Максимальная длина токена — 1024 символа.
   • В поле Описание можно указать дополнительную информацию о токене.

5. Нажмите кнопку Добавить.

Токен будет добавлен в список токенов чат-бота.

В собственных токенах можно сохранять app_key и app_secret необходимые для аутентификации запросов к проектам Platform V, созданным в других пространствах.

Изменить имя переменной и описание токена можно в окне Просмотр токена, которое открывается при выборе токена в списке. Значения добавленных токенов изменять нельзя.

Просмотр системных токенов

Чтобы просмотреть системные токены:

1. Откройте проект и перейдите в раздел Токены:

   • Если вы разрабатываете сценарий в Graph выберите Настройки → Токены.
   • Если вы разрабатываете сценарий в Code выберите Настройки → Редактор → Токены.

2. Выберите вкладку Системные токены.

Откроется список системных токенов, сгруппированных по типу сервиса. Системные токены нельзя удалить.