# Субъекты-службы

Платформа dbt | Enterprise, Enterprise+

TODO: Одно-два предложения о том, что такое субъект-служба (идентичность и разрешения для интеграции, не связанной с пользователем-человеком) и почему стоит использовать его вместо отдельного служебного токена.

## Субъекты-службы и учетные данные

TODO: Объяснить различие с помощью небольшой таблицы. Субъект-служба — идентичность интеграции и ее возможности. Учетные данные — секрет, который она использует для входа (сейчас — служебный токен, в будущем — учетные данные клиента OAuth).

## Субъекты-службы уровня аккаунта и уровня проекта

TODO: Добавить таблицу со сравнением: кто создает каждый тип, где он находится в настройках и какие разрешения может иметь. Отметить, что субъектам-службам уровня проекта нельзя дополнительно назначать разрешения уровня аккаунта.

## Выбор метода аутентификации

TODO: Добавить краткую таблицу сравнения служебного токена, учетных данных клиента OAuth и PAT. Указать, когда использовать каждый вариант.

## Создание субъекта-службы

TODO: Описать шаги для администраторов аккаунта в настройках аккаунта. Упомянуть ограничение области действия разрешений конкретными проектами или средами.

## Добавление учетных данных

TODO: Описать шаги для выпуска служебного токена для субъекта-службы. Добавить примечание о необходимости сохранить его, поскольку он отображается только один раз. Добавить ссылку на учетные данные клиента OAuth, когда они станут доступны.

## Изменение субъекта-службы

TODO: Описать, как изменить имя или разрешения. Добавить предупреждение о том, что новые разрешения применяются ко всем его учетным данным и что учетные данные при этом не отзываются.

## Удаление субъекта-службы или отзыв учетных данных

TODO: Описать содержание подтверждения и указать, что при удалении субъекта-службы удаляются все его учетные данные. Добавить примечание о том, что при удалении проекта удаляются и его субъекты-службы уровня проекта.

## Разрешения

TODO: Указать, кто может создавать, просматривать субъекты-службы и управлять ими на каждом уровне, а также какие наборы разрешений для этого нужны. Сверить с новыми разрешениями `project_service_principal_*`, когда они станут общедоступными.

## Существующие служебные токены

TODO: Указать, нужно ли клиентам что-либо делать. В PRD указано, что существующие токены переносятся без изменения поведения. Подтвердить у менеджера продукта.

## Журнал аудита

TODO: Перечислить события создания, изменения и удаления субъектов-служб и учетных данных. Добавить ссылку на страницу журнала аудита.

## Часто задаваемые вопросы

TODO: Добавить после проверки. Возможные вопросы: что происходит, если создатель покидает организацию, и кто видит субъекты-службы уровня проекта.