sandbox.credentials.awsPairs

settings.json型object[]記述場所ユーザー設定または管理者設定

クレデンシャルが非標準の名前の環境変数にある場合に、SigV4 再署名用の 1 つの AWS クレデンシャルを構成するマスク済み環境変数をグループ化する。AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN の標準的な 3 つ組は、値全体をマスクすれば Claude Code が自動的に紐付けるため、このキーが必要になるのはそれ以外の名前の場合だけである。Claude Code v2.1.224 以降が必要。

既定値未設定の場合、標準の 3 つ組のみがペアとして扱われる。

記述例

{
  "sandbox": {
    "credentials": {
      "awsPairs": [
        {
          "accessKeyIdVar": "MY_KEY_ID",
          "secretAccessKeyVar": "MY_SECRET_KEY",
          "sessionTokenVar": "MY_SESSION_TOKEN"
        }
      ]
    }
  }
}

使い方・用途

  • AWS 認証情報が標準以外の名前の環境変数に置かれている場合に、sandbox proxy による SigV4 再署名を機能させるために複数の変数を 1 組の認証情報としてまとめる。
  • 従来の AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_SESSION_TOKEN の組み合わせ以外の変数名を使いながら、sandbox 内のコマンドにはマスク値だけを見せて実際の認証情報で送信要求を再署名したい場合に利用する。
  • 一時的な認証情報を複数の環境変数(キー・シークレット・セッショントークンなど)に分けて保持している環境で、それらをマスクしつつ AWS 向け送信要求の認証を成立させるために組み合わせを宣言する。
英語原文

Group masked environment variables that form one AWS credential for SigV4 re-signing when your credential lives in variables with non-standard names. Claude Code links the conventional AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_SESSION_TOKEN trio automatically when you mask their whole values, so you need this key only for other names. Requires Claude Code v2.1.224 or later.

関連する変更履歴

v2.1.257(1件)

managedSourcesBehavior: 'merge' の挙動を変更し、sandbox.credentials.awsPairs と sandbox.ripgrep についてソース間の値を合成する代わりに、それらを設定している最上位の管理ソースからの値を丸ごと採用するようになった
英語原文を表示
Changed managedSourcesBehavior: "merge" to take sandbox.credentials.awsPairs and sandbox.ripgrep whole from the highest managed source that sets them instead of combining the sources' values

変更後

managedSourcesBehavior: 'merge' を使う場合、sandbox.credentials.awsPairs や sandbox.ripgrep が上位の管理ソースの値で一括して決まるようになり、複数ソースの値が混ざって意図しない設定になるのを防げる。

v2.1.224(1件)

サンドボックス環境におけるクレデンシャルマスキングオプションを追加:構造化された環境変数向けのextractおよびonExtractNoMatch、JWTトークン用のdecode: "jwt"(およびmaskClaims)、AWS SigV4再署名用のawsPairs/sigv4が利用できるようになります。これらを使用するには、network.tlsTerminateが有効であり、かつユーザー設定、管理者管理設定、または--settingsフラグでのみ指定されている必要があります。
英語原文を表示
Added sandbox credential-masking options: extract and onExtractNoMatch for structured env values, decode: "jwt" with maskClaims for JWT-aware masking, and awsPairs/sigv4 for AWS SigV4 re-signing; these need network.tlsTerminate and are honored only from user, managed, or --settings settings

変更後

ツールに必要な認証情報の利便性を損なうことなく、認証ファイルやトークン内の本当に保護すべき重要な情報だけを確実に隠蔽または安全に中継できるようになります。