gateway upstreamsへのassume_role追加
CHANGELOG 原文(英語)
Added assume_role on mantle upstreams of the Claude apps gateway, for a role in another AWS account and for per-developer AWS cost attribution 公式の変更履歴を開く ↗ 日本語での補足
Claude appsゲートウェイのmantle upstreamsにassume_roleを追加。別のAWSアカウントのロールや開発者単位のAWSコスト帰属に対応。
ドキュメント
ドキュメントの抜粋(参考訳)
開発者ごとの AWS コスト配分
既定では、ゲートウェイはすべての Bedrock リクエストを 1 つの認証情報で署名するため、AWS からはすべての開発者のリクエストが単一の IAM プリンシパルとして見えます。assume_role に session_name: email を追加すると、ゲートウェイは開発者ごとに 1 時間に 1 回 sts:AssumeRole を呼び出し、セッション名をその開発者のメールアドレスに設定して、返された認証情報でリクエストに署名します。これにより、各開発者のリクエストは、それぞれ自身が引き受けたロールのセッションとして AWS に届きます。このロールは、ゲートウェイ自身のアカウントにあってもかまいません。
Claude Code v2.1.281 以降で動作するゲートウェイが必要です。IAM ロールと、AWS の請求でこのセッションがどこに表示されるかについては、Cost attribution on AWS を参照してください。
[!NOTE]
開発者ごとの配分を行うには、
aws_bearer_tokenを使うものを除く、すべてのbedrockおよびmantleアップストリームでassume_roleにsession_nameを設定してください。aws_bearer_tokenを使うアップストリームはassume_roleを使えないため、それらのリクエストは単一のプリンシパルのままになります。
upstreams:
- provider: bedrock
region: us-east-1
auth: {} # the gateway's own role: it only calls STS
assume_role:
role_arn: arn:aws:iam::123456789012:role/claude-gateway-bedrock-user
session_name: email # or sub
session_name は、検証済みのどのクレームを AWS の RoleSessionName にするかを選びます:email または sub です。ゲートウェイは、ASCII の英数字と _+,.@- 以外の文字を、UTF-8 のバイトごとに =XX 形式の16進表記で書き出し、64 文字を超える結果はプレフィックスとハッシュに短縮するため、各開発者のセッション名は有効かつ一意に保たれます。そのクレームを持たないトークンの開発者からのリクエストは、このアップストリームを経由して送信されず、オペレーターログには sub に切り替えるか oidc.email_claim を設定するよう表示されます。
アクティブな開発者 1 人につき、ゲートウェイのレプリカごとに 1 時間に 1 回の STS 呼び出しが発生し、同時に届いた最初のリクエストは 1 回の呼び出しを共有します。
ゲートウェイはこのロールでもう 1 回、独自の呼び出しを行います。クライアントが中断したリクエストのトークン数をカウントするためで、これにより spend limits が正確に保たれます。このカウントと、その1トークンのフォールバックリクエストは、共有の claude-apps-gateway セッションで署名されるため、AWS はこのフォールバックをその開発者ではなく claude-apps-gateway に割り当てます。
取得日 · 2026-11-20