Hub documentation
Служебные учётные записи
Служебные учётные записи
Эта функция входит в планы Enterprise и Enterprise Plus.
Служебные учётные записи — это идентификаторы, принадлежащие организации и предназначенные для программного доступа к её ресурсам, таким как конвейеры CI/CD, скрипты автоматизации и интеграции на стороне сервера. В отличие от личной учётной записи участника, служебная учётная запись не привязана к конкретному человеку: она принадлежит организации и управляется её администраторами.
Поскольку сервисный аккаунт не привязан к конкретному человеку, он позволяет автоматизированным процессам продолжать работу независимо от того, приходят ли новые сотрудники или уходят ли существующие, а также даёт возможность ограничивать и обновлять учётные данные, не затрагивая личные токены участников.
Создание учётной записи службы
В качестве администратора организации перейдите в раздел Service Accounts в настройках вашей организации, чтобы создавать и управлять служебными учетными записями.

При создании служебного аккаунта вы указываете:
- Имя name для идентификации учётной записи службы.
- Необязательное description для описания назначения учётной записи службы.
Служебные аккаунты не имеют пароля и не поддерживают интерактивный вход — доступ к ним осуществляется исключительно через токены доступа, которые вы для них выпускаете. В отличие от обычных пользователей, у них нет страницы профиля HF, они не входят в список участников организации и управляются только через настройки Service Accounts.
Служебные учётные записи не могут быть добавлены в группы ресурсов, в том числе через автоматическое присоединение. Чтобы ограничить доступ служебной учётной записи к определённым репозиториям, задайте область действия её токенов доступа (см. ниже).
Управление токенами доступа
Доступ учётной записи службы к вашей организации определяется исключительно выданными для неё токенами с детализированным доступом. Для каждого токена вы задаёте имя и набор детализированных разрешений, что позволяет предоставлять только тот доступ, который требуется для конкретного рабочего процесса.
Права могут быть предоставлены на двух уровнях:
- На уровне организации — применить разрешение (например, доступ на чтение или запись к содержимому репозитория) ко всем репозиториям в организации.
- Для каждого репозитория — ограничивает права на чтение или запись только определёнными репозиториями. Найдите и выберите репозитории, к которым должен применяться токен, затем укажите выдаваемые разрешения. Можно выбрать репозитории, принадлежащие организации, а также репозитории с ограниченным доступом вне организации, к которым учётная запись сервиса получила доступ.
Это позволяет выдавать токены с узким диапазоном прав — например, токен, который может только читать один репозиторий модели, — вместо предоставления доступа ко всей организации.
Токены также могут быть разрешены для работы с репозиториями с ограниченным доступом за пределами вашей организации, в разделе Репозитории с ограниченным доступом формы токена:
- Чтение содержимого репозиториев с ограниченным доступом, к которым есть доступ у служебной учётной записи — чтение репозиториев с ограниченным доступом после предоставления служебной учётной записи соответствующих прав.
- Запрос доступа к репозиториям с ограниченным доступом — позволяет токену отправлять запросы на доступ к репозиториям с ограниченным доступом от имени служебной учётной записи.
Чтобы предоставить токену доступ только к некоторым из этих репозиториев с ограниченным доступом, снимите отметку с пункта Чтение содержимого репозиториев с ограниченным доступом, к которым есть доступ у учетной записи службы и выберите нужные репозитории отдельно в разделе разрешений для каждого репозитория.

