View a markdown version of this page

IAM ポリシー - AWS での Claude プラットフォーム

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

IAM ポリシー

Claude Platform on AWS は、アクセスコントロールのために AWS IAM と統合されています。標準の IAM ポリシー構文を使用して、特定のワークスペースで特定の API アクションへのアクセスを許可または拒否します。

SigV4 サービス名と IAM アクション名前空間は ですaws-external-anthropic。アクションはパターンに従います aws-external-anthropic:<Action> (例: aws-external-anthropic:CreateInference)。

例: バッチ推論を拒否する

次のポリシーでは、ZDR の影響を受けやすいワークロードの一般的な要件であるバッチ処理をブロックしながら、リアルタイムの推論を許可します。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-external-anthropic:CreateInference", "aws-external-anthropic:CountTokens", "aws-external-anthropic:GetModel", "aws-external-anthropic:ListModels", "aws-external-anthropic:GetWorkspace", "aws-external-anthropic:ListWorkspaces" ], "Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*" }, { "Effect": "Deny", "Action": [ "aws-external-anthropic:CreateBatchInference", "aws-external-anthropic:GetBatchInference", "aws-external-anthropic:ListBatchInferences" ], "Resource": "*" } ] }

GetBatchInference アクションは、バッチメタデータルートとバッチ結果ルートの両方を承認します。とともに拒否すると、読み取りとバッチ列挙の両方がListBatchInferencesブロックされます。

Allow ステートメントは、ワイルドカードを使用するのではなく、特定の Get* および List*アクションを列挙します。ワイルドカードはGetFile、 (ファイルバイトをダウンロードする) および意図していない可能性のあるその他の読み取りを許可します。 は、 Allow に関係なくDeny上書きしますが、明示的な形式の方がモデルにとってより安全なパターンです。

例: 単一のワークスペースでの同期推論

1 つの本稼働ワークスペースに対して推論を実行する IAM プリンシパルに最小限のアクセス許可を付与します。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-external-anthropic:CreateInference", "aws-external-anthropic:CountTokens", "aws-external-anthropic:Get*", "aws-external-anthropic:List*" ], "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj" } ] }
注記

このポリシーのList*ワイルドカードはListWorkspaces、アカウントスコープの とも一致します。ワークスペース ARN 制約はそれをサイレントに除外するため、このポリシーはワークスペースの一覧表示を許可しません。サービスアカウントでワークスペースを列挙する必要がある場合は、 ListWorkspacesで に別のAllowステートメントを追加しますResource: "*"

このポリシーは、AWS SigV4 認証を前提としています。プリンシパルが API キーで認証する場合は、 も付与します aws-external-anthropic:CallWithBearerToken (「認証」を参照)。

例: 顧客ごとのワークスペース分離

ロールを 1 つのワークスペースに制限します。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-external-anthropic:*", "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj" }, { "Effect": "Allow", "Action": [ "aws-external-anthropic:CallWithBearerToken", "aws-external-anthropic:AssumeConsole" ], "Resource": "*" } ] }
注記

最初のステートメントのaws-external-anthropic:*ワイルドカードには、ワークスペース ARN 制約がサイレントに除外するアカウントスコープアクション (CreateWorkspaceListWorkspaces) が含まれています。これは「分離」インテントと一致しています。ロールはワークスペースを作成または列挙できませんが、ポリシーには効果のないアクセス許可が含まれています。「アカウントスコープパターンのプロビジョニングの自動化」を参照してください。

2 番目のステートメントは、ワークスペース ARN にバインドされないルートレスアクションであるため、すべてのリソースAssumeConsoleに対して CallWithBearerTokenと を付与します。ロールが SigV4 のみを使用し、Claude コンソールにフェデレーションしない場合は、2 番目のステートメントを省略します。

例: ZDR 対応ワークスペースの機能ロックダウン

同期推論を使用可能のまま、特定のワークスペースでのバッチ処理とファイルのアップロードをブロックします。ワークスペースがサーバー側で保持してはならないゼロデータ保持 (ZDR) データを処理する場合に便利です。このポリシーを、 などの許可ポリシーAnthropicLimitedAccessまたは上記の単一ワークスペースの例と一緒にアタッチします。単独では、拒否のみのポリシーはアクセス許可を付与しません。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": [ "aws-external-anthropic:CreateBatchInference", "aws-external-anthropic:CreateFile" ], "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj" } ] }
注記

この拒否は作成のみをブロックします。他のファイルおよびバッチアクションは、リストしない限り拒否されません。ワークスペースがファイルやバッチを保持してはならない完全なロックダウンの場合、aws-external-anthropic:GetFile、、aws-external-anthropic:ListFilesaws-external-anthropic:DeleteFileaws-external-anthropic:GetBatchInferenceaws-external-anthropic:ListBatchInferencesaws-external-anthropic:CancelBatchInference、および も拒否しますaws-external-anthropic:DeleteBatchInference

例: 自動化のプロビジョニング

推論アクセス許可なしで、ワークスペースの作成と管理に必要なアクションを CI/CD ロールに付与します。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-external-anthropic:CreateWorkspace", "aws-external-anthropic:GetWorkspace", "aws-external-anthropic:ListWorkspaces", "aws-external-anthropic:UpdateWorkspace", "aws-external-anthropic:ArchiveWorkspace" ], "Resource": "*" } ] }

CreateWorkspace および ListWorkspacesはアカウントスコープのオペレーションです。これらのアクションでワークスペース ARN を指定しても効果はありません。 を使用しますResource: "*"

マネージドポリシー

AWS は、一般的なアクセスパターンの マネージドポリシーを提供します。

  • AnthropicFullAccess: すべてのリソースaws-external-anthropic:*に を付与します。

  • AnthropicReadOnlyAccess: すべてのリソースCallWithBearerTokenGet*List*、および を付与します。

  • AnthropicInferenceAccess: すべてのリソースで ReadOnly アクションと推論アクション (CreateInferenceCreateBatchInferenceCancelBatchInferenceDeleteBatchInference、、CountTokens) を付与します。

  • AnthropicLimitedAccess: AnthropicInferenceAccessアクションに加えて、すべてのリソースに対するすべての Claude Managed Agents アクション (エージェント、セッション、環境、ボールト、メモリストア) を付与します。

  • AnthropicSelfHostedEnvironmentAccess: セルフホストサンドボックスワーカーが環境作業項目のポーリングと処理、関連する環境、セッション、スキルリソースの読み取り、セッション状態の更新を行うために必要なアクセス許可を付与します。セルフホスト環境ワーカーが引き受ける IAM ロールにこのポリシーをアタッチします。 AnthropicSelfHostedEnvironmentAccessは推奨される単一ロールのデフォルトです。個別の IAM プリンシパルで作業ポーラーとセッションごとのサンドボックスを実行すると、これらのアクセス許可を 2 つの狭いカスタムポリシーに分割して、最小特権を確保できます。

AnthropicInferenceAccess は、推論を実行するのに十分な最も狭い管理ポリシーです。Get* および List*ワイルドカードを介して、 を介してダウンロードされるファイルコンテンツGetFileや を介してメモリコンテンツなど、名前空間内のすべての API リソースへの読み取りアクセスを許可しますGetMemoryStore。ファイルやスキルの作成や削除、ユーザープロファイル管理、ワークスペースミューテーション、コンソールフェデレーションは許可されません。

注記

AnthropicReadOnlyAccessAnthropicInferenceAccess、および は を付与AnthropicLimitedAccessしませんAssumeConsole。Claude コンソールにフェデレーションする必要があるプリンシパルには、 aws-external-anthropic:AssumeConsole AnthropicFullAccessまたはカスタムポリシーのいずれかを使用して、 に対する個別の許可が必要です。「Claude コンソールへのフェデレーション」を参照してください。

注記

CreateInferenceCreateBatchInferenceは個別のアクションです。一方を拒否しても、他方はブロックされません。すべてのモデル呼び出しを禁止する場合は、両方を拒否します。

Claude コンソールへのフェデレーション

aws-external-anthropic:AssumeConsole では、IAM プリンシパルを Anthropic が運営する Claude コンソールにフェデレーションできます。コンソール内のアクセスは、ほとんどのオペレーションで引き続き IAM によって管理されますが、主に対応する IAM API を持たない使用ビューである管理オペレーションのサブセットは、プリンシパルがフェデレーションした機能でゲートされます。

次の 2 つの機能があります。

  • developer — は、AWS の Claude プラットフォーム開発者がday-to-dayで必要とするオペレーションを許可します。コンソールからの推論の実行、ワークスペースデータの読み取り、個人の使用状況の表示です。

  • admin — さらに、アカウント全体の使用状況ビューや IAM アクションでは表示されない管理設定など、管理者専用のコンソールオペレーションも許可します。

AssumeConsole アクションの aws-external-anthropic:Capability条件キーを使用して、プリンシパルがリクエストできる機能を制御します。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-external-anthropic:AssumeConsole", "Resource": "*", "Condition": { "StringEquals": { "aws-external-anthropic:Capability": "admin" } } } ] }

AnthropicFullAccess 機能制限AssumeConsoleのない 許可。デベロッパーのみのコンソールアクセスまたは管理者のみのアクセスなど、より狭い権限には、上記のように aws-external-anthropic:Capability条件AssumeConsoleでスコープするカスタムポリシーをアタッチします。

ベアラートークンを使用した呼び出し

aws-external-anthropic:CallWithBearerToken は、API キーがベアラートークンとして提示されるときに使用される SigV4-freeリクエストパスを承認します。API キーで認証するプリンシパルには、ターゲットワークスペースでこのアクションが必要です。これは、 Authorization: Bearer ヘッダーを直接使用ANTHROPIC_AWS_API_KEYまたは設定する場合に適用されます。

これは、推論アクション (CreateInferenceCreateBatchInferenceなど) に加えて API キー発信者に必要です。がない場合CallWithBearerToken、API キーリクエストは推論認可チェックに到達する前に拒否されます。SigV4 発信者にはこのアクションは必要ありません。

AnthropicReadOnlyAccessAnthropicInferenceAccessAnthropicLimitedAccess、および AnthropicFullAccessはすべて を含みますCallWithBearerToken。API キーアクセスのカスタムポリシーを記述する場合は、明示的に追加します。

アウトバウンドウェブ ID フェデレーション (コンソールアクセスに必要)

Claude コンソールは、AWS ではなく Anthropic インフラストラクチャで実行されます。IAM プリンシパルが を呼び出すとAssumeConsole、AWS STS は Anthropic オーディエンスを対象とするウェブ ID トークンを発行します。その後、Anthropic コンソールはそのトークンを受け入れ、フェデレーティッドセッションを確立します。これを機能させるには、AWS アカウントがaws-external-anthropic対象者へのアウトバウンドウェブ ID フェデレーションを許可する必要があります。

を呼び出すプリンシパルには、 aws-external-anthropic:AssumeConsoleアクションに加えて次の STS アクセス許可AssumeConsoleが必要です。

  • sts:GetWebIdentityToken — Anthropic コンソールが消費するウェブ ID トークンの発行を許可します。

  • sts:TagGetWebIdentityToken — は、セッションタグをウェブ ID トークンにアタッチすることを許可します。AWS の Claude Platform は、これらのタグを使用して、プリンシパルの機能とワークスペースコンテキストをコンソールに伝えます。

コンソールユーザーが引き受けるロールの信頼ポリシー、または AssumeConsole を直接呼び出すユーザー ID にアタッチされたインライン/管理ポリシーの両方に を含めます。 には、両方の STS アクションAnthropicFullAccessが含まれます。SCP またはアクセス許可sts:*の境界レベルで拒否する環境では、コンソールフェデレーションを成功させるために、これら 2 つのアクションを明示的に許可する必要があります。