Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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.0
aggrega 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.