• Nachrichten
  • Managed Agents
  • Admin
Search...
⌘K
Log in
IAM-Aktionen (Claude Platform auf AWS)
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
API-Referenz/Support & Konfiguration

IAM-Aktionen für Claude Platform on AWS

IAM-Aktionsreferenz zur Steuerung des Zugriffs auf Claude Platform on AWS über AWS-Richtlinien.

Claude Platform on AWS verwendet AWS IAM für die Zugriffskontrolle. Jede API-Route ist einer IAM-Aktion im Namespace aws-external-anthropic zugeordnet. Diese Seite listet alle Aktionen auf, die Routen, die jede Aktion autorisiert, sowie die verwalteten Richtlinien, die für gängige Zugriffsmuster verfügbar sind. Informationen zur Plattformeinrichtung und Authentifizierung findest du unter Claude Platform on AWS.

Service-Details

AttributWert
IAM-Service-Präfixaws-external-anthropic
Ressourcentypenworkspace

Workspace-ARN-Format:

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

Die ARN-Region ist immer ausgefüllt und entspricht der Region, an die der Workspace gebunden ist. Das Ressourcensegment ist die getaggte Workspace-ID (wrkspc_...), derselbe Wert, den du im Header anthropic-workspace-id übergibst.

Aktionen

Der Service definiert 65 Aktionen. Aktionen folgen der AWS-Konvention VerbNoun und verwenden eine strikte Verb-Disziplin, sodass Get*- und List*-Wildcards eine saubere Nur-Lese-Grenze ergeben.

Inferenz

AktionAutorisierte Routen
CreateInferencePOST /v1/messages
CountTokensPOST /v1/messages/count_tokens

Batch-Verarbeitung

AktionAutorisierte Routen
CreateBatchInferencePOST /v1/messages/batches
GetBatchInferenceGET /v1/messages/batches/{id}
GET /v1/messages/batches/{id}/results
ListBatchInferencesGET /v1/messages/batches
CancelBatchInferencePOST /v1/messages/batches/{id}/cancel
DeleteBatchInferenceDELETE /v1/messages/batches/{id}

GetBatchInference autorisiert sowohl das Lesen von Batch-Metadaten als auch das Herunterladen von Batch-Ergebnissen. Die Get*-Wildcards der Richtlinien AnthropicReadOnlyAccess, AnthropicInferenceAccess und AnthropicLimitedAccess schließen diese Aktion ein.

Modelle

AktionAutorisierte Routen
GetModelGET /v1/models/{id}
ListModelsGET /v1/models

Dateien

AktionAutorisierte Routen
CreateFilePOST /v1/files
GetFileGET /v1/files/{id}
GET /v1/files/{id}/content
ListFilesGET /v1/files
DeleteFileDELETE /v1/files/{id}

GetFile autorisiert sowohl Metadaten als auch den Download von Inhalten. Ein Principal mit Nur-Lese-Zugriff kann Datei-Bytes herunterladen, nicht nur Dateien auflisten.

Skills

AktionAutorisierte Routen
CreateSkillPOST /v1/skills
GetSkillGET /v1/skills/{id}
GET /v1/skills/{id}/versions
GET /v1/skills/{id}/versions/{version}
GET /v1/skills/{id}/versions/{version}/content
ListSkillsGET /v1/skills
UpdateSkillPOST /v1/skills/{id}/versions
DELETE /v1/skills/{id}/versions/{version}
DeleteSkillDELETE /v1/skills/{id}

GetSkill autorisiert sowohl Skill-Metadaten als auch den Download von Skill-Inhalten. Ein Principal mit Nur-Lese-Zugriff kann Skill-Bytes herunterladen, nicht nur Skills auflisten.

Das Erstellen oder Löschen einer einzelnen Skill-Version ist UpdateSkill zugeordnet, nicht CreateSkill oder DeleteSkill. Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, erlaubt weiterhin das Löschen von Versionen, und eine Richtlinie, die aws-external-anthropic:Create* verweigert, erlaubt weiterhin das Erstellen von Versionen. Verweigere zusätzlich UpdateSkill und CreateSkill, wenn du jegliche Skill-Änderung verhindern musst.

