• Mensagens
  • Agentes Gerenciados
  • Administração
Search...
⌘K
Log in
Ações de IAM (Claude Platform na 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
Referência da API/Suporte e configuração

Ações do IAM para Claude Platform on AWS

Referência de ações do IAM para controlar o acesso ao Claude Platform on AWS por meio de políticas da AWS.

O Claude Platform on AWS usa o AWS IAM para controle de acesso. Cada rota da API é mapeada para uma ação do IAM no namespace aws-external-anthropic. Esta página lista todas as ações, as rotas que cada ação autoriza e as políticas gerenciadas disponíveis para padrões de acesso comuns. Para configuração da plataforma e autenticação, consulte Claude Platform on AWS.

Detalhes do serviço

AtributoValor
Prefixo de serviço do IAMaws-external-anthropic
Tipos de recursoworkspace

Formato do ARN de workspace:

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

A região do ARN é sempre preenchida e corresponde à região à qual o workspace está vinculado. O segmento de recurso é o ID de workspace com tag (wrkspc_...), o mesmo valor que você passa no cabeçalho anthropic-workspace-id.

Ações

O serviço define 65 ações. As ações seguem a convenção VerbNoun da AWS e usam disciplina de verbos para que os curingas Get* e List* produzam um limite limpo de somente leitura.

Inferência

AçãoRotas autorizadas
CreateInferencePOST /v1/messages
CountTokensPOST /v1/messages/count_tokens

Processamento em lote

AçãoRotas autorizadas
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 autoriza tanto a leitura de metadados do lote quanto o download dos resultados do lote. Os curingas Get* das políticas AnthropicReadOnlyAccess, AnthropicInferenceAccess e AnthropicLimitedAccess incluem esta ação.

Modelos

AçãoRotas autorizadas
GetModelGET /v1/models/{id}
ListModelsGET /v1/models

Arquivos

AçãoRotas autorizadas
CreateFilePOST /v1/files
GetFileGET /v1/files/{id}
GET /v1/files/{id}/content
ListFilesGET /v1/files
DeleteFileDELETE /v1/files/{id}

GetFile autoriza tanto metadados quanto download de conteúdo. Um principal com acesso somente leitura pode baixar bytes de arquivo, não apenas listar arquivos.

Skills

AçãoRotas autorizadas
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 autoriza tanto metadados de skill quanto download de conteúdo de skill. Um principal com acesso somente leitura pode baixar bytes de skill, não apenas listar skills.

Criar ou excluir uma versão individual de skill é mapeado para UpdateSkill, não para CreateSkill ou DeleteSkill. Uma política que nega aws-external-anthropic:Delete* ainda permite a exclusão de versões, e uma política que nega aws-external-anthropic:Create* ainda permite a criação de versões. Negue também UpdateSkill e CreateSkill se você precisar impedir qualquer mutação de skill.

Agentes

AçãoRotas autorizadas
CreateAgentPOST /v1/agents
GetAgentGET /v1/agents/{id}
GET /v1/agents/{id}/versions
ListAgentsGET /v1/agents
UpdateAgentPOST /v1/agents/{id}
ArchiveAgentPOST /v1/agents/{id}/archive

Agentes suportam apenas arquivamento, não exclusão definitiva. Uma política que nega aws-external-anthropic:Delete* não bloqueia ArchiveAgent. Negue ArchiveAgent, UpdateAgent e CreateAgent se você precisar impedir qualquer mutação de agente.

Sessões

AçãoRotas autorizadas
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 autoriza a leitura de metadados da sessão, do fluxo completo de eventos (histórico de conversa) e dos recursos da sessão. Os curingas Get* das políticas AnthropicReadOnlyAccess, AnthropicInferenceAccess e AnthropicLimitedAccess incluem esta ação.

Criar, atualizar ou excluir um sub-recurso individual de sessão (eventos ou recursos de sessão) é mapeado para UpdateSession, não para CreateSession ou DeleteSession. Uma política que nega aws-external-anthropic:Delete* ainda permite a exclusão de sub-recursos, e uma política que nega aws-external-anthropic:Create* ainda permite a criação de sub-recursos. Negue também UpdateSession, CreateSession e ArchiveSession se você precisar impedir qualquer mutação de sessão.

Ambientes

AçãoRotas autorizadas
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

Uma política que nega aws-external-anthropic:Delete* não bloqueia ArchiveEnvironment. ProcessEnvironmentWork não é correspondido pelos curingas Create*, Update*, Delete* ou Archive*. Negue também ArchiveEnvironment, UpdateEnvironment, CreateEnvironment e ProcessEnvironmentWork se você precisar impedir qualquer mutação de ambiente.

ProcessEnvironmentWork autoriza um worker de sandbox auto-hospedado a fazer polling, confirmar (ack), enviar heartbeat, parar e publicar resultados em itens de trabalho de ambiente. Conceda-a apenas a principals que executam workers de ambiente auto-hospedados. A política gerenciada AnthropicSelfHostedEnvironmentAccess inclui esta ação.

Vaults

AçãoRotas autorizadas
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}

