コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

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.0
aggrega 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 tokenOIDC 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.