Agents

AktionAutorisierte Routen
CreateAgentPOST /v1/agents
GetAgentGET /v1/agents/{id}
GET /v1/agents/{id}/versions
ListAgentsGET /v1/agents
UpdateAgentPOST /v1/agents/{id}
ArchiveAgentPOST /v1/agents/{id}/archive

Agents unterstützen nur Archivierung, kein endgültiges Löschen. Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, blockiert ArchiveAgent nicht. Verweigere ArchiveAgent, UpdateAgent und CreateAgent, wenn du jegliche Agent-Änderung verhindern musst.

Sessions

AktionAutorisierte Routen
CreateSessionPOST /v1/sessions
GetSessionGET /v1/sessions/{id}
GET /v1/sessions/{id}/events
GET /v1/sessions/{id}/events/stream
GET /v1/sessions/{id}/resources
GET /v1/sessions/{id}/resources/{id}
ListSessionsGET /v1/sessions
UpdateSessionPOST /v1/sessions/{id}
POST /v1/sessions/{id}/events
POST /v1/sessions/{id}/resources
POST /v1/sessions/{id}/resources/{id}
DELETE /v1/sessions/{id}/resources/{id}
ArchiveSessionPOST /v1/sessions/{id}/archive
DeleteSessionDELETE /v1/sessions/{id}

GetSession autorisiert das Lesen von Session-Metadaten, des vollständigen Event-Streams (Konversationsverlauf) und der Session-Ressourcen. Die Get*-Wildcards der Richtlinien AnthropicReadOnlyAccess, AnthropicInferenceAccess und AnthropicLimitedAccess schließen diese Aktion ein.

Das Erstellen, Aktualisieren oder Löschen einer einzelnen Session-Unterressource (Events oder Session-Ressourcen) ist UpdateSession zugeordnet, nicht CreateSession oder DeleteSession. Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, erlaubt weiterhin das Löschen von Unterressourcen, und eine Richtlinie, die aws-external-anthropic:Create* verweigert, erlaubt weiterhin das Erstellen von Unterressourcen. Verweigere zusätzlich UpdateSession, CreateSession und ArchiveSession, wenn du jegliche Session-Änderung verhindern musst.

Environments

AktionAutorisierte Routen
CreateEnvironmentPOST /v1/environments
GetEnvironmentGET /v1/environments/{id}
GET /v1/environments/{id}/work/{work_id}
GET /v1/environments/{id}/work/stats
ListEnvironmentsGET /v1/environments
UpdateEnvironmentPOST /v1/environments/{id}
ArchiveEnvironmentPOST /v1/environments/{id}/archive
DeleteEnvironmentDELETE /v1/environments/{id}
ProcessEnvironmentWorkGET /v1/environments/{id}/work/poll
POST /v1/environments/{id}/work/{work_id}
POST /v1/environments/{id}/work/{work_id}/ack
POST /v1/environments/{id}/work/{work_id}/heartbeat
POST /v1/environments/{id}/work/{work_id}/stop

Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, blockiert ArchiveEnvironment nicht. ProcessEnvironmentWork wird nicht von den Wildcards Create*, Update*, Delete* oder Archive* erfasst. Verweigere zusätzlich ArchiveEnvironment, UpdateEnvironment, CreateEnvironment und ProcessEnvironmentWork, wenn du jegliche Environment-Änderung verhindern musst.

ProcessEnvironmentWork autorisiert einen selbst gehosteten Sandbox-Worker, Environment-Work-Items abzurufen, zu bestätigen, Heartbeats zu senden, zu stoppen und Ergebnisse zu posten. Gewähre diese Aktion nur Principals, die selbst gehostete Environment-Worker ausführen. Die verwaltete Richtlinie AnthropicSelfHostedEnvironmentAccess enthält diese Aktion.

Vaults