Criar, atualizar, arquivar ou excluir uma credencial individual de vault é mapeado para UpdateVault. Ler uma credencial é mapeado para GetVault. Segredos de credenciais de vault não são expostos: campos de segredo são somente escrita e nunca são retornados por GetVault (consulte Autenticar com vaults). Uma política que nega aws-external-anthropic:Delete* ainda permite a exclusão de credenciais, e uma política que nega aws-external-anthropic:Create* ainda permite a criação de credenciais. Negue também UpdateVault, CreateVault e ArchiveVault se você precisar impedir qualquer mutação de vault.

Memory stores

AçãoRotas autorizadas
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 autoriza a leitura de metadados do store, todas as memórias e o histórico de versões de memória. Os curingas Get* das políticas AnthropicReadOnlyAccess, AnthropicInferenceAccess e AnthropicLimitedAccess incluem esta ação.

Criar, atualizar ou excluir uma memória individual e redigir uma versão de memória são ambos mapeados para UpdateMemoryStore, não para CreateMemoryStore ou DeleteMemoryStore. Uma política que nega aws-external-anthropic:Delete* ainda permite a exclusão de memórias individuais e a redação de versões de memória, e uma política que nega aws-external-anthropic:Create* ainda permite a criação de memórias individuais. Negue também UpdateMemoryStore, CreateMemoryStore e ArchiveMemoryStore se você precisar impedir qualquer mutação de memory store.

Webhooks

AçãoRotas autorizadas
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

Segredos de assinatura de webhook são somente escrita. GetWebhook retorna apenas metadados do webhook; não retorna o segredo de assinatura.

RotateWebhookSecret não é correspondido pelos curingas aws-external-anthropic:Create*, Update* ou Delete*. Uma política que nega esses padrões ainda permite a rotação de segredos. Negue RotateWebhookSecret, UpdateWebhook, CreateWebhook e DeleteWebhook se você precisar impedir qualquer mutação de webhook.

Perfis de usuário

AçãoRotas autorizadas
CreateUserProfilePOST /v1/user_profiles
GetUserProfileGET /v1/user_profiles/{id}
ListUserProfilesGET /v1/user_profiles
UpdateUserProfilePOST /v1/user_profiles/{id}

A correspondência de ações do IAM não diferencia maiúsculas de minúsculas. O curinga aws-external-anthropic:*File corresponde a CreateFile, GetFile e DeleteFile, mas não corresponde a ListFiles (que termina em "files", não "file"). Ele também corresponde indevidamente a CreateUserProfile, GetUserProfile e UpdateUserProfile porque "Profile" termina em "file". Se você pretende conceder ou negar apenas ações da API de Arquivos, enumere-as explicitamente (CreateFile, GetFile, ListFiles, DeleteFile) em vez de usar um padrão de sufixo *File.

Workspaces

AçãoRotas autorizadas
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 suportam apenas arquivamento, não exclusão definitiva. Uma política que nega aws-external-anthropic:Delete* não bloqueia ArchiveWorkspace. Negue ArchiveWorkspace, UpdateWorkspace e CreateWorkspace se você precisar impedir qualquer mutação de workspace.

