Глоссарий
Права API-ключа
Ещё называют: Области доступа API-ключа · Scopes · Разрешения API
Права API-ключа — это список действий, которые разрешены программе с этим ключом, чтобы интеграция получала только нужный доступ, а не все права аккаунта.
Принцип наименьших прав: ключ для отчётов не должен уметь удалять данные или отправлять сообщения. Если такой ключ утечёт, вреда будет меньше.
Ключам дают срок действия и показывают их один раз, чтобы секрет не хранился в интерфейсе.
Как это устроено в Risti
API-ключи создают только владельцы в Настройки › Разработчикам › API-ключи: Создать ключ → имя → Что он может → Срок действия («30 дней», «90 дней», «Год» или «Бессрочно»). Ключ вида rk_live_… показывается один раз.
Права выбирают из списка: Читать разговоры, Отправлять ответы, Писать внутренние заметки, Назначать разговоры, Читать журнал действий, Управлять знаниями (библиотека) и другие. Права ключа не шире роли того, кто его создал, и сужаются, если эта роль меняется. Подробнее — на странице для разработчиков.