settings.json

sandbox.credentials.sigv4

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

サンドボックス プロキシが再署名できない AWS リクエスト形式に対して行う処理を選択します。

既定値: unset, so every form is "deny"

記述例

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

使い方・用途

  • デフォルト値は未設定（すべての形式で "deny"）
  • v2.1.224 以降で利用可能
  • マスクされたペアのプレースホルダー認証キー ID で署名されたリクエストにのみ適用されます
  • streaming、presigned、sigv4a のいずれかの形式に対して passthrough を設定すると、リクエストはプレースホルダー署名で転送されます
  • ユーザー設定、管理設定、または --settings フラグからのみ適用されます
英語原文(公式ドキュメントより)

Choose what the sandbox proxy does with AWS request forms it [can't re-sign](/docs/en/sandboxing#re-sign-aws-requests): 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件)

Added
PermissionsSettings
サンドボックス環境におけるクレデンシャルマスキングオプションを追加：構造化された環境変数向けの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

変更前

サンドボックス環境でパスワードやAPIトークンなどの秘匿情報を保護する際、環境変数を完全に隠す（deny）とツールが動作しなくなり、単純に値を置換するだけの通常のマスキングではJWTのペイロード内部の特定のクレームだけを隠したり、AWS SigV4署名を保ちつつ再署名したりする高度な保護ができませんでした。

変更後

正規表現を用いて構造化ファイルから特定トークンだけを切り出すextractや、JWTをデコードして特定のクレーム値を隠す仕組み、さらにはプロキシ経由でAWS SigV4リクエストを書き換えて再署名する高度なセキュリティオプションが導入されます。これらはリポジトリ内の個別設定ファイルからは設定できず、ユーザーがコントロールする信頼された設定ソースからのみ有効化されます。

ユーザーへの恩恵

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

関連ドキュメント