Autenticação

AçãoRotas autorizadas
CallWithBearerToken(nenhuma)

CallWithBearerToken é uma permissão da camada de autenticação que autoriza um principal a se autenticar por meio de uma chave de API (bearer token) em vez de AWS SigV4. Ela não é mapeada para uma rota. Conceda-a junto com as ações mapeadas para rotas que você deseja que o portador da chave de API execute.

Acesso ao console

AçãoRotas autorizadas
AssumeConsole(nenhuma)

AssumeConsole autoriza um principal a abrir o Claude Console para um workspace do Claude Platform on AWS por meio do fluxo de federação do AWS Console. Ela não é mapeada para uma rota. Conceda-a a principals que devem poder clicar em Open Claude Console na página de serviço do Claude Platform on AWS no AWS Console. A função do Claude Console (Admin ou Developer) é atribuída separadamente pelo seu representante de conta da Anthropic; ela não é derivada das permissões do IAM do principal. Consulte Usando o Claude Console para o fluxo de login e descrições de funções.

Mapeamento de rota para ação

A tabela a seguir lista todas as rotas no Claude Platform on AWS e a ação do IAM necessária para chamá-las. Cada ação do IAM também autoriza requisições que usam o cabeçalho anthropic-beta; variantes beta de uma rota não exigem uma ação do IAM separada. O CloudTrail classifica cada ação como um evento de Dados (operações de plano de dados de alto volume) ou um evento de Gerenciamento (operações de plano de controle). Ações de vault e webhook são classificadas como eventos de Gerenciamento porque contêm segredos (credenciais de vault e segredos de assinatura de webhook) e se beneficiam de log de auditoria ativado por padrão. Ações de workspace também são classificadas como eventos de Gerenciamento porque são operações de plano de controle com escopo de organização. Todas as outras ações, incluindo inferência, lote, modelo, arquivo, skill, perfil de usuário e as demais ações do Claude Managed Agents, são classificadas como eventos de Dados.

