Skip to content
← リリースに戻る · 2.1.318
新機能 / v2.1.318

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

変更の詳細