本页面由机器翻译。阅读英文原文。
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 是你的明确选择,用于你的终端和你的导出。它只存在于你放置它的地方(通常是会话期间的 shell 环境变量)。如果令牌在一个较长的批处理完成前过期,请重新运行 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.