aggrega auth
aggrega auth agrupa comandos que tratan con la identidad de firma: el token de identidad OIDC que usa la firma sin claves. Es distinto de aggrega login, que almacena credenciales de nombre de usuario/contraseña del registro: auth se refiere a quién eres cuando firmas, login se refiere a cómo llegas a un registro.
aggrega auth token
aggrega auth token ejecuta una vez el flujo OIDC interactivo e imprime el token de identidad sin procesar en stdout, para que puedas obtener una identidad una sola vez y reutilizarla en un lote de firmas sin claves sin pasar por el navegador para cada artefacto.
Sinopsis
aggrega auth tokenQué hace
aggrega auth token abre un navegador para completar el inicio de sesión OIDC federado (la misma obtención que usan aggrega sign y aggrega push cuando no se proporciona ningún token), luego escribe el token de identidad resultante en stdout y termina. El token es el valor que la firma sin claves presenta a Fulcio para la emisión del certificado.
Solo el token, seguido de un único salto de línea, se escribe en stdout. Cualquier solicitud o diagnóstico va a stderr, de modo que la sustitución de comandos captura únicamente el token:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)Con el token exportado, cada aggrega sign sin claves posterior (o aggrega push --sign) lo reutiliza sin más interacción con el 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.0Es la contrapartida para scripts de la firma interactiva por lotes: aggrega sign <ref1> <ref2> ... obtiene la identidad una vez dentro del proceso para todo el lote, mientras que aggrega auth token la exporta para usarla en invocaciones separadas.
Seguridad
El token de identidad es de corta duración y este comando no lo conserva: imprimirlo en stdout es tu elección explícita, para tu terminal y tu exportación. Solo existe donde lo pongas (normalmente una variable de entorno del shell durante la sesión). Si el token caduca antes de que termine un lote largo, vuelve a ejecutar aggrega auth token para obtener uno nuevo.
Véase también
- ./aggrega-sign.md — firma uno o más artefactos; la firma por lotes obtiene la identidad una sola vez.
- ./aggrega-push.md — publica, con firma opcional en el momento del push.
- environment-variables.md —
AGGREGA_IDENTITY_TOKENy las demás entradas de la firma.
Sinopsis
aggrega authDescripción
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 | Descripción |
|---|---|
aggrega auth token | Obtiene de forma interactiva un token de identidad OIDC y lo imprime en stdout |
Descripción 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.