Сервисный аккаунт — это нечеловеческий пользователь, который существует только для вызовов API Yahont.
Его создание даёт вам API-ключ, позволяющий создавать собственные приложения,
интегрироваться с внешними системами и автоматизировать рабочие процессы.
Сервисный аккаунт — отдельный пользователь в Yahont, поэтому можно отслеживать его активность,
держать его сессии чата приватными и ограничивать доступные ему ресурсы.
Как сервисный аккаунт получает доступ
У сервисного аккаунта нет собственных прав. Его доступ — это сочетание прав всех групп, в которые вы его назначили,
точно так же, как у человека.
Назначение нескольких групп суммирует их права.
Если ключ может писать в чат, но поиск ничего не возвращает, проверьте, входит ли его сервисный аккаунт в группу.
О том, как группы и права сочетаются,
читайте в разделе Как устроены права.
Кто может управлять сервисными аккаунтами
Для управления сервисными аккаунтами нужно право Управление сервисными аккаунтами,
которое администратор предоставляет группе. У администраторов оно есть всегда.
Предоставление права Управление сервисными аккаунтами равносильно предоставлению Admin.
Селектор групп намеренно не ограничен, поэтому любой, кто может создать сервисный аккаунт,
может поместить его в группу Admin и затем использовать его ключ.
Создание сервисного аккаунта
Откройте «Сервисные аккаунты»
В панели администратора откройте Сервисные аккаунты в разделе Интеграции.
Создайте аккаунт
Нажмите Новый сервисный аккаунт, задайте ему имя и выберите группы, в которые он должен входить.
Оба значения можно изменить позже.
Сохраните и скопируйте ключ
Скопируйте или скачайте ключ, прежде чем закрывать диалог. Yahont показывает его только один раз.
Не размещайте ключ API в клиентском коде: на страницах сайта и в браузерных приложениях.
Ключ с правом чата читает все диалоги своего сервисного аккаунта, поэтому любой, кто увидит ключ,
прочитает диалоги всех пользователей этого ключа. Используйте ключи только на сервере.
Управление сервисными аккаунтами
На странице «Сервисные аккаунты» перечислены все аккаунты с названием, замаскированным ключом и группами.
Для каждого аккаунта можно:
Перевыпуск или удаление ключа нарушит работу любого приложения, которое всё ещё использует старый ключ.
Персональные токены доступа
Сервисные аккаунты предназначены для приложений. Если нужен токен, действующий от имени человека,
используйте персональный токен доступа.
Любой пользователь с правом Создание токена доступа пользователя может создать его в Настройки > Аккаунты и
доступ.
Области действия токенов и их использование описаны в разделе Обзор и
аутентификация.