MétodoRotaAção do IAMTipo de evento do CloudTrail
POST/v1/messagesCreateInferenceDados
POST/v1/messages/count_tokensCountTokensDados
POST/v1/messages/batchesCreateBatchInferenceDados
GET/v1/messages/batchesListBatchInferencesDados
GET/v1/messages/batches/{id}GetBatchInferenceDados
GET/v1/messages/batches/{id}/resultsGetBatchInferenceDados
POST/v1/messages/batches/{id}/cancelCancelBatchInferenceDados
DELETE/v1/messages/batches/{id}DeleteBatchInferenceDados
GET/v1/modelsListModelsDados
GET/v1/models/{id}GetModelDados
POST/v1/filesCreateFileDados
GET/v1/filesListFilesDados
GET/v1/files/{id}GetFileDados
GET/v1/files/{id}/contentGetFileDados
DELETE/v1/files/{id}DeleteFileDados
POST/v1/skillsCreateSkillDados
GET/v1/skillsListSkillsDados
GET/v1/skills/{id}GetSkillDados
DELETE/v1/skills/{id}DeleteSkillDados
POST/v1/skills/{id}/versionsUpdateSkillDados
GET/v1/skills/{id}/versionsGetSkillDados
GET/v1/skills/{id}/versions/{version}GetSkillDados
GET/v1/skills/{id}/versions/{version}/contentGetSkillDados
DELETE/v1/skills/{id}/versions/{version}UpdateSkillDados
POST/v1/user_profilesCreateUserProfileDados
GET/v1/user_profilesListUserProfilesDados
GET/v1/user_profiles/{id}GetUserProfileDados
POST/v1/user_profiles/{id}UpdateUserProfileDados
POST/v1/organizations/workspacesCreateWorkspaceGerenciamento
GET/v1/organizations/workspacesListWorkspacesGerenciamento
GET/v1/organizations/workspaces/{id}GetWorkspaceGerenciamento
POST/v1/organizations/workspaces/{id}UpdateWorkspaceGerenciamento
POST/v1/organizations/workspaces/{id}/archiveArchiveWorkspaceGerenciamento
POST/v1/agentsCreateAgentDados
GET/v1/agentsListAgentsDados
GET/v1/agents/{id}GetAgentDados
POST/v1/agents/{id}UpdateAgentDados
POST/v1/agents/{id}/archiveArchiveAgentDados
GET/v1/agents/{id}/versionsGetAgentDados
POST/v1/sessionsCreateSessionDados
GET/v1/sessionsListSessionsDados
GET/v1/sessions/{id}GetSessionDados
POST/v1/sessions/{id}UpdateSessionDados
POST/v1/sessions/{id}/archiveArchiveSessionDados
DELETE/v1/sessions/{id}DeleteSessionDados
GET/v1/sessions/{id}/eventsGetSessionDados
POST/v1/sessions/{id}/eventsUpdateSessionDados
GET/v1/sessions/{id}/events/streamGetSessionDados
GET/v1/sessions/{id}/resourcesGetSessionDados
GET/v1/sessions/{id}/resources/{id}GetSessionDados
POST/v1/sessions/{id}/resourcesUpdateSessionDados
POST/v1/sessions/{id}/resources/{id}UpdateSessionDados
DELETE/v1/sessions/{id}/resources/{id}UpdateSessionDados
POST/v1/environmentsCreateEnvironmentDados
GET/v1/environmentsListEnvironmentsDados
GET/v1/environments/{id}GetEnvironmentDados
POST/v1/environments/{id}UpdateEnvironmentDados
POST/v1/environments/{id}/archiveArchiveEnvironmentDados
DELETE/v1/environments/{id}DeleteEnvironmentDados
GET/v1/environments/{id}/work/pollProcessEnvironmentWorkDados
GET/v1/environments/{id}/work/{work_id}GetEnvironmentDados
GET/v1/environments/{id}/work/statsGetEnvironmentDados
POST/v1/environments/{id}/work/{work_id}ProcessEnvironmentWorkDados
POST/v1/environments/{id}/work/{work_id}/ackProcessEnvironmentWorkDados
POST/v1/environments/{id}/work/{work_id}/heartbeatProcessEnvironmentWorkDados
POST/v1/environments/{id}/work/{work_id}/stopProcessEnvironmentWorkDados
POST/v1/vaultsCreateVaultGerenciamento
GET/v1/vaultsListVaultsGerenciamento
GET/v1/vaults/{id}GetVaultGerenciamento
POST/v1/vaults/{id}UpdateVaultGerenciamento
POST/v1/vaults/{id}/archiveArchiveVaultGerenciamento
DELETE/v1/vaults/{id}DeleteVaultGerenciamento
GET/v1/vaults/{id}/credentialsGetVaultGerenciamento
POST/v1/vaults/{id}/credentialsUpdateVaultGerenciamento
GET/v1/vaults/{id}/credentials/{id}GetVaultGerenciamento
POST/v1/vaults/{id}/credentials/{id}UpdateVaultGerenciamento
POST/v1/vaults/{id}/credentials/{id}/archiveUpdateVaultGerenciamento
DELETE/v1/vaults/{id}/credentials/{id}UpdateVaultGerenciamento
POST/v1/memory_storesCreateMemoryStoreDados
GET/v1/memory_storesListMemoryStoresDados
GET/v1/memory_stores/{id}GetMemoryStoreDados
POST/v1/memory_stores/{id}UpdateMemoryStoreDados
POST/v1/memory_stores/{id}/archiveArchiveMemoryStoreDados
DELETE/v1/memory_stores/{id}DeleteMemoryStoreDados
POST/v1/memory_stores/{id}/memoriesUpdateMemoryStoreDados
GET/v1/memory_stores/{id}/memoriesGetMemoryStoreDados
GET/v1/memory_stores/{id}/memories/{id}GetMemoryStoreDados
POST/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreDados
DELETE/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreDados
GET/v1/memory_stores/{id}/memory_versionsGetMemoryStoreDados
GET/v1/memory_stores/{id}/memory_versions/{id}GetMemoryStoreDados
POST/v1/memory_stores/{id}/memory_versions/{id}/redactUpdateMemoryStoreDados
GET/v1/webhooksListWebhooksGerenciamento
GET/v1/webhooks/{id}GetWebhookGerenciamento
POST/v1/webhooksCreateWebhookGerenciamento
POST/v1/webhooks/{id}UpdateWebhookGerenciamento
DELETE/v1/webhooks/{id}DeleteWebhookGerenciamento
POST/v1/webhooks/{id}/regenerate_signing_secretRotateWebhookSecretGerenciamento

