Субъекты-службы
TODO: Одно-два предложения о том, что такое субъект-служба (идентичность и разрешения для интеграции, не связанной с пользователем-человеком) и почему стоит использовать его вместо отдельного служебного токена.
Субъекты-службы и учетные данные
TODO: Объяснить различие с помощью небольшой таблицы. Субъект-служба — идентичность интеграции и ее возможности. Учетные данные — секрет, который она использует для входа (сейчас — служебный токен, в будущем — учетные данные клиента OAuth).
Субъекты-службы уровня аккаунта и уровня проекта
TODO: Добавить таблицу со сравнением: кто создает каждый тип, где он находится в настройках и какие разрешения может иметь. Отметить, что субъектам-службам уровня проекта нельзя дополнительно назначать разрешения уровня аккаунта.
Выбор метода аутентификации
TODO: Добавить краткую таблицу сравнения служебного токена, учетных данных клиента OAuth и PAT. Указать, когда использовать каждый вариант.
Создание субъекта-службы
TODO: Описать шаги для администраторов аккаунта в настройках аккаунта. Упомянуть ограничение области действия разрешений конкретными проектами или средами.
Добавление учетных данных
TODO: Описать шаги для выпуска служебного токена для субъекта-службы. Добавить примечание о необходимости сохранить его, поскольку он отображается только один раз. Добавить ссылку на учетные данные клиента OAuth, когда они станут доступны.
Изменение субъекта-службы
TODO: Описать, как изменить имя или разрешения. Добавить предупреждение о том, что новые разрешения применяются ко всем его учетным данным и что учетные данные при этом не отзываются.
Удаление субъекта-службы или отзыв учетных данных
TODO: Описать содержание подтверждения и указать, что при удалении субъекта-службы удаляются все его учетные данные. Добавить примечание о том, что при удалении проекта удаляются и его субъекты-службы уровня проекта.
Разрешения
TODO: Указать, кто может создавать, просматривать субъекты-службы и управлять ими на каждом уровне, а также какие наборы разрешений для этого нужны. Сверить с новыми разрешениями project_service_principal_*, когда они станут общедоступными.
Существующие служебные токены
TODO: Указать, нужно ли клиентам что-либо делать. В PRD указано, что существующие токены переносятся без изменения поведения. Подтвердить у менеджера продукта.
Журнал аудита
TODO: Перечислить события создания, изменения и удаления субъектов-служб и учетных данных. Добавить ссылку на страницу журнала аудита.
Часто задаваемые вопросы
TODO: Добавить после проверки. Возможные вопросы: что происходит, если создатель покидает организацию, и кто видит субъекты-службы уровня проекта.
