aggrega auth
aggrega auth は、署名 ID(キーレス署名で使用される OIDC ID トークン)を扱うコマンドをまとめたものです。これは、レジストリのユーザー名とパスワードの認証情報を保存する aggrega login とは別のものです。auth は署名するときに誰であるかに関わり、login はレジストリにどのように到達するかに関わります。
aggrega auth token
aggrega auth token は対話型の OIDC フローを一度実行し、生の ID トークンを stdout に出力します。これにより、ID を一度だけ取得し、アーティファクトごとにブラウザを往復することなく、一連のキーレス署名で再利用できます。
概要
aggrega auth token動作
aggrega auth token はブラウザを開いてフェデレーション OIDC ログインを完了し(トークンが指定されていない場合に aggrega sign と aggrega push が使用するのと同じ取得処理です)、得られた ID トークンを stdout に書き出して終了します。このトークンは、キーレス署名が証明書の発行のために Fulcio に提示する値です。
stdout に書き出されるのは、トークンとそれに続く 1 つの改行だけです。プロンプトや診断はすべて 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> ... は一括処理のためにプロセス内で ID を一度取得しますが、aggrega auth token は別々の呼び出しをまたいで使用できるように ID をエクスポートします。
セキュリティ
ID トークンは有効期間が短く、このコマンドによって永続化されません。stdout への出力は、自分の端末と自分のエクスポートのための明示的な選択です。トークンは置いた場所にのみ存在します(通常はセッションの間のシェル環境変数です)。長い一括処理が終わる前にトークンの有効期限が切れた場合は、aggrega auth token を再実行して新しいトークンを発行します。
関連項目
- ./aggrega-sign.md — 1 つ以上のアーティファクトに署名します。一括署名では ID を一度だけ取得します。
- ./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 ID トークンを対話的に取得し、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.