Rotas que não estão nesta tabela não estão disponíveis no Claude Platform on AWS. O gateway nega por padrão qualquer rota não listada aqui.

As rotas de workspace são as únicas rotas da Admin API disponíveis no Claude Platform on AWS. A página Workspaces do Claude Console é somente leitura; use a Admin API ou o AWS Console para criar, atualizar ou arquivar workspaces.

Políticas gerenciadas

A AWS fornece cinco políticas gerenciadas para o Claude Platform on AWS. Todas as políticas gerenciadas se aplicam a Resource: "*".

PolíticaConcede
AnthropicFullAccessaws-external-anthropic:*
AnthropicReadOnlyAccessGet*, List*, CallWithBearerToken
AnthropicInferenceAccessGet*, List*, CreateInference, CreateBatchInference, CancelBatchInference, DeleteBatchInference, CountTokens, CallWithBearerToken
AnthropicLimitedAccessTodas as ações de AnthropicInferenceAccess, mais todas as ações do Claude Managed Agents (agentes, sessões, ambientes, vaults, memory stores, webhooks e trabalho de ambiente auto-hospedado)
AnthropicSelfHostedEnvironmentAccessGetEnvironment, ProcessEnvironmentWork, GetSession, UpdateSession, GetSkill, CallWithBearerToken

AnthropicInferenceAccess é a política gerenciada mais restrita suficiente para executar inferência. Ela cobre tanto inferência síncrona quanto em lote e, por meio dos curingas Get* e List*, concede acesso de leitura a todos os recursos da API no namespace, incluindo recursos do Claude Managed Agents (CMA) (agentes, sessões, ambientes, vaults, memory stores e webhooks). Isso inclui download de conteúdo de arquivo por meio de GetFile (consulte a nota em Arquivos), download de conteúdo de skill por meio de GetSkill (consulte a nota em Skills) e conteúdo de memórias por meio de GetMemoryStore. Segredos de credenciais de vault e segredos de assinatura de webhook não são expostos: esses campos são somente escrita e nunca são retornados por GetVault ou GetWebhook (consulte Autenticar com vaults). AnthropicInferenceAccess não concede criação ou exclusão de arquivos, gerenciamento de skills, gerenciamento de perfis de usuário, mutação de workspace ou qualquer ação de escrita do Claude Managed Agents (criar, atualizar, arquivar, excluir, processar ou rotacionar). Para excluir leituras de CMA, substitua AnthropicInferenceAccess por uma política personalizada que enumere apenas as ações específicas não-CMA de que você precisa.

AnthropicReadOnlyAccess, AnthropicInferenceAccess e AnthropicLimitedAccess carregam todas os curingas Get* e List*, que concedem acesso de leitura a todo o conteúdo no workspace: bytes de arquivo, conteúdo de skill, resultados de lote, histórico de conversa de sessão e conteúdo de memórias. Segredos de credenciais de vault e segredos de assinatura de webhook não são expostos; esses campos são somente escrita e nunca são retornados por GetVault ou GetWebhook. Se seu principal não deve ler conteúdo existente, use uma política personalizada que enumere apenas as ações de que você precisa.

AnthropicLimitedAccess inclui todas as ações do Claude Managed Agents além das ações de inferência.

AnthropicSelfHostedEnvironmentAccess é a política gerenciada mais restrita suficiente para executar um worker de sandbox auto-hospedado. Anexe-a ao principal com o qual seu worker de ambiente se autentica.

AssumeConsole não está incluída em AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess ou AnthropicSelfHostedEnvironmentAccess. Principals que precisam de acesso ao Claude Console requerem AnthropicFullAccess ou uma política personalizada que conceda aws-external-anthropic:AssumeConsole. Consulte Acesso ao console.

