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.