aggrega auth
aggrega auth grupuje polecenia dotyczące tożsamości podpisującej — tokenu tożsamości OIDC używanego przy podpisywaniu bezkluczowym. Różni się od aggrega login, które przechowuje poświadczenia rejestru (nazwę użytkownika i hasło): auth dotyczy tego, kim się jest przy podpisywaniu, a login — tego, jak uzyskać dostęp do rejestru.
aggrega auth token
aggrega auth token jednorazowo uruchamia interaktywny przepływ OIDC i wypisuje surowy token tożsamości na stdout, dzięki czemu można uzyskać tożsamość jeden raz i używać jej ponownie w serii podpisów bezkluczowych bez przechodzenia przez przeglądarkę dla każdego artefaktu.
Składnia
aggrega auth tokenDziałanie
aggrega auth token otwiera przeglądarkę w celu dokończenia federacyjnego logowania OIDC (tego samego pozyskiwania, którego używają aggrega sign i aggrega push, gdy nie podano tokenu), a następnie zapisuje uzyskany token tożsamości na stdout i kończy działanie. Token jest wartością, którą podpisywanie bezkluczowe przedstawia usłudze Fulcio w celu wystawienia certyfikatu.
Na stdout zapisywany jest wyłącznie token, po którym następuje pojedynczy znak nowego wiersza. Wszelkie monity i komunikaty diagnostyczne trafiają na stderr, więc podstawienie polecenia przechwytuje sam token:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)Po wyeksportowaniu tokenu każde kolejne bezkluczowe aggrega sign (lub aggrega push --sign) używa go ponownie bez dalszej interakcji z przeglądarką:
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.0Jest to skryptowy odpowiednik interaktywnego podpisywania seryjnego: aggrega sign <ref1> <ref2> ... uzyskuje tożsamość raz, wewnątrz procesu, dla całej serii, natomiast aggrega auth token eksportuje ją do użycia w osobnych wywołaniach.
Bezpieczeństwo
Token tożsamości jest krótkotrwały i to polecenie go nie utrwala — wypisanie go na stdout jest świadomym wyborem użytkownika, na potrzeby jego terminala i eksportu. Token istnieje tylko tam, gdzie zostanie umieszczony (zwykle w zmiennej środowiskowej powłoki na czas sesji). Jeśli token wygaśnie przed zakończeniem długiej serii, należy ponownie uruchomić aggrega auth token, aby wygenerować nowy.
Zobacz także
- ./aggrega-sign.md — podpisywanie jednego lub wielu artefaktów; podpisywanie seryjne uzyskuje tożsamość raz.
- ./aggrega-push.md — publikowanie, opcjonalnie z podpisywaniem podczas wypychania.
- environment-variables.md —
AGGREGA_IDENTITY_TOKENi pozostałe dane wejściowe podpisywania.
Składnia
aggrega authOpis
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.Podpolecenia
| Polecenie | Opis |
|---|---|
aggrega auth token | Interaktywnie uzyskuje token tożsamości OIDC i wypisuje go na stdout |
Opis 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.