sandbox.credentials.sigv4

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

サンドボックスプロキシが再署名できない AWS リクエスト形式をどう扱うかを選択する。aws-chunked ストリーミングアップロードには streaming、プリサインド URL には presigned、SigV4A 非対称署名には sigv4a を指定する。これは、マスク済みペアのプレースホルダーアクセスキー ID で署名されたリクエストにのみ適用される。Claude Code v2.1.224 以降が必要。

既定値未設定の場合、すべての形式が deny 扱いになる。

記述例

{
  "sandbox": {
    "credentials": {
      "sigv4": {
        "streaming": "passthrough"
      }
    }
  }
}

使い方・用途

  • sandbox.credentials.awsPairs によるマスク済み AWS 認証情報を、再署名できない形式のリクエストでも扱えるようにしたいときに設定する。
  • aws-chunked ストリーミングアップロードや presigned URL、SigV4A 非対称署名のリクエストをプロキシがどう処理するかを deny もしくは通過で指定したいときに使う。
英語原文

Choose what the sandbox proxy does with AWS request forms it can't re-sign: streaming for aws-chunked streaming uploads, presigned for presigned URLs, and sigv4a for SigV4A asymmetric signatures. This applies only to requests signed with a masked pair's placeholder access key ID. Requires Claude Code v2.1.224 or later.

関連ドキュメント

関連する変更履歴

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

変更後

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

関連ドキュメント