AktionAutorisierte Routen
CreateVaultPOST /v1/vaults
GetVaultGET /v1/vaults/{id}
GET /v1/vaults/{id}/credentials
GET /v1/vaults/{id}/credentials/{id}
ListVaultsGET /v1/vaults
UpdateVaultPOST /v1/vaults/{id}
POST /v1/vaults/{id}/credentials
POST /v1/vaults/{id}/credentials/{id}
POST /v1/vaults/{id}/credentials/{id}/archive
DELETE /v1/vaults/{id}/credentials/{id}
ArchiveVaultPOST /v1/vaults/{id}/archive
DeleteVaultDELETE /v1/vaults/{id}

Das Erstellen, Aktualisieren, Archivieren oder Löschen einer einzelnen Vault-Credential ist UpdateVault zugeordnet. Das Lesen einer Credential ist GetVault zugeordnet. Vault-Credential-Secrets werden nicht offengelegt: Secret-Felder sind nur schreibbar und werden niemals von GetVault zurückgegeben (siehe Mit Vaults authentifizieren). Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, erlaubt weiterhin das Löschen von Credentials, und eine Richtlinie, die aws-external-anthropic:Create* verweigert, erlaubt weiterhin das Erstellen von Credentials. Verweigere zusätzlich UpdateVault, CreateVault und ArchiveVault, wenn du jegliche Vault-Änderung verhindern musst.

Memory Stores

AktionAutorisierte Routen
CreateMemoryStorePOST /v1/memory_stores
GetMemoryStoreGET /v1/memory_stores/{id}
GET /v1/memory_stores/{id}/memories
GET /v1/memory_stores/{id}/memories/{id}
GET /v1/memory_stores/{id}/memory_versions
GET /v1/memory_stores/{id}/memory_versions/{id}
ListMemoryStoresGET /v1/memory_stores
UpdateMemoryStorePOST /v1/memory_stores/{id}
POST /v1/memory_stores/{id}/memories
POST /v1/memory_stores/{id}/memories/{id}
DELETE /v1/memory_stores/{id}/memories/{id}
POST /v1/memory_stores/{id}/memory_versions/{id}/redact
ArchiveMemoryStorePOST /v1/memory_stores/{id}/archive
DeleteMemoryStoreDELETE /v1/memory_stores/{id}

GetMemoryStore autorisiert das Lesen von Store-Metadaten, allen Memories und dem Memory-Versionsverlauf. Die Get*-Wildcards der Richtlinien AnthropicReadOnlyAccess, AnthropicInferenceAccess und AnthropicLimitedAccess schließen diese Aktion ein.

Das Erstellen, Aktualisieren oder Löschen einer einzelnen Memory sowie das Schwärzen einer Memory-Version sind beide UpdateMemoryStore zugeordnet, nicht CreateMemoryStore oder DeleteMemoryStore. Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, erlaubt weiterhin das Löschen einzelner Memories und das Schwärzen von Memory-Versionen, und eine Richtlinie, die aws-external-anthropic:Create* verweigert, erlaubt weiterhin das Erstellen einzelner Memories. Verweigere zusätzlich UpdateMemoryStore, CreateMemoryStore und ArchiveMemoryStore, wenn du jegliche Memory-Store-Änderung verhindern musst.

Webhooks

AktionAutorisierte Routen
CreateWebhookPOST /v1/webhooks
GetWebhookGET /v1/webhooks/{id}
ListWebhooksGET /v1/webhooks
UpdateWebhookPOST /v1/webhooks/{id}
DeleteWebhookDELETE /v1/webhooks/{id}
RotateWebhookSecretPOST /v1/webhooks/{id}/regenerate_signing_secret

Webhook-Signing-Secrets sind nur schreibbar. GetWebhook gibt nur Webhook-Metadaten zurück; das Signing-Secret wird nicht zurückgegeben.

RotateWebhookSecret wird nicht von den Wildcards aws-external-anthropic:Create*, Update* oder Delete* erfasst. Eine Richtlinie, die diese Muster verweigert, erlaubt weiterhin die Secret-Rotation. Verweigere RotateWebhookSecret, UpdateWebhook, CreateWebhook und DeleteWebhook, wenn du jegliche Webhook-Änderung verhindern musst.