CreateInference e CreateBatchInference são ações separadas. Negar uma não bloqueia a outra. Se você pretende impedir todas as chamadas de modelo, negue ambas.

Exemplos de políticas

Inferência síncrona em um único workspace

Concede as permissões mínimas para um principal do IAM que executa inferência em um workspace de produção:

{
  "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 tem escopo de conta (consulte Automação de provisionamento). Se sua conta de serviço precisar enumerar workspaces, adicione uma instrução Allow separada para ListWorkspaces com Resource: "*".

Esta política pressupõe autenticação AWS SigV4. Se o principal se autenticar com uma chave de API, adicione uma instrução Allow separada para aws-external-anthropic:CallWithBearerToken com Resource: "*". CallWithBearerToken é uma ação sem rota que não se vincula a um ARN de workspace. Consulte Isolamento de workspace por cliente para o padrão de duas instruções.

Isolamento de workspace por cliente

Restringe uma função a um único 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": "*"
    }
  ]
}

O curinga aws-external-anthropic:* na primeira instrução inclui ações com escopo de conta (CreateWorkspace, ListWorkspaces) que a restrição de ARN de workspace filtra silenciosamente. Isso é consistente com a intenção de "isolamento" (a função não pode criar ou enumerar workspaces), mas a política contém permissões que não têm efeito. Consulte Automação de provisionamento para o padrão com escopo de conta.

CallWithBearerToken e AssumeConsole são ações sem rota que não se vinculam a um ARN de workspace. A segunda instrução as concede em Resource: "*" para que a função possa se autenticar com uma chave de API e abrir o Claude Console. Omita esta instrução se a função usar apenas SigV4 e não precisar de acesso ao Claude Console.

Bloqueio de recursos para um workspace sensível a ZDR

Bloqueia processamento em lote e upload de arquivos em um workspace específico, mantendo a inferência síncrona disponível. Útil quando um workspace lida com dados de Zero Data Retention (ZDR) que não devem persistir no lado do servidor. Anexe esta política junto com uma política Allow, como AnthropicInferenceAccess ou o exemplo de workspace único; por si só, uma política somente Deny não concede permissões:

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

Este deny bloqueia apenas a criação. Outras ações de arquivo e lote não são negadas, a menos que você as liste também. Para um bloqueio completo em que o workspace nunca deve conter arquivos ou lotes, negue também aws-external-anthropic:GetFile, aws-external-anthropic:ListFiles, aws-external-anthropic:DeleteFile, aws-external-anthropic:GetBatchInference, aws-external-anthropic:ListBatchInferences, aws-external-anthropic:CancelBatchInference e aws-external-anthropic:DeleteBatchInference.

Automação de provisionamento

A página Workspaces do Claude Console é somente leitura; use os endpoints de workspace da Admin API ou o AWS Console para criar, atualizar ou arquivar workspaces.

Concede a uma função de CI/CD as ações necessárias para criar e gerenciar workspaces, sem nenhuma permissão de inferência:

{
  "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 e ListWorkspaces são operações com escopo de conta. Especificar um ARN de workspace nessas ações não tem efeito; use Resource: "*".

Consulte também

  • Claude Platform on AWS para configuração, autenticação e visão geral da plataforma
  • Guia do usuário do AWS IAM para sintaxe de políticas do IAM e lógica de avaliação
  • Guia do usuário do AWS CloudTrail para configuração de log de auditoria

Was this page helpful?

  • Detalhes do serviço
  • Ações
  • Inferência
  • Processamento em lote
  • Modelos
  • Arquivos
  • Skills
  • Agentes
  • Sessões
  • Ambientes
  • Vaults
  • Memory stores
  • Webhooks
  • Perfis de usuário
  • Workspaces
  • Autenticação
  • Acesso ao console
  • Mapeamento de rota para ação
  • Políticas gerenciadas
  • Exemplos de políticas
  • Inferência síncrona em um único workspace
  • Isolamento de workspace por cliente
  • Bloqueio de recursos para um workspace sensível a ZDR
  • Automação de provisionamento
  • Consulte também