--- title: Google Cloud で WIF を使用する url: https://platform.claude.com/docs/ja/manage-claude/wif-providers/gcp description: 静的なAPIキーの代わりに Google 署名付き ID トークンを使用して、Google Cloud ワークロード（Cloud Run、Cloud Functions、App Engine、GCE、GKE）を Claude API にフェデレーションします。 --- インスタンスメタデータサーバーにアクセスできる Google Cloud のコンピュート環境（Cloud Run、Cloud Functions、App Engine、Compute Engine（GCE）、および Workload Identity を有効にした GKE）であれば、アタッチされたサービスアカウント用の Google 署名付き ID トークンをリクエストできます。トークンの発行者（issuer）は `https://accounts.google.com` であり、Anthropic は標準の OIDC ディスカバリーを通じてこれを直接検証できるため、Google Cloud 側で追加の設定は必要ありません。 このガイドでは、Google の発行者を Anthropic に登録し、Google サービスアカウントを Anthropic サービスアカウントにバインドし、ワークロードが自身の ID トークンを有効期間の短い Claude API アクセストークンと交換する方法を説明します。 ## 前提条件 * [WIF の概念](https://platform.claude.com/docs/ja/manage-claude/workload-identity-federation#concepts)（サービスアカウント、フェデレーション発行者、フェデレーションルール）を理解していること。 * Cloud Run、Cloud Functions、App Engine、Compute Engine、または GKE 上でワークロードが稼働している Google Cloud プロジェクト。 * そのワークロードにアタッチされたユーザー管理の Google サービスアカウント（Compute Engine のデフォルトサービスアカウントではないもの）。 * Anthropic 組織の Claude Console でサービスアカウント、フェデレーション発行者、フェデレーションルールを作成する権限。 ## Google Cloud を設定する Google は、サービスアカウントがアタッチされたすべてのワークロードに対して ID トークンを自動的に発行します。Google 側では適切なサービスアカウントをアタッチする以外に有効化すべきものはありませんが、標準のコンピュート環境と GKE では手順が若干異なります。 専用のサービスアカウントをサービスまたはインスタンスにアタッチします。 ```bash CLI gcloud run deploy my-service \ --service-account inference-worker@my-project.iam.gserviceaccount.com ``` ワークロード内では、メタデータサーバーがオンデマンドで署名付き ID トークンを返します。Anthropic 側に登録する予定の `audience` を指定してリクエストし、レスポンスに `email` クレームが含まれるように `format=full` を付けてください。 ```text wrap GET http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full Metadata-Flavor: Google ``` または、gcloud CLI を使用する場合： ```bash CLI gcloud auth print-identity-token \ --audiences="https://api.anthropic.com" \ --include-email ``` SDK での同等の処理は[トークンを取得して使用する](https://platform.claude.com/docs/ja/manage-claude/wif-providers/gcp#acquire-and-use-the-token)に示しています。 デコードしたトークンのペイロードは次のようになります。 ```json { "iss": "https://accounts.google.com", "aud": "https://api.anthropic.com", "sub": "104892...", "azp": "104892...", "email": "inference-worker@my-project.iam.gserviceaccount.com", "email_verified": true, "exp": 1775527120 } ``` `sub` クレームは Google サービスアカウントの不透明な数値の一意 ID です。`email` クレームは人間が読めるサービスアカウントのアドレスです。フェデレーションルールでは `sub` と `email` の両方でマッチさせてください。 クラスターで [Workload Identity](https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity) を有効にし、`iam.gke.io/gcp-service-account` アノテーションを使用して Kubernetes サービスアカウントを Google サービスアカウントにバインドします。 ```yaml apiVersion: v1 kind: ServiceAccount metadata: name: inference-worker namespace: prod annotations: iam.gke.io/gcp-service-account: inference-worker@my-project.iam.gserviceaccount.com ``` このバインドが設定されると、GKE メタデータサーバーは Cloud Run や GCE の場合と同一の Google 署名付きトークンを返します。発行者は同じ `https://accounts.google.com`、`email` クレームも同じ、取得 URL も同じです。次のセクションとまったく同じように Anthropic を設定してください。 GKE からの `format=full` トークンには、さらに `google.compute_engine.project_id`、`google.compute_engine.zone`、`google.compute_engine.instance_name` クレームが含まれます。これらはフェデレーションルールの `condition` マッチャー（`claims.google.compute_engine.project_id == "my-project"` のような CEL 式）で参照でき、特定のクラスターやノードプールにアクセスを限定できます。 Kubernetes サービスアカウントを Google サービスアカウントにバインドしたくない場合、GKE の Pod は代わりにクラスター独自の OIDC 発行者（`https://container.googleapis.com/v1/projects/PROJECT/locations/REGION/clusters/CLUSTER`）と projected `serviceAccountToken` ボリュームを使用できます。この方法では `accounts.google.com` ではなくクラスターごとの発行者を使用します。このパターンについては [Kubernetes で WIF を使用する](https://platform.claude.com/docs/ja/manage-claude/wif-providers/kubernetes)を参照してください。 ## Anthropic を設定する Claude Console で [Workload identity](https://platform.claude.com/settings/workload-identity-federation) ページ（`platform.claude.com/settings/workload-identity-federation`）に移動し、**Connect workload** をクリックして **Google Cloud** タイルを選択します。ウィザードに従って、発行者の登録、サービスアカウントの作成、フェデレーションルールの作成を行います。 ウィザードがこれらのリソースを作成します。ウィザードに入力する場合でも、[Admin API](https://platform.claude.com/docs/ja/manage-claude/wif-admin-api)に送信する場合でも、以下の値を使用してください。 **フェデレーション発行者：** Google は OIDC ディスカバリードキュメントを公開しているため、ディスカバリーモードを使用します。この単一の発行者で、すべての Google Cloud サーフェス（Cloud Run、GCE、Cloud Functions、App Engine、および Workload Identity を有効にした GKE）をカバーできます。ワークロードの区別は発行者ではなくルールで行ってください。 ```json { "name": "gcp", "issuer_url": "https://accounts.google.com", "jwks": { "type": "discovery" } } ``` **フェデレーションルール：** `sub` クレームと `email` クレームの両方でマッチさせます。`email` は読みやすいサービスアカウントのアドレスです。`sub` はサービスアカウントの数値の一意 ID で、Google はこれを再利用しないため、固定しておくことで、サービスアカウントが削除され、後に同じメールアドレスで新しいものが作成された場合でもルールを保護できます。一意 ID は `gcloud iam service-accounts describe SA_EMAIL --format='value(uniqueId)'` で確認できます。 ```json { "name": "gcp-inference-worker", "issuer_id": "fdis_...", "match": { "audience": "https://api.anthropic.com", "claims": { "sub": "104892101234567890123", "email": "inference-worker@my-project.iam.gserviceaccount.com" } }, "target": { "type": "service_account", "service_account_id": "svac_..." }, "workspace_id": "wrkspc_...", "oauth_scope": "workspace:developer", "token_lifetime_seconds": 600 } ``` ## トークンを取得して使用する Google Cloudワークロード内で、メタデータサーバーからIDトークンを取得し、`POST /v1/oauth/token`で交換して、返されたベアラートークンを使用してClaude APIを呼び出します。次の例に示すように、`identity_token_provider` (typescript: `identityTokenProvider`; php: `identityProvider`; csharp: `IdentityTokenProvider`; go: `option.WithFederationTokenProvider`; java: `IdentityTokenConfig`)を指定すると、Claude SDKが交換と更新のループを処理します。Java（その例のコメントを参照）を除き、このオプションはメタデータサーバーから新しいIDトークンを返すトークンプロバイダーを受け取ります。 ```bash cURL # メタデータサーバーから Google 署名付きの ID トークンを取得します JWT=$(curl -sS -H "Metadata-Flavor: Google" \ "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full") # それを Anthropic のアクセストークンと交換します RESPONSE=$(curl -sS https://api.anthropic.com/v1/oauth/token \ -H "content-type: application/json" \ --data @- < str: request = google.auth.transport.requests.Request() return google.oauth2.id_token.fetch_id_token(request, AUDIENCE) client = anthropic.Anthropic( credentials=WorkloadIdentityCredentials( identity_token_provider=fetch_google_identity_token, federation_rule_id=os.environ["ANTHROPIC_FEDERATION_RULE_ID"], organization_id=os.environ["ANTHROPIC_ORGANIZATION_ID"], service_account_id=os.environ["ANTHROPIC_SERVICE_ACCOUNT_ID"], workspace_id=os.environ.get("ANTHROPIC_WORKSPACE_ID"), ), ) message = client.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello from Cloud Run"}], ) print(next(block.text for block in message.content if block.type == "text")) ``` ```typescript TypeScript import Anthropic from "@anthropic-ai/sdk"; import { oidcFederationProvider } from "@anthropic-ai/sdk/lib/credentials/oidc-federation"; const METADATA_URL = "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full"; async function fetchGoogleIdentityToken(): Promise { const response = await fetch(METADATA_URL, { headers: { "Metadata-Flavor": "Google" } }); return response.text(); } const client = new Anthropic({ credentials: oidcFederationProvider({ identityTokenProvider: fetchGoogleIdentityToken, federationRuleId: process.env.ANTHROPIC_FEDERATION_RULE_ID!, organizationId: process.env.ANTHROPIC_ORGANIZATION_ID!, serviceAccountId: process.env.ANTHROPIC_SERVICE_ACCOUNT_ID, workspaceId: process.env.ANTHROPIC_WORKSPACE_ID, baseURL: "https://api.anthropic.com", fetch }) }); const message = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello from Cloud Run" }] }); for (const block of message.content) { if (block.type === "text") { console.log(block.text); } } ``` ```go Go const audience = "https://api.anthropic.com" googleIDToken := func(ctx context.Context) (string, error) { creds, err := idtoken.NewCredentials(&idtoken.Options{Audience: audience}) if err != nil { return "", err } tok, err := creds.Token(ctx) if err != nil { return "", err } return tok.Value, nil } client := anthropic.NewClient( option.WithFederationTokenProvider(googleIDToken, option.FederationOptions{ FederationRuleID: os.Getenv("ANTHROPIC_FEDERATION_RULE_ID"), OrganizationID: os.Getenv("ANTHROPIC_ORGANIZATION_ID"), ServiceAccountID: os.Getenv("ANTHROPIC_SERVICE_ACCOUNT_ID"), WorkspaceID: os.Getenv("ANTHROPIC_WORKSPACE_ID"), }), ) message, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Hello from Cloud Run")), }, }) if err != nil { panic(err) } for _, block := range message.Content { if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok { fmt.Println(textBlock.Text) break } } ``` ```java Java import com.anthropic.config.AuthenticationConfig; import com.anthropic.config.AuthenticationType; import com.anthropic.config.IdentityTokenConfig; import com.anthropic.config.InMemoryProfileConfigProvider; import com.anthropic.config.ProfileConfig; // ... import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; void main() throws Exception { HttpClient http = HttpClient.newHttpClient(); HttpRequest metadataRequest = HttpRequest.newBuilder() .uri(URI.create("http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full")) .header("Metadata-Flavor", "Google") .build(); // Java SDK は関数ではなく、トークン自体またはファイルパスを受け取ります。 // source("value") の場合、path(...) がトークンを保持します。SDK は同じトークンを // Anthropic アクセストークンの更新のたびに送信するため、トークンが期限切れになるか、 // jti クレームがある場合は使用済みになると失敗します。長時間実行される // プロセスでは、source("file") を渡し、各更新の前に新しいトークンを // ファイルに書き込んでください。 String googleIdentityToken = http.send(metadataRequest, HttpResponse.BodyHandlers.ofString()).body(); AnthropicClient client = AnthropicOkHttpClient.builder() .configurationProvider(InMemoryProfileConfigProvider.of(ProfileConfig.builder() .organizationId(System.getenv("ANTHROPIC_ORGANIZATION_ID")) .workspaceId(System.getenv("ANTHROPIC_WORKSPACE_ID")) .authentication(AuthenticationConfig.builder() .type(AuthenticationType.OIDC_FEDERATION) .federationRuleId(System.getenv("ANTHROPIC_FEDERATION_RULE_ID")) .serviceAccountId(System.getenv("ANTHROPIC_SERVICE_ACCOUNT_ID")) .identityToken(IdentityTokenConfig.builder() .source("value") .path(googleIdentityToken) .build()) .build()) .build())) .build(); var message = client.messages().create(MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024) .addUserMessage("Hello from Cloud Run") .build()); IO.println(message.content()); } ``` ```csharp C# using Anthropic.Credentials; // ... var credentials = new WorkloadIdentityCredentials(new WorkloadIdentityOptions { FederationRuleId = Environment.GetEnvironmentVariable("ANTHROPIC_FEDERATION_RULE_ID")!, OrganizationId = Environment.GetEnvironmentVariable("ANTHROPIC_ORGANIZATION_ID"), ServiceAccountId = Environment.GetEnvironmentVariable("ANTHROPIC_SERVICE_ACCOUNT_ID"), WorkspaceId = Environment.GetEnvironmentVariable("ANTHROPIC_WORKSPACE_ID"), IdentityTokenProvider = new MetadataTokenProvider(), }); using var client = new AnthropicClient(new ClientOptions { Credentials = credentials }); var message = await client.Messages.Create(new() { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello from Cloud Run" }], }); foreach (var block in message.Content) { if (block.Value is TextBlock textBlock) { Console.WriteLine(textBlock.Text); } } class MetadataTokenProvider : IIdentityTokenProvider { private const string METADATA_URL = "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full"; private static readonly HttpClient httpClient = new() { DefaultRequestHeaders = { { "Metadata-Flavor", "Google" } }, }; public async Task GetIdentityTokenAsync(CancellationToken ct = default) { return await httpClient.GetStringAsync(METADATA_URL, ct); } } ``` ```bash CLI # Google が署名した ID トークンを、CLI が読み取れるファイルに書き込みます ANTHROPIC_IDENTITY_TOKEN_FILE=$(mktemp) curl -sS -H "Metadata-Flavor: Google" \ "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full" \ > "$ANTHROPIC_IDENTITY_TOKEN_FILE" export ANTHROPIC_IDENTITY_TOKEN_FILE # ANTHROPIC_FEDERATION_RULE_ID、ANTHROPIC_ORGANIZATION_ID、 # ANTHROPIC_SERVICE_ACCOUNT_ID、ANTHROPIC_WORKSPACE_ID は環境変数から読み取られます。 ant messages create \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello from Cloud Run"}' ``` ```php PHP use Anthropic\Client; use Anthropic\Lib\Credentials\CredentialResult; use Anthropic\Lib\Credentials\IdentityTokenProvider; use Anthropic\Lib\Credentials\TokenCache; use Anthropic\Lib\Credentials\WorkloadIdentityCredentials; const METADATA_URL = 'http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full'; class GoogleIdentityToken implements IdentityTokenProvider { public function getIdentityToken(): string { $context = stream_context_create([ 'http' => ['header' => "Metadata-Flavor: Google\r\n"], ]); return file_get_contents(METADATA_URL, false, $context); } } $credentials = new CredentialResult( provider: new TokenCache(new WorkloadIdentityCredentials( identityProvider: new GoogleIdentityToken(), federationRuleId: getenv('ANTHROPIC_FEDERATION_RULE_ID'), organizationId: getenv('ANTHROPIC_ORGANIZATION_ID'), serviceAccountId: getenv('ANTHROPIC_SERVICE_ACCOUNT_ID'), workspaceId: getenv('ANTHROPIC_WORKSPACE_ID') ?: null, )), ); $client = new Client(credentials: $credentials); $message = $client->messages->create( model: 'claude-opus-5-5', maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello from Cloud Run']], ); $textBlock = array_find($message->content, static fn ($block): bool => $block->type === 'text'); echo $textBlock->text, PHP_EOL; ``` ```ruby Ruby require "anthropic" require "net/http" METADATA_URL = "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full" credentials = Anthropic::WorkloadIdentityCredentials.new( identity_token_provider: -> { Net::HTTP.get(URI(METADATA_URL), {"Metadata-Flavor" => "Google"}) }, federation_rule_id: ENV.fetch("ANTHROPIC_FEDERATION_RULE_ID"), organization_id: ENV.fetch("ANTHROPIC_ORGANIZATION_ID"), service_account_id: ENV.fetch("ANTHROPIC_SERVICE_ACCOUNT_ID"), workspace_id: ENV["ANTHROPIC_WORKSPACE_ID"] ) client = Anthropic::Client.new(credentials: credentials) message = client.messages.create( model: "claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello from Cloud Run"}] ) puts message.content.find { it.type == :text }.text ``` GoogleのIDトークンは約1時間で期限切れになります。Java（その例のコメントを参照）を除き、SDKは期限切れになる前に、トークンプロバイダーを再度呼び出して自動的に再交換します。アクセストークンの`expires_in`より長く実行されるシェルスクリプトの場合は、タイマーで更新して交換を繰り返してください。 ## セットアップを検証する ワークロード内から ID トークンをデコードし、クレームがルールと一致していることを確認します。 ```bash cURL curl -sS -H "Metadata-Flavor: Google" \ "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=https://api.anthropic.com&format=full" \ | jq -rR 'split(".")[1] | gsub("-";"+") | gsub("_";"/") | @base64d | fromjson' ``` `iss` が `https://accounts.google.com`、`aud` が `https://api.anthropic.com` であり、`email` がフェデレーションルールの値と一致していることを確認します。次に、前のセクションの交換を実行します。交換が成功すると、`sk-ant-oat01-` で始まる `access_token` と、秒単位の `expires_in` 値が返されます。交換が不透明な `401` `authentication_error` レスポンス（メッセージ `Authentication failed`）で失敗した場合は、Claude Console の[認証履歴ページ](https://platform.claude.com/settings/workload-identity-federation?tab=history)で拒否理由を確認し、[失敗した交換のトラブルシューティング](https://platform.claude.com/docs/ja/manage-claude/wif-reference#troubleshoot-a-failed-exchange)を参照してください。Google Cloud 側で最も一般的な原因は `email` クレームの欠落です（`email` クレームが含まれるように、`format=full` を指定してトークンをリクエストしてください）。 ## ルールのスコープを絞る Google の `sub` クレームはサービスアカウントの不透明な数値の一意 ID であり、 安定したプレフィックスがありません。末尾に `*` を付けた `subject_prefix` は、 すべての Google Cloud プロジェクトにわたる任意のサービスアカウントにマッチし、 そのいずれもがフェデレーションされた Anthropic トークンを取得できてしまいます。 ルールの `match` ブロックは、ユースケースに適合する最も狭いスコープに固定してください。 * **`sub` を完全一致させる：** `claims.sub` に完全な数値の一意 ID を設定し、Google トークンには `subject_prefix` を決して使用しないでください。 * **`email` クレームを固定する：** `sub` に加えて `claims.email` を追加し、安定した ID と読みやすいアドレスの両方が一致する必要があるようにします。 * **audience を固定する：** `audience` をメタデータサーバーにリクエストする値と正確に一致させ、他の利用者向けに発行されたトークンが拒否されるようにします。 * **GKE ではプロジェクトを固定する：** `format=full` トークンの場合、`claims.google.compute_engine.project_id == "my-project"` のような `condition` を追加して、ルールを 1 つのプロジェクトのノードに限定します。 ## 次のステップ * 完全なリソースモデルと SDK の認証情報の優先順位については、[Workload Identity Federation](https://platform.claude.com/docs/ja/manage-claude/workload-identity-federation) ページを参照してください。 * 環境（本番、ステージング）ごとに個別のフェデレーションルールを追加し、他に影響を与えずに 1 つを取り消せるようにしてください。