Workload Identity Federation

トークンは、AWS IAM、Google Cloud、GitHub Actions、Kubernetes、Microsoft Entra ID、Okta、SPIFFE など、すでに運用している ID プロバイダが発行します。Anthropic は Claude Console で設定した信頼ルールに照らしてトークンを検証し、組織内のサービスアカウントに結び付いた短期間有効なアクセストークンを返します。

ワークロードが連携を始める前に、Claude Console で次の 3 つのリソースを設定しておきます。Connect workload ウィザードを使うと、3 つを 1 つの流れで作成し、接続を端から端まで検証できます。

• サービスアカウント: Anthropic の組織内にある、人ではない名前付きの ID です。メールアドレス、パスワード、Console へのログインを持ちません。発行されたトークンは、対応するワークスペースのレート制限と利用量の帰属に従います。これは API キーと同じ扱いです。
• federation issuer (連携の発行元): OIDC の ID プロバイダを組織に登録するものです。発行元の URL と JWKS の取得元 (discovery、explicit_url、inline) を設定します。inline を使うと、プライベートな Kubernetes クラスタのように公開インターネットから到達できない発行元の鍵セットをアップロードできます。
• federation rule (連携ルール): 発行元とサービスアカウントを結び付け、JWT のクレームが条件に合うときに、指定したスコープのトークンを発行します。照合条件は組み合わせて使え、設定したすべての条件を満たす必要があります。発行されるトークンの OAuth スコープの既定値は workspace:developer で、ワークスペースの API キーと同じアクセス権を持ちます。

トークン交換のリクエストでは、クライアントがどのルールを使うかを指定します。ルールを暗黙に探す動作はありません。

発行される Anthropic のトークンの有効期間は、ルールの token_lifetime_seconds (既定値 3,600 秒) と、提示した ID プロバイダの JWT の残り有効期間の 2 倍のうち、短いほうです。60 秒を下回ることはありません。

SDK はすべてのリクエストにトークンを付けて送り、有効期限が切れる前に交換をやり直します。交換のたびに ANTHROPIC_IDENTITY_TOKEN_FILE を読み直すため、ローテーションされたトークンも自動で取り込みます。

既定では、jti クレームを持つ ID トークンは 1 回限りの使用です。同じ JWT をもう一度提示すると、jti_reused という理由で失敗します。

本番環境では、SDK のクライアントを引数無しで作成し、環境ごとに次の環境変数を注入します。同じコンテナイメージをすべての環境に配布できます。

• ANTHROPIC_FEDERATION_RULE_ID
• ANTHROPIC_ORGANIZATION_ID
• ANTHROPIC_SERVICE_ACCOUNT_ID
• ANTHROPIC_WORKSPACE_ID
• ANTHROPIC_IDENTITY_TOKEN_FILE

認証情報の優先順位では ANTHROPIC_API_KEY が連携より上にあります。環境に古いキーが残っていると、連携が警告無しに上書きされます。既存の API キーから移行するときは、次の順で進めます。

1. 既存の ANTHROPIC_API_KEY を残したまま連携を設定し、連携ルールがワークロードのトークンに合うことを確かめます。
2. ワークロードの中で ant auth status を実行し (または SDK のデバッグログを確認し)、どの認証情報が使われているかを確認します。
3. CI のシークレット、コンテナの環境変数、シェルのプロファイルから ANTHROPIC_API_KEY を外し、もう一度 ant auth status を実行して連携が使われていることを確認します。
4. ワークロードが連携のトークンで動き始めたら、Claude Console の API keys (API キー) のページでキーを削除します。

Workload Identity Federation は、それだけで完結するセキュリティ対策ではありません。連携による認証の強さは、JWT に署名する上流の ID プロバイダの強さに依存します。ID プロバイダ側の管理と、連携ルールの照合条件をあわせて確認する必要があります。

対象プランは、公式のリリースノートには記載がありません。

連携の設定は Claude Console で行います。

1. Claude Console で Workload identity (ワークロード ID) のページを開き、Connect workload (ワークロードを接続) を選びます。
2. 利用している ID プロバイダのタイル (GitHub Actions、AWS、Google Cloud、Microsoft Entra ID、Kubernetes) を選びます。それ以外の標準準拠のプロバイダでは Custom OIDC (カスタム OIDC) を選びます。
3. プロバイダごとの入力欄に、発行元の設定、受け取る JWT の照合条件、作成するサービスアカウントと連携ルールの名前を入力します。
4. 必要に応じて Verify issuer (発行元を検証) を選び、リソースを作成する前に発行元の設定を試験的に実行して、Anthropic が JWKS を取得・解析できることを確認します。
5. ウィザードが発行元、サービスアカウント、連携ルールを作成し、15 分間トークン交換の成功を待ち受けます。この時間内にワークロードからトークン交換を実行し、設定が動くことを確認します。