AI知識まとめノート
AnthropicがAPIキー不要の認証に対応。AWS・GCP・AzureなどのクラウドIDでClaude APIを利用できるWorkload Identity Federationが登場

AnthropicがAPIキー不要の認証に対応。AWS・GCP・AzureなどのクラウドIDでClaude APIを利用できるWorkload Identity Federationが登場

AnthropicがClaude Platform向けに「Workload Identity Federation(WIF)」を発表しました。

CLIからブラウザ認証で使えるようになったほか、ワークロードに既存のクラウドID(AWS・GCP・Azure、またはOIDCトークンプロバイダ)を使わせることでAPIキーなしでClaude APIを呼べるようになりました。


WIFってなに?

これまでClaude APIを使うには sk-ant-... 形式の静的なAPIキーが必要でした。このキーを安全に管理・ローテーションし、CI/CDや本番環境に漏らさないようにするのは地味に面倒な作業です。

WIFってなに?APIキーを置かずにClaude APIを使う方法。クラウドが本人確認→一時的な通行証をもらう→その通行証でClaudeを使う

WIFを使うと、AWS・GCP・AzureなどのIdP(Identity Provider)が発行した短命のOIDCトークン(JWT)を使って認証できます。固定のAPIキーは不要になり、トークンは短時間で失効するので安全性も大幅に向上します。


対応しているIDプロバイダ

対応IdP。AWS・GCP・Azure・GitHub Actions・Kubernetes・Okta・その他OIDC準拠プロバイダ

AWS・GCP・Azure・GitHub Actions・Kubernetes・Okta、そしてOIDC準拠であれば任意のプロバイダが使えます。主要なクラウド環境はほぼ網羅されています。


コード例(Python)

python
from anthropic import Anthropic, WorkloadIdentityCredentials, IdentityTokenFile

client = Anthropic(
    credentials=WorkloadIdentityCredentials(
        identity_token_provider=IdentityTokenFile(
            "/var/run/secrets/anthropic.com/token"
        ),
        federation_rule_id="fdrl_...",
        organization_id="00000000-0000-0000-0000-000000000000",
        service_account_id="svac_...",
    ),
)

Python例。IdentityTokenFile・federation_rule_id・organization_id・service_account_idを指定するだけ

Python・TypeScript・Go・Java・C#・PHP・Rubyと全SDK対応しています。環境変数(ANTHROPIC_FEDERATION_RULE_IDなど)を注入するだけで動くゼロ引数パターンも使えるので、コンテナイメージを環境ごとに変える必要もありません。


既存APIキーからの移行

既存APIキーからの移行。Before: 静的なAPIキー → After: フェデレーテッドID。4ステップで移行できる

移行はダウンタイムなしで行えます。フェデレーションをセットアップして ant auth status で動作確認、ANTHROPIC_API_KEY 環境変数を削除してフェデレーションが選ばれることを確認してから旧キーを削除するだけです。

注意点は ANTHROPIC_API_KEY の優先順位がフェデレーションより高いこと。環境変数が残っていると黙ってAPIキー認証が使われてしまうので要注意です。


セットアップ詳細・公式ドキュメント

次のステップ。セットアップ詳細は公式ドキュメントで確認できる

セットアップの流れ(5ステップ)。WIFを有効化→プールを作成→トークンマッピングを設定→サービスアカウントと権限を設定→WIFとサービスアカウントを連携

セットアップはClaude Consoleの「Settings → Workload identity」から行います。Service Account・Federation Issuer・Federation Ruleの3つを作るだけです。

関連記事