Benutzerprofile

AktionAutorisierte Routen
CreateUserProfilePOST /v1/user_profiles
GetUserProfileGET /v1/user_profiles/{id}
ListUserProfilesGET /v1/user_profiles
UpdateUserProfilePOST /v1/user_profiles/{id}

Der Abgleich von IAM-Aktionen ist nicht case-sensitiv. Die Wildcard aws-external-anthropic:*File erfasst CreateFile, GetFile und DeleteFile, aber nicht ListFiles (das auf „files" endet, nicht auf „file"). Sie erfasst außerdem fälschlicherweise CreateUserProfile, GetUserProfile und UpdateUserProfile, weil „Profile" auf „file" endet. Wenn du nur Files-API-Aktionen gewähren oder verweigern möchtest, zähle sie explizit auf (CreateFile, GetFile, ListFiles, DeleteFile), anstatt ein *File-Suffix-Muster zu verwenden.

Workspaces

AktionAutorisierte Routen
CreateWorkspacePOST /v1/organizations/workspaces
GetWorkspaceGET /v1/organizations/workspaces/{id}
ListWorkspacesGET /v1/organizations/workspaces
UpdateWorkspacePOST /v1/organizations/workspaces/{id}
ArchiveWorkspacePOST /v1/organizations/workspaces/{id}/archive

Workspaces unterstützen nur Archivierung, kein endgültiges Löschen. Eine Richtlinie, die aws-external-anthropic:Delete* verweigert, blockiert ArchiveWorkspace nicht. Verweigere ArchiveWorkspace, UpdateWorkspace und CreateWorkspace, wenn du jegliche Workspace-Änderung verhindern musst.

Authentifizierung

AktionAutorisierte Routen
CallWithBearerToken(keine)

CallWithBearerToken ist eine Berechtigung auf Authentifizierungsebene, die einen Principal autorisiert, sich über einen API-Key (Bearer-Token) statt über AWS SigV4 zu authentifizieren. Sie ist keiner Route zugeordnet. Gewähre sie zusammen mit den routenbezogenen Aktionen, die der API-Key-Inhaber ausführen soll.

Konsolenzugriff

AktionAutorisierte Routen
AssumeConsole(keine)

AssumeConsole autorisiert einen Principal, die Claude Console für einen Claude Platform on AWS-Workspace über den AWS-Console-Federation-Flow zu öffnen. Sie ist keiner Route zugeordnet. Gewähre sie Principals, die auf der Claude Platform on AWS-Serviceseite in der AWS Console auf Open Claude Console klicken können sollen. Die Claude Console-Rolle (Admin oder Developer) wird separat von deinem Anthropic-Account-Ansprechpartner zugewiesen; sie wird nicht aus den IAM-Berechtigungen des Principals abgeleitet. Siehe Verwendung der Claude Console für den Anmeldeablauf und die Rollenbeschreibungen.

Zuordnung von Routen zu Aktionen

Die folgende Tabelle listet jede Route auf Claude Platform on AWS und die IAM-Aktion auf, die zum Aufrufen erforderlich ist. Jede IAM-Aktion autorisiert auch Anfragen, die den Header anthropic-beta verwenden; Beta-Varianten einer Route erfordern keine separate IAM-Aktion. CloudTrail klassifiziert jede Aktion entweder als Data-Event (hochvolumige Data-Plane-Operationen) oder als Management-Event (Control-Plane-Operationen). Vault- und Webhook-Aktionen werden als Management-Events klassifiziert, weil sie Secrets enthalten (Vault-Credentials und Webhook-Signing-Secrets) und von standardmäßig aktiviertem Audit-Logging profitieren. Workspace-Aktionen werden ebenfalls als Management-Events klassifiziert, weil sie organisationsbezogene Control-Plane-Operationen sind. Alle anderen Aktionen, einschließlich Inferenz, Batch, Modell, Datei, Skill, Benutzerprofil und die übrigen Claude Managed Agents-Aktionen, werden als Data-Events klassifiziert.

