Токены доступа
Токены доступа — это механизм предоставления внешним системам и сервисам доступа к ресурсам проекта без необходимости передачи учётных данных пользователей платформы.
Токены используются для интеграции с CI/CD системами, автоматизации развёртывания, мониторинга и других сценариев, где требуется программный доступ к API проекта.
Токены привязываются к проекту и наследуют права доступа в соответствии с назначенной ролью.
Роли токенов
Каждому токену назначается одна из следующих ролей, определяющая уровень доступа к ресурсам проекта:
| Роль | Описание |
|---|---|
| editor | Полный доступ к ресурсам проекта: чтение, создание, изменение и удаление |
| viewer | Доступ только на чтение ко всем ресурсам проекта |
Выбирайте роль viewer для систем мониторинга и аналитики, которым не требуется изменять ресурсы проекта.
Сроки действия
При создании токена можно задать срок его действия:
| Срок действия | Описание |
|---|---|
| 30 дней | Краткосрочный токен для временных задач |
| 90 дней | Стандартный срок для большинства интеграций |
| 180 дней | Полугодовой токен |
| 360 дней | Годовой токен |
| Бессрочный | Токен без ограничения срока действия |
Бессрочные токены удобны, но менее безопасны. Рекомендуется использовать токены с ограниченным сроком действия и регулярно их обновлять.
Безопасность
При создании токена платформа показывает его значение только один раз. После закрытия модального окна получить значение токена повторно невозможно.
Следуйте рекомендациям по безопасному использованию токенов:
- Сохраняйте токены в надёжном месте — используйте менеджеры секретов (Vault, AWS Secrets Manager, GitLab CI Variables и аналоги)
- Не передавайте токены в открытом виде — избегайте отправки токенов по электронной почте, в мессенджерах или хранения в репозиториях
- Регулярно обновляйте токены — создавайте новые токены и удаляйте старые, особенно после завершения проектов
- Используйте минимально необходимые права — назначайте роль viewer, когда достаточно доступа только на чтение
- Немедленно удаляйте скомпрометированные токены — при подозрении утечки удалите токен и создайте новый
Управление токенами
Для управления токенами перейдите в раздел проекта Настройки / Токены. В этом разделе вы можете:
- Создать новый токен — добавить токен для интеграции с внешними системами
- Удалить существующий токен — отозвать доступ для токена
Для управления токенами необходима роль owner или admin в проекте.