KubernetesでWIFを使用する

セルフマネージドKubernetesクラスター（kubeadm、k3s、OpenShift、オンプレミスディストリビューション）は、プロジェクテッドサービスアカウントトークンを通じて、すべてのPodに対してOIDC JSON Web Token（JWT）に署名します。クラスターのAPIサーバーがOIDC発行者として機能し、各トークンのsubクレームはsystem:serviceaccount:<namespace>:<service-account>という形式になります。クラスターの発行者URLは、ディスカバリードキュメントを読み取ることで確認できます。

kubectl get --raw /.well-known/openid-configuration | jq -r .issuer



前提条件

• WIFの概念（サービスアカウント、フェデレーション発行者、フェデレーションルール）に精通していること。
• APIサーバーで--service-account-issuerフラグが設定されたKubernetesクラスター。ほとんどのディストリビューションではデフォルトで設定されており、kubeadmクラスターでは通常https://kubernetes.default.svc.cluster.localが使用されます。APIサーバー設定に直接アクセスできない場合は、プラットフォームチームに値を確認してください。
• Anthropicがトークン署名を検証できるように、以下のいずれかが必要です。
  • 発行者のJWKSエンドポイントがポート443のHTTPS経由でパブリックインターネットから到達可能であること、または
  • クラスター内部からJWKSを取得し、inlineモードで登録できること（Anthropicの設定で説明します）。
• Anthropic組織のClaude Consoleでサービスアカウント、フェデレーション発行者、フェデレーションルールを作成する権限。



Kubernetesの設定

フェデレーションルールが期待するオーディエンスと有効期間を指定して、サービスアカウントトークンをPodにプロジェクトします。serviceAccountTokenプロジェクションは、新しいJWTをマウントパスに書き込み、expirationSecondsが経過する前にローテーションします。

apiVersion: v1
kind: Pod
metadata:
  name: inference-worker
  namespace: inference
spec:
  serviceAccountName: inference-worker
  volumes:
    - name: anthropic-token
      projected:
        sources:
          - serviceAccountToken:
              audience: https://api.anthropic.com
              expirationSeconds: 3600
              path: token
  containers:
    - name: app
      image: your-registry/inference-worker:latest
      env:
        - name: ANTHROPIC_IDENTITY_TOKEN_FILE
          value: /var/run/secrets/anthropic.com/token
        - name: ANTHROPIC_FEDERATION_RULE_ID
          value: fdrl_...
        - name: ANTHROPIC_ORGANIZATION_ID
          value: 00000000-0000-0000-0000-000000000000
        - name: ANTHROPIC_SERVICE_ACCOUNT_ID
          value: svac_...
        - name: ANTHROPIC_WORKSPACE_ID  # required when the rule covers multiple workspaces
          value: wrkspc_...
      volumeMounts:
        - name: anthropic-token
          mountPath: /var/run/secrets/anthropic.com
          readOnly: true

このPodに対して発行されるトークンには、sub: "system:serviceaccount:inference:inference-worker"とaud: ["https://api.anthropic.com"]が含まれます。



Anthropicの設定

Claude ConsoleでSettings → Workload identityを開き、Connect workloadをクリックしてKubernetesタイルを選択します。ウィザードに従って、発行者の登録、サービスアカウントの作成、フェデレーションルールの作成を行います。

ウィザードがこれらのリソースを作成します。ウィザードに入力する場合でも、Admin API に送信する場合でも、以下の値を使用してください。

フェデレーション発行者： 多くのセルフマネージドクラスターでは、https://kubernetes.default.svc.cluster.localのようなパブリックインターネットから到達できない発行者URLが使用されています。お使いのクラスターがこれに該当する場合は、inline JWKSソースを選択し、クラスターのキーを貼り付けてください。キーはクラスター内部から取得します。

kubectl get --raw /openid/v1/jwks

次に、返されたkeys配列の内容（外側の{"keys": [...]}ラッパーは含めない）を使用して発行者を設定します。

