aggrega auth
aggrega auth agrupa comandos que lidam com a identidade de assinatura — o token de identidade OIDC usado pela assinatura keyless. É diferente de aggrega login, que armazena credenciais de nome de usuário/senha do registry: auth trata de quem você é quando assina, login trata de como você acessa um registry.
aggrega auth token
aggrega auth token executa uma vez o fluxo OIDC interativo e imprime o token de identidade bruto no stdout, para que você possa obter uma identidade uma única vez e reutilizá-la em um lote de assinaturas keyless sem uma ida ao navegador por artefato.
Sinopse
aggrega auth tokenO que ele faz
aggrega auth token abre um navegador para concluir o login OIDC federado (a mesma obtenção que aggrega sign e aggrega push usam quando nenhum token é fornecido), depois grava o token de identidade resultante no stdout e encerra. O token é o valor que a assinatura keyless apresenta ao Fulcio para a emissão do certificado.
Apenas o token — seguido de uma única quebra de linha — é gravado no stdout. Qualquer prompt ou diagnóstico vai para o stderr, de modo que a substituição de comando captura somente o token:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)Com o token exportado, cada aggrega sign keyless subsequente (ou aggrega push --sign) o reutiliza sem nenhuma outra interação com o navegador:
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.0Esta é a contrapartida para scripts da assinatura interativa em lote: aggrega sign <ref1> <ref2> ... obtém a identidade uma vez dentro do processo para o lote, enquanto aggrega auth token a exporta para uso em invocações separadas.
Segurança
O token de identidade tem vida curta e não é persistido por este comando — imprimi-lo no stdout é uma escolha explícita sua, para o seu terminal e a sua exportação. Ele existe apenas onde você o coloca (normalmente uma variável de ambiente do shell durante a sessão). Se o token expirar antes de um lote longo terminar, execute aggrega auth token novamente para gerar um novo.
Veja também
- ./aggrega-sign.md — assina um ou mais artefatos; a assinatura em lote obtém a identidade uma única vez.
- ./aggrega-push.md — publica, opcionalmente assinando no momento do push.
- environment-variables.md —
AGGREGA_IDENTITY_TOKENe as outras entradas da assinatura.
Sinopse
aggrega authDescrição
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.Subcomandos
| Comando | Descrição |
|---|---|
aggrega auth token | Obtém interativamente um token de identidade OIDC e o imprime no stdout |
Descrição de 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.