aggrega auth
aggrega auth объединяет команды, работающие с идентичностью для подписи — токеном идентификации OIDC, который используется при бесключевой подписи. Эта группа отличается от aggrega login, которая сохраняет учётные данные реестра (имя пользователя и пароль): auth отвечает за то, кто вы при подписи, а login — за то, как вы получаете доступ к реестру.
aggrega auth token
aggrega auth token один раз выполняет интерактивный процесс OIDC и выводит необработанный токен идентификации в stdout, чтобы вы могли получить идентичность однократно и повторно использовать её для пакета бесключевых подписей без обращения к браузеру для каждого артефакта.
Синтаксис
aggrega auth tokenЧто делает команда
aggrega auth token открывает браузер для завершения федеративного входа OIDC (то же получение, которое используют aggrega sign и aggrega push, когда токен не передан), затем записывает полученный токен идентификации в stdout и завершает работу. Этот токен — значение, которое бесключевая подпись предъявляет Fulcio для выпуска сертификата.
В stdout записывается только токен, за которым следует один символ новой строки. Все запросы и диагностические сообщения направляются в stderr, поэтому подстановка команды захватывает только токен:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)После экспорта токена каждая последующая бесключевая aggrega sign (или aggrega push --sign) повторно использует его без дополнительного взаимодействия с браузером:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)aggrega sign hub.example.com/component/core/api-server:1.0.0aggrega sign hub.example.com/component/core/worker:1.0.0Это скриптовый аналог интерактивной пакетной подписи: aggrega sign <ref1> <ref2> ... получает идентичность один раз внутри процесса для всего пакета, а aggrega auth token экспортирует её для использования в отдельных вызовах.
Безопасность
Токен идентификации действует недолго и не сохраняется этой командой — вывод его в stdout является вашим явным выбором, для вашего терминала и вашего экспорта. Он существует только там, куда вы его поместили (обычно в переменной окружения оболочки на время сеанса). Если токен истечёт до завершения длинного пакета, повторно выполните aggrega auth token, чтобы выпустить новый.
См. также
- ./aggrega-sign.md — подпись одного или нескольких артефактов; пакетная подпись получает идентичность один раз.
- ./aggrega-push.md — публикация с необязательной подписью во время отправки.
- environment-variables.md —
AGGREGA_IDENTITY_TOKENи другие входные данные для подписи.
Синтаксис
aggrega authОписание
Commands for the keyless signing identity (an OIDC identity token), distinct from `aggrega login`, which stores registry username/password credentials. The identity token is a short-lived secret used by keyless signing; it is never persisted by these commands.Подкоманды
| Команда | Описание |
|---|---|
aggrega auth token | Интерактивно получить токен идентификации OIDC и вывести его в stdout |
Описание aggrega auth token
Run the interactive OIDC flow once and print the raw identity token to stdout, so it can populate the environment for a batch of keyless signs:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)
Only the token is written to stdout; any prompt or diagnostic goes to stderr, so command substitution captures the token alone. The token is short-lived and is not persisted by this command — the caller decides whether to export it. This is distinct from `aggrega login`, which stores registry credentials.