Со страницы учётной записи службы администраторы могут:
- Create новый токен доступа с выбранным именем и детализированными правами.
- Обновить имя или разрешения существующего токена.
- Rotate — операция замены токена на новое значение. Предыдущий токен перестаёт работать немедленно, что полезно, если учётные данные могли быть скомпрометированы.
- Удалите токен, чтобы навсегда отозвать его доступ.
Токены служебных учетных записей не требуют одобрения в соответствии с политикой токенов «Требуется одобрение администратора». Они получают доступ к ресурсам вашей организации сразу после создания.
Как и токены персонального доступа, токены служебных учетных записей истекают через год без использования. Администраторы организации получают письмо за 30 дней до этого, а на странице служебной учетной записи у токена появляется значок Expires. Чтобы сохранить токен, используйте его до этой даты. У токенов с истекшим сроком действия появляется значок Invalidated, и они перестают работать. Выполните ротацию, чтобы получить новое значение, которое затем нужно будет обновить во всех местах, где используется токен.
Токен доступа отображается только один раз — в момент его создания или ротации. Храните его в надёжном месте, так как впоследствии получить его невозможно. Если вы потеряли токен, выполните его ротацию, чтобы сгенерировать новое значение.
Генерация учётных данных S3
Токены служебных учетных записей можно использовать для доступа к Storage Buckets вашей организации через S3-compatible API. Шлюз выполняет аутентификацию с помощью ключей доступа в стиле AWS, полученных из токена служебной учетной записи.
Перейдите на страницу учётной записи службы. Если у вас ещё нет токена, создайте токен с помощью кнопки Create new token. Права доступа токена становятся правами доступа учётных данных S3.
Найдите токен в списке, откройте его выпадающее меню и выберите Generate S3 credentials.

Скопируйте сгенерированный access key ID (с префиксом
HFAK…) и secret access key в надёжное место — секрет отображается только один раз. Если вы его потеряете, используйте Invalidate and refresh S3 credentials для генерации новой пары. Предыдущий access key перестаёт работать немедленно.
Учётные данные S3 наследуют разрешения базового токена доступа. Ограничьте область действия токена только теми бакетами, которые вы планируете использовать.
Используйте Revoke S3 credentials, чтобы отключить пару, не удаляя токен — удаление токена (или учётной записи службы) также отзывает его учётные данные S3. На странице учётной записи службы отображается идентификатор ключа доступа, в настоящее время связанный с каждым токеном.
Используйте название вашей организации в качестве <namespace> в URL конечной точки (см. Настройка клиента). Генерация и отзыв учётных данных S3 фиксируются в Журнале аудита организации.
Если для токена включено исключение по сетевой безопасности, только администраторы организации могут генерировать для него S3-учётные данные.
Исключение для сетевой безопасности
Этот параметр входит в состав тарифного плана Enterprise Plus.
Если в вашей организации используются настройки Network Security, токены служебных учетных записей подчиняются им так же, как и любые другие учетные данные: они работают только из IP-диапазонов вашей организации, а политика доступа к содержимому (Content Access Policy) определяет, к каким ресурсам они могут обращаться.
Некоторые автоматизированные рабочие процессы выполняются за пределами вашей корпоративной сети — например, CI-задача, размещённая облачным провайдером. В таких случаях вы можете освободить отдельный токен от применения политик сетевой безопасности вашей организации с помощью опции Обход IP-ограничений и Политики доступа к контенту в форме токена.
При включении:
- Токен работает с любого IP-адреса, даже если включена опция Ограничить доступ к организации только вашими IP-диапазонами.
- Токен может получить доступ к контенту, который политика доступа к контенту вашей организации в противном случае заблокировала бы.
- Исключение действует только для настроек сетевой безопасности вашей организации. Оно никогда не обходит политику другой организации.
- Токен отображается на странице сервисного аккаунта с бейджем Без ограничений по IP.
- Поворот токена сохраняет исключение.
Только администраторы организации могут включить исключение или обновить токен, для которого уже действует исключение.
Поскольку exempt-токен больше не защищён периметром вашей сети, сам токен становится единственным учётным данными, защищающим ресурсы, к которым он имеет доступ. Мы рекомендуем ограничивать его область действия минимально возможным набором репозиториев, предоставлять права только на чтение, если этого достаточно, и регулярно его ротировать.
Тарифы
Служебные учетные записи не учитываются как платные участники вашей организации, поэтому их создание не занимает платное место в вашем тарифном плане.
Update on GitHub