aggrega auth
aggrega auth raggruppa i comandi che riguardano l’identità di firma, il token di identità OIDC usato dalla firma keyless. È distinto da aggrega login, che memorizza le credenziali nome utente/password del registry: auth riguarda chi sei quando firmi, login riguarda come raggiungi un registry.
aggrega auth token
aggrega auth token esegue una volta il flusso OIDC interattivo e stampa su stdout il token di identità grezzo, così puoi acquisire un’identità una sola volta e riutilizzarla per un lotto di firme keyless senza un passaggio dal browser per ogni artefatto.
Sinossi
aggrega auth tokenCosa fa
aggrega auth token apre un browser per completare il login OIDC federato (la stessa acquisizione che usano aggrega sign e aggrega push quando non viene fornito alcun token), quindi scrive su stdout il token di identità risultante ed esce. Il token è il valore che la firma keyless presenta a Fulcio per l’emissione del certificato.
Su stdout viene scritto solo il token, seguito da un singolo carattere di nuova riga. Qualsiasi prompt o diagnostica va su stderr, così la sostituzione di comando cattura solo il token:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)Con il token esportato, ogni successivo aggrega sign keyless (o aggrega push --sign) lo riutilizza senza ulteriori interazioni con il browser:
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È la controparte per script della firma interattiva in lotto: aggrega sign <ref1> <ref2> ... acquisisce l’identità una volta nel processo per l’intero lotto, mentre aggrega auth token la esporta per usarla in invocazioni separate.
Sicurezza
Il token di identità ha vita breve e non viene salvato da questo comando: stamparlo su stdout è una tua scelta esplicita, per il tuo terminale e la tua esportazione. Esiste solo dove lo metti (di solito una variabile d’ambiente della shell per la durata della sessione). Se il token scade prima che un lotto lungo termini, esegui di nuovo aggrega auth token per ottenerne uno nuovo.
Vedi anche
- ./aggrega-sign.md — firma uno o più artefatti; la firma in lotto acquisisce l’identità una sola volta.
- ./aggrega-push.md — pubblica, con firma facoltativa al momento del push.
- environment-variables.md —
AGGREGA_IDENTITY_TOKENe gli altri input della firma.
Sinossi
aggrega authDescrizione
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.Sottocomandi
| Comando | Descrizione |
|---|---|
aggrega auth token | Acquisisce interattivamente un token di identità OIDC e lo stampa su stdout |
Descrizione di 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.