{
  "name": "onprem-k8s",
  "issuer_url": "https://kubernetes.default.svc.cluster.local",
  "jwks": {
    "type": "inline",
    "keys": [{ "kty": "RSA", "kid": "...", "n": "...", "e": "AQAB" }]
  }
}

inlineモードでは、issuer_urlはJWTのissクレームとの比較にのみ使用され、Anthropicがそこにアクセスを試みることはありません。発行者がパブリックに到達可能な場合は、代わりに"jwks": {"type": "discovery"}を使用してください。

フェデレーションルール： サービスアカウントのsubクレームと、プロジェクテッドトークンに設定したオーディエンスをマッチさせます。

{
  "name": "onprem-inference",
  "issuer_id": "fdis_...",
  "match": {
    "subject_prefix": "system:serviceaccount:inference:inference-worker",
    "audience": "https://api.anthropic.com"
  },
  "target": {
    "type": "service_account",
    "service_account_id": "svac_..."
  },
  "workspace_id": "wrkspc_...",
  "oauth_scope": "workspace:developer",
  "token_lifetime_seconds": 600
}

ワークロードが許す限り具体的に指定してください。名前空間内のすべてのサービスアカウントを同じAnthropicサービスアカウントにマッピングする必要がある場合にのみ、subject_prefixをsystem:serviceaccount:inference:*（末尾の*によりプレフィックスマッチになります）に緩めてください。ルールのfdrl_... IDをPodのANTHROPIC_FEDERATION_RULE_ID環境変数に追加します。



トークンの取得と使用

Kubernetesの設定のPod仕様では、ANTHROPIC_IDENTITY_TOKEN_FILEをプロジェクテッドマウントパスに設定し、ANTHROPIC_FEDERATION_RULE_ID、ANTHROPIC_ORGANIZATION_ID、ANTHROPIC_SERVICE_ACCOUNT_ID、ANTHROPIC_WORKSPACE_IDも設定しています。これらが設定されていれば、SDKは交換のたびにディスクからトークンを読み取り、Anthropicアクセストークンを自動的に更新します。

import anthropic

# ANTHROPIC_IDENTITY_TOKEN_FILE、ANTHROPIC_FEDERATION_RULE_ID、
# ANTHROPIC_ORGANIZATION_ID、ANTHROPIC_SERVICE_ACCOUNT_ID、ANTHROPIC_WORKSPACE_ID を
# ポッドの環境から読み取ります。
client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(message.content[0].text)



セットアップの検証

交換が成功すると、sk-ant-oat01-で始まるaccess_tokenと、秒単位のexpires_in値が返されます。400 invalid_grantが返された場合は、失敗した交換のトラブルシューティングを参照してください。Kubernetes側で最も一般的な原因はJWKSキーの不一致です（inlineモードの場合は、kubectl get --raw /openid/v1/jwksで再取得し、発行者を更新してください）。



ルールのスコープ設定

ルールのmatchブロックは、ユースケースに適した最も狭いスコープに限定してください。

• 名前空間とサービスアカウント名を固定する： 末尾に*を付けず、完全なsystem:serviceaccount:<namespace>:<name>値を使用します。
• 常にオーディエンスを設定する： ルールでaudienceを必須とし、PodのserviceAccountTokenプロジェクションにも同じ値を設定して、デフォルトオーディエンストークンが拒否されるようにします。
• 名前空間ごとに個別のルールを使用する： 1つのルールを広げるのではなく、名前空間ごとに個別のルールとAnthropicサービスアカウントを作成します。
• inline JWKS発行者を1つのクラスターにスコープする： 複数のクラスターが同じ発行者URLを共有している場合は、各クラスターのJWKSを独自のフェデレーション発行者として登録し、ルールをその発行者のみにバインドします。



次のステップ

• Workload Identity Federation：概念、トークン交換フロー、SDK設定オプション。
• WIFリファレンス：環境変数、JWKSソースモード、ルールマッチモード。