MethodeRouteIAM-AktionCloudTrail-Event-Typ
POST/v1/messagesCreateInferenceData
POST/v1/messages/count_tokensCountTokensData
POST/v1/messages/batchesCreateBatchInferenceData
GET/v1/messages/batchesListBatchInferencesData
GET/v1/messages/batches/{id}GetBatchInferenceData
GET/v1/messages/batches/{id}/resultsGetBatchInferenceData
POST/v1/messages/batches/{id}/cancelCancelBatchInferenceData
DELETE/v1/messages/batches/{id}DeleteBatchInferenceData
GET/v1/modelsListModelsData
GET/v1/models/{id}GetModelData
POST/v1/filesCreateFileData
GET/v1/filesListFilesData
GET/v1/files/{id}GetFileData
GET/v1/files/{id}/contentGetFileData
DELETE/v1/files/{id}DeleteFileData
POST/v1/skillsCreateSkillData
GET/v1/skillsListSkillsData
GET/v1/skills/{id}GetSkillData
DELETE/v1/skills/{id}DeleteSkillData
POST/v1/skills/{id}/versionsUpdateSkillData
GET/v1/skills/{id}/versionsGetSkillData
GET/v1/skills/{id}/versions/{version}GetSkillData
GET/v1/skills/{id}/versions/{version}/contentGetSkillData
DELETE/v1/skills/{id}/versions/{version}UpdateSkillData
POST/v1/user_profilesCreateUserProfileData
GET/v1/user_profilesListUserProfilesData
GET/v1/user_profiles/{id}GetUserProfileData
POST/v1/user_profiles/{id}UpdateUserProfileData
POST/v1/organizations/workspacesCreateWorkspaceManagement
GET/v1/organizations/workspacesListWorkspacesManagement
GET/v1/organizations/workspaces/{id}GetWorkspaceManagement
POST/v1/organizations/workspaces/{id}UpdateWorkspaceManagement
POST/v1/organizations/workspaces/{id}/archiveArchiveWorkspaceManagement
POST/v1/agentsCreateAgentData
GET/v1/agentsListAgentsData
GET/v1/agents/{id}GetAgentData
POST/v1/agents/{id}UpdateAgentData
POST/v1/agents/{id}/archiveArchiveAgentData
GET/v1/agents/{id}/versionsGetAgentData
POST/v1/sessionsCreateSessionData
GET/v1/sessionsListSessionsData
GET/v1/sessions/{id}GetSessionData
POST/v1/sessions/{id}UpdateSessionData
POST/v1/sessions/{id}/archiveArchiveSessionData
DELETE/v1/sessions/{id}DeleteSessionData
GET/v1/sessions/{id}/eventsGetSessionData
POST/v1/sessions/{id}/eventsUpdateSessionData
GET/v1/sessions/{id}/events/streamGetSessionData
GET/v1/sessions/{id}/resourcesGetSessionData
GET/v1/sessions/{id}/resources/{id}GetSessionData
POST/v1/sessions/{id}/resourcesUpdateSessionData
POST/v1/sessions/{id}/resources/{id}UpdateSessionData
DELETE/v1/sessions/{id}/resources/{id}UpdateSessionData
POST/v1/environmentsCreateEnvironmentData
GET/v1/environmentsListEnvironmentsData
GET/v1/environments/{id}GetEnvironmentData
POST/v1/environments/{id}UpdateEnvironmentData
POST/v1/environments/{id}/archiveArchiveEnvironmentData
DELETE/v1/environments/{id}DeleteEnvironmentData
GET/v1/environments/{id}/work/pollProcessEnvironmentWorkData
GET/v1/environments/{id}/work/{work_id}GetEnvironmentData
GET/v1/environments/{id}/work/statsGetEnvironmentData
POST/v1/environments/{id}/work/{work_id}ProcessEnvironmentWorkData
POST/v1/environments/{id}/work/{work_id}/ackProcessEnvironmentWorkData
POST/v1/environments/{id}/work/{work_id}/heartbeatProcessEnvironmentWorkData
POST/v1/environments/{id}/work/{work_id}/stopProcessEnvironmentWorkData
POST/v1/vaultsCreateVaultManagement
GET/v1/vaultsListVaultsManagement
GET/v1/vaults/{id}GetVaultManagement
POST/v1/vaults/{id}UpdateVaultManagement
POST/v1/vaults/{id}/archiveArchiveVaultManagement
DELETE/v1/vaults/{id}DeleteVaultManagement
GET/v1/vaults/{id}/credentialsGetVaultManagement
POST/v1/vaults/{id}/credentialsUpdateVaultManagement
GET/v1/vaults/{id}/credentials/{id}GetVaultManagement
POST/v1/vaults/{id}/credentials/{id}UpdateVaultManagement
POST/v1/vaults/{id}/credentials/{id}/archiveUpdateVaultManagement
DELETE/v1/vaults/{id}/credentials/{id}UpdateVaultManagement
POST/v1/memory_storesCreateMemoryStoreData
GET/v1/memory_storesListMemoryStoresData
GET/v1/memory_stores/{id}GetMemoryStoreData
POST/v1/memory_stores/{id}UpdateMemoryStoreData
POST/v1/memory_stores/{id}/archiveArchiveMemoryStoreData
DELETE/v1/memory_stores/{id}DeleteMemoryStoreData
POST/v1/memory_stores/{id}/memoriesUpdateMemoryStoreData
GET/v1/memory_stores/{id}/memoriesGetMemoryStoreData
GET/v1/memory_stores/{id}/memories/{id}GetMemoryStoreData
POST/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreData
DELETE/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreData
GET/v1/memory_stores/{id}/memory_versionsGetMemoryStoreData
GET/v1/memory_stores/{id}/memory_versions/{id}GetMemoryStoreData
POST/v1/memory_stores/{id}/memory_versions/{id}/redactUpdateMemoryStoreData
GET/v1/webhooksListWebhooksManagement
GET/v1/webhooks/{id}GetWebhookManagement
POST/v1/webhooksCreateWebhookManagement
POST/v1/webhooks/{id}UpdateWebhookManagement
DELETE/v1/webhooks/{id}DeleteWebhookManagement
POST/v1/webhooks/{id}/regenerate_signing_secretRotateWebhookSecretManagement

Routen, die nicht in dieser Tabelle aufgeführt sind, sind auf Claude Platform on AWS nicht verfügbar. Das Gateway verweigert standardmäßig jede hier nicht aufgeführte Route.

Workspace-Routen sind die einzigen Admin-API-Routen, die auf Claude Platform on AWS verfügbar sind. Die Workspaces-Seite in der Claude Console ist schreibgeschützt; verwende die Admin-API oder die AWS Console, um Workspaces zu erstellen, zu aktualisieren oder zu archivieren.

Verwaltete Richtlinien

AWS stellt fünf verwaltete Richtlinien für Claude Platform on AWS bereit. Alle verwalteten Richtlinien gelten für Resource: "*".

RichtlinieGewährt
AnthropicFullAccessaws-external-anthropic:*
AnthropicReadOnlyAccessGet*, List*, CallWithBearerToken
AnthropicInferenceAccessGet*, List*, CreateInference, CreateBatchInference, CancelBatchInference, DeleteBatchInference, CountTokens, CallWithBearerToken
AnthropicLimitedAccessAlle AnthropicInferenceAccess-Aktionen plus alle Claude Managed Agents-Aktionen (Agents, Sessions, Environments, Vaults, Memory Stores, Webhooks und selbst gehostete Environment-Work)
AnthropicSelfHostedEnvironmentAccessGetEnvironment, ProcessEnvironmentWork, GetSession, UpdateSession, GetSkill, CallWithBearerToken

AnthropicInferenceAccess ist die engste verwaltete Richtlinie, die zum Ausführen von Inferenz ausreicht. Sie deckt sowohl synchrone als auch Batch-Inferenz ab und gewährt über die Get*- und List*-Wildcards Lesezugriff auf jede API-Ressource im Namespace, einschließlich Claude Managed Agents (CMA)-Ressourcen (Agents, Sessions, Environments, Vaults, Memory Stores und Webhooks). Dies umfasst den Download von Dateiinhalten über GetFile (siehe den Hinweis unter Dateien), den Download von Skill-Inhalten über GetSkill (siehe den Hinweis unter Skills) und Memory-Inhalte über GetMemoryStore. Vault-Credential-Secrets und Webhook-Signing-Secrets werden nicht offengelegt: Diese Felder sind nur schreibbar und werden niemals von GetVault oder GetWebhook zurückgegeben (siehe Mit Vaults authentifizieren). AnthropicInferenceAccess gewährt keine Dateierstellung oder -löschung, kein Skill-Management, kein Benutzerprofil-Management, keine Workspace-Änderung und keine Claude Managed Agents-Schreibaktion (Erstellen, Aktualisieren, Archivieren, Löschen, Verarbeiten oder Rotieren). Um CMA-Lesezugriffe auszuschließen, ersetze AnthropicInferenceAccess durch eine benutzerdefinierte Richtlinie, die nur die spezifischen Nicht-CMA-Aktionen aufzählt, die du benötigst.

AnthropicReadOnlyAccess, AnthropicInferenceAccess und AnthropicLimitedAccess enthalten alle die Get*- und List*-Wildcards, die Lesezugriff auf alle Inhalte im Workspace gewähren: Datei-Bytes, Skill-Inhalte, Batch-Ergebnisse, Session-Konversationsverlauf und Memory-Inhalte. Vault-Credential-Secrets und Webhook-Signing-Secrets werden nicht offengelegt; diese Felder sind nur schreibbar und werden niemals von GetVault oder GetWebhook zurückgegeben. Wenn dein Principal keine vorhandenen Inhalte lesen soll, verwende eine benutzerdefinierte Richtlinie, die nur die Aktionen aufzählt, die du benötigst.

AnthropicLimitedAccess enthält zusätzlich zu den Inferenz-Aktionen alle Claude Managed Agents-Aktionen.

AnthropicSelfHostedEnvironmentAccess ist die engste verwaltete Richtlinie, die zum Ausführen eines selbst gehosteten Sandbox-Workers ausreicht. Hänge sie an den Principal an, als der sich dein Environment-Worker authentifiziert.

AssumeConsole ist nicht in AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess oder AnthropicSelfHostedEnvironmentAccess enthalten. Principals, die Zugriff auf die Claude Console benötigen, brauchen entweder AnthropicFullAccess oder eine benutzerdefinierte Richtlinie, die aws-external-anthropic:AssumeConsole gewährt. Siehe Konsolenzugriff.

CreateInference und CreateBatchInference sind separate Aktionen. Das Verweigern einer blockiert die andere nicht. Wenn du alle Modellaufrufe verhindern möchtest, verweigere beide.

Beispielrichtlinien

Synchrone Inferenz auf einem einzelnen Workspace

Gewährt die minimalen Berechtigungen für einen IAM-Principal, der Inferenz gegen einen Produktions-Workspace ausführt:

{
  "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"
      ],
      "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
    }
  ]
}

ListWorkspaces ist account-bezogen (siehe Provisioning-Automatisierung). Wenn dein Service-Account Workspaces aufzählen muss, füge ein separates Allow-Statement für ListWorkspaces mit Resource: "*" hinzu.

Diese Richtlinie setzt AWS-SigV4-Authentifizierung voraus. Wenn sich der Principal mit einem API-Key authentifiziert, füge ein separates Allow-Statement für aws-external-anthropic:CallWithBearerToken mit Resource: "*" hinzu. CallWithBearerToken ist eine routenlose Aktion, die nicht an einen Workspace-ARN gebunden ist. Siehe Workspace-Isolation pro Kunde für das Zwei-Statement-Muster.

Workspace-Isolation pro Kunde

Beschränkt eine Rolle auf einen einzelnen Workspace:

{
  "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": "*"
    }
  ]
}

Die aws-external-anthropic:*-Wildcard im ersten Statement enthält account-bezogene Aktionen (CreateWorkspace, ListWorkspaces), die durch die Workspace-ARN-Einschränkung stillschweigend herausgefiltert werden. Dies entspricht der „Isolations"-Absicht (die Rolle kann keine Workspaces erstellen oder aufzählen), aber die Richtlinie enthält Berechtigungen, die keine Wirkung haben. Siehe Provisioning-Automatisierung für das account-bezogene Muster.

CallWithBearerToken und AssumeConsole sind routenlose Aktionen, die nicht an einen Workspace-ARN gebunden sind. Das zweite Statement gewährt sie auf Resource: "*", damit sich die Rolle mit einem API-Key authentifizieren und die Claude Console öffnen kann. Lass dieses Statement weg, wenn die Rolle nur SigV4 verwendet und keinen Claude Console-Zugriff benötigt.

Feature-Lockdown für einen ZDR-sensiblen Workspace

Blockiert Batch-Verarbeitung und Datei-Upload auf einem bestimmten Workspace, während synchrone Inferenz verfügbar bleibt. Nützlich, wenn ein Workspace Zero Data Retention (ZDR)-Daten verarbeitet, die nicht serverseitig persistiert werden dürfen. Hänge diese Richtlinie zusammen mit einer Allow-Richtlinie wie AnthropicInferenceAccess oder dem Einzel-Workspace-Beispiel an; für sich allein gewährt eine reine Deny-Richtlinie keine Berechtigungen:

{
  "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"
    }
  ]
}

Dieses Deny blockiert nur die Erstellung. Andere Datei- und Batch-Aktionen werden nicht verweigert, es sei denn, du listest sie ebenfalls auf. Für einen vollständigen Lockdown, bei dem der Workspace niemals Dateien oder Batches enthalten darf, verweigere zusätzlich aws-external-anthropic:GetFile, aws-external-anthropic:ListFiles, aws-external-anthropic:DeleteFile, aws-external-anthropic:GetBatchInference, aws-external-anthropic:ListBatchInferences, aws-external-anthropic:CancelBatchInference und aws-external-anthropic:DeleteBatchInference.

Provisioning-Automatisierung

Die Workspaces-Seite in der Claude Console ist schreibgeschützt; verwende die Admin-API-Workspace-Endpunkte oder die AWS Console, um Workspaces zu erstellen, zu aktualisieren oder zu archivieren.

Gewährt einer CI/CD-Rolle die Aktionen, die zum Erstellen und Verwalten von Workspaces erforderlich sind, ohne jegliche Inferenz-Berechtigungen:

{
  "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 und ListWorkspaces sind account-bezogene Operationen. Die Angabe eines Workspace-ARN bei diesen Aktionen hat keine Wirkung; verwende Resource: "*".

Siehe auch

  • Claude Platform on AWS für Einrichtung, Authentifizierung und Plattformübersicht
  • AWS IAM User Guide für IAM-Richtliniensyntax und Auswertungslogik
  • AWS CloudTrail User Guide für die Konfiguration des Audit-Loggings

Was this page helpful?

  • Service-Details
  • Aktionen
  • Inferenz
  • Batch-Verarbeitung
  • Modelle
  • Dateien
  • Skills
  • Agents
  • Sessions
  • Environments
  • Vaults
  • Memory Stores
  • Webhooks
  • Benutzerprofile
  • Workspaces
  • Authentifizierung
  • Konsolenzugriff
  • Zuordnung von Routen zu Aktionen
  • Verwaltete Richtlinien
  • Beispielrichtlinien
  • Synchrone Inferenz auf einem einzelnen Workspace
  • Workspace-Isolation pro Kunde
  • Feature-Lockdown für einen ZDR-sensiblen Workspace
  • Provisioning-Automatisierung
  • Siehe auch