Azioni IAM per Claude Platform on AWS
Riferimento delle azioni IAM per controllare l'accesso a Claude Platform on AWS tramite le policy AWS.
Claude Platform on AWS utilizza AWS IAM per il controllo degli accessi. Ogni route API corrisponde a un'azione IAM nel namespace aws-external-anthropic. Questa pagina elenca tutte le azioni, le route che ciascuna azione autorizza e le "managed policies" (policy gestite) disponibili per i pattern di accesso più comuni. Per la configurazione della piattaforma e l'autenticazione, consulta Claude Platform on AWS.
Dettagli del servizio
| Attributo | Valore |
|---|---|
| Prefisso del servizio IAM | aws-external-anthropic |
| Tipi di risorsa | workspace |
Formato ARN del workspace:
arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}La regione dell'ARN è sempre popolata e corrisponde alla regione a cui il workspace è associato. Il segmento della risorsa è l'ID del workspace con tag (wrkspc_...), lo stesso valore che passi nell'header anthropic-workspace-id.
Azioni
Il servizio definisce 71 azioni. Le azioni seguono la convenzione AWS VerbNoun e usano una disciplina dei verbi tale che i wildcard Get* e List* producano un confine di sola lettura pulito.
Inferenza
| Azione | Route autorizzate |
|---|---|
CreateInference | POST /v1/messages |
CountTokens | POST /v1/messages/count_tokens |
Elaborazione batch
| Azione | Route autorizzate |
|---|---|
CreateBatchInference | POST /v1/messages/batches |
GetBatchInference | GET /v1/messages/batches/{id}GET /v1/messages/batches/{id}/results |
ListBatchInferences | GET /v1/messages/batches |
CancelBatchInference | POST /v1/messages/batches/{id}/cancel |
DeleteBatchInference | DELETE /v1/messages/batches/{id} |
Modelli
| Azione | Route autorizzate |
|---|---|
GetModel | GET /v1/models/{id} |
ListModels | GET /v1/models |
File
| Azione | Route autorizzate |
|---|---|
CreateFile | POST /v1/files |
GetFile | GET /v1/files/{id}GET /v1/files/{id}/content |
ListFiles | GET /v1/files |
DeleteFile | DELETE /v1/files/{id} |
Skill
| Azione | Route autorizzate |
|---|---|
CreateSkill | POST /v1/skills |
GetSkill | GET /v1/skills/{id}GET /v1/skills/{id}/versionsGET /v1/skills/{id}/versions/{version}GET /v1/skills/{id}/versions/{version}/content |
ListSkills | GET /v1/skills |
UpdateSkill | POST /v1/skills/{id}/versionsDELETE /v1/skills/{id}/versions/{version} |
DeleteSkill | DELETE /v1/skills/{id} |
Agenti
| Azione | Route autorizzate |
|---|---|
CreateAgent | POST /v1/agents |
GetAgent | GET /v1/agents/{id}GET /v1/agents/{id}/versions |
ListAgents | GET /v1/agents |
UpdateAgent | POST /v1/agents/{id} |
ArchiveAgent | POST /v1/agents/{id}/archive |
Sessioni
| Azione | Route autorizzate |
|---|---|
CreateSession | POST /v1/sessions |
GetSession | GET /v1/sessions/{id}GET /v1/sessions/{id}/eventsGET /v1/sessions/{id}/events/streamGET /v1/sessions/{id}/resourcesGET /v1/sessions/{id}/resources/{id} |
ListSessions | GET /v1/sessions |
UpdateSession | POST /v1/sessions/{id}POST /v1/sessions/{id}/eventsPOST /v1/sessions/{id}/resourcesPOST /v1/sessions/{id}/resources/{id}DELETE /v1/sessions/{id}/resources/{id} |
ArchiveSession | POST /v1/sessions/{id}/archive |
DeleteSession | DELETE /v1/sessions/{id} |
Ambienti
| Azione | Route autorizzate |
|---|---|
CreateEnvironment | POST /v1/environments |
GetEnvironment | GET /v1/environments/{id}GET /v1/environments/{id}/workGET /v1/environments/{id}/work/{work_id}GET /v1/environments/{id}/work/stats |
ListEnvironments | GET /v1/environments |
UpdateEnvironment | POST /v1/environments/{id} |
ArchiveEnvironment | POST /v1/environments/{id}/archive |
DeleteEnvironment | DELETE /v1/environments/{id} |
ProcessEnvironmentWork | GET /v1/environments/{id}/work/pollPOST /v1/environments/{id}/work/{work_id}POST /v1/environments/{id}/work/{work_id}/ackPOST /v1/environments/{id}/work/{work_id}/heartbeatPOST /v1/environments/{id}/work/{work_id}/stop |
Vault
| Azione | Route autorizzate |
|---|---|
CreateVault | POST /v1/vaults |
GetVault | GET /v1/vaults/{id}GET /v1/vaults/{id}/credentialsGET /v1/vaults/{id}/credentials/{id} |
ListVaults | GET /v1/vaults |
UpdateVault | POST /v1/vaults/{id}POST /v1/vaults/{id}/credentialsPOST /v1/vaults/{id}/credentials/{id}POST /v1/vaults/{id}/credentials/{id}/archiveDELETE /v1/vaults/{id}/credentials/{id} |
ArchiveVault | POST /v1/vaults/{id}/archive |
DeleteVault | DELETE /v1/vaults/{id} |
Memory store
| Azione | Route autorizzate |
|---|---|
CreateMemoryStore | POST /v1/memory_stores |
GetMemoryStore | GET /v1/memory_stores/{id}GET /v1/memory_stores/{id}/memoriesGET /v1/memory_stores/{id}/memories/{id}GET /v1/memory_stores/{id}/memory_versionsGET /v1/memory_stores/{id}/memory_versions/{id} |
ListMemoryStores | GET /v1/memory_stores |
UpdateMemoryStore | POST /v1/memory_stores/{id}POST /v1/memory_stores/{id}/memoriesPOST /v1/memory_stores/{id}/memories/{id}DELETE /v1/memory_stores/{id}/memories/{id}POST /v1/memory_stores/{id}/memory_versions/{id}/redact |
ArchiveMemoryStore | POST /v1/memory_stores/{id}/archive |
DeleteMemoryStore | DELETE /v1/memory_stores/{id} |
Webhook
| Azione | Route autorizzate |
|---|---|
CreateWebhook | POST /v1/webhooks |
GetWebhook | GET /v1/webhooks/{id} |
ListWebhooks | GET /v1/webhooks |
UpdateWebhook | POST /v1/webhooks/{id} |
DeleteWebhook | DELETE /v1/webhooks/{id} |
RotateWebhookSecret | POST /v1/webhooks/{id}/regenerate_signing_secret |
Profili utente
| Azione | Route autorizzate |
|---|---|
CreateUserProfile | POST /v1/user_profiles |
GetUserProfile | GET /v1/user_profiles/{id} |
ListUserProfiles | GET /v1/user_profiles |
UpdateUserProfile | POST /v1/user_profiles/{id} |
Workspace
| Azione | Route autorizzate |
|---|---|
CreateWorkspace | POST /v1/organizations/workspaces |
GetWorkspace | GET /v1/organizations/workspaces/{id} |
ListWorkspaces | GET /v1/organizations/workspaces |
UpdateWorkspace | POST /v1/organizations/workspaces/{id} |
ArchiveWorkspace | POST /v1/organizations/workspaces/{id}/archive |
Chiavi di crittografia
| Azione | Route autorizzate |
|---|---|
RegisterKey | POST /v1/organizations/external_keys |
GetKey | GET /v1/organizations/external_keys/{id} |
ListKeys | GET /v1/organizations/external_keys |
UpdateKey | POST /v1/organizations/external_keys/{id} |
DisableKey | DELETE /v1/organizations/external_keys/{id} |
Conformità
| Azione | Route autorizzate |
|---|---|
ListComplianceActivities | GET /v1/compliance/activities |
Autenticazione
| Azione | Route autorizzate |
|---|---|
CallWithBearerToken | (nessuna) |
CallWithBearerToken è un permesso a livello di autenticazione che autorizza un principal ad autenticarsi tramite una chiave API (bearer token) anziché tramite AWS SigV4. Non corrisponde a una route. Concedilo insieme alle azioni mappate su route che vuoi che il titolare della chiave API possa eseguire.
Accesso alla Console
| Azione | Route autorizzate |
|---|---|
AssumeConsole | (nessuna) |
AssumeConsole autorizza un principal ad aprire la Claude Console per un workspace di Claude Platform on AWS tramite il flusso di federazione della AWS Console. Non corrisponde a una route. Concedila ai principal che devono poter fare clic su Open Claude Console nella pagina del servizio Claude Platform on AWS nella AWS Console. Il ruolo nella Claude Console (Admin o Developer) viene assegnato separatamente dal tuo referente Anthropic; non deriva dai permessi IAM del principal. Consulta Utilizzo della Claude Console per il flusso di accesso e le descrizioni dei ruoli.
Mappatura route-azione
La tabella seguente elenca ogni route di Claude Platform on AWS e l'azione IAM richiesta per chiamarla. Ogni azione IAM autorizza anche le richieste che usano l'header anthropic-beta; le varianti beta di una route non richiedono un'azione IAM separata. CloudTrail classifica ogni azione come evento Data (operazioni del data plane ad alto volume) o come evento Management (operazioni del control plane). Le azioni su vault e webhook sono classificate come eventi Management perché contengono segreti (credenziali dei vault e segreti di firma dei webhook) e beneficiano del logging di audit attivo per impostazione predefinita. Anche le azioni su workspace, chiavi esterne e conformità sono classificate come eventi Management perché sono operazioni del control plane con ambito a livello di organizzazione. Tutte le altre azioni, incluse inferenza, batch, modelli, file, skill, profili utente e le restanti azioni di Claude Managed Agents, sono classificate come eventi Data.
| Metodo | Route | Azione IAM | Tipo di evento CloudTrail |
|---|---|---|---|
POST | /v1/messages | CreateInference | Data |
POST | /v1/messages/count_tokens | CountTokens | Data |
POST | /v1/messages/batches | CreateBatchInference | Data |
GET | /v1/messages/batches | ListBatchInferences | Data |
GET | /v1/messages/batches/{id} | GetBatchInference | Data |
GET | /v1/messages/batches/{id}/results | GetBatchInference | Data |
POST | /v1/messages/batches/{id}/cancel | CancelBatchInference | Data |
DELETE | /v1/messages/batches/{id} | DeleteBatchInference | Data |
GET | /v1/models | ListModels | Data |
GET | /v1/models/{id} | GetModel | Data |
POST | /v1/files | CreateFile | Data |
GET | /v1/files | ListFiles | Data |
GET | /v1/files/{id} | GetFile | Data |
GET | /v1/files/{id}/content | GetFile | Data |
DELETE | /v1/files/{id} | DeleteFile | Data |
POST | /v1/skills | CreateSkill | Data |
GET | /v1/skills | ListSkills | Data |
GET | /v1/skills/{id} | GetSkill | Data |
DELETE | /v1/skills/{id} | DeleteSkill | Data |
POST | /v1/skills/{id}/versions | UpdateSkill | Data |
GET | /v1/skills/{id}/versions | GetSkill | Data |
GET | /v1/skills/{id}/versions/{version} | GetSkill | Data |
GET | /v1/skills/{id}/versions/{version}/content | GetSkill | Data |
DELETE | /v1/skills/{id}/versions/{version} | UpdateSkill | Data |
POST | /v1/user_profiles | CreateUserProfile | Data |
GET | /v1/user_profiles | ListUserProfiles | Data |
GET | /v1/user_profiles/{id} | GetUserProfile | Data |
POST | /v1/user_profiles/{id} | UpdateUserProfile | Data |
POST | /v1/organizations/workspaces | CreateWorkspace | Management |
GET | /v1/organizations/workspaces | ListWorkspaces | Management |
GET | /v1/organizations/workspaces/{id} | GetWorkspace | Management |
POST | /v1/organizations/workspaces/{id} | UpdateWorkspace | Management |
POST | /v1/organizations/workspaces/{id}/archive | ArchiveWorkspace | Management |
POST | /v1/organizations/external_keys | RegisterKey | Management |
GET | /v1/organizations/external_keys | ListKeys | Management |
GET | /v1/organizations/external_keys/{id} | GetKey | Management |
POST | /v1/organizations/external_keys/{id} | UpdateKey | Management |
DELETE | /v1/organizations/external_keys/{id} | DisableKey | Management |
GET | /v1/compliance/activities | ListComplianceActivities | Management |
POST | /v1/agents | CreateAgent | Data |
GET | /v1/agents | ListAgents | Data |
GET | /v1/agents/{id} | GetAgent | Data |
POST | /v1/agents/{id} | UpdateAgent | Data |
POST | /v1/agents/{id}/archive | ArchiveAgent | Data |
GET | /v1/agents/{id}/versions | GetAgent | Data |
POST | /v1/sessions | CreateSession | Data |
GET | /v1/sessions | ListSessions | Data |
GET | /v1/sessions/{id} | GetSession | Data |
POST | /v1/sessions/{id} | UpdateSession | Data |
POST | /v1/sessions/{id}/archive | ArchiveSession | Data |
DELETE | /v1/sessions/{id} | DeleteSession | Data |
GET | /v1/sessions/{id}/events | GetSession | Data |
POST | /v1/sessions/{id}/events | UpdateSession | Data |
GET | /v1/sessions/{id}/events/stream | GetSession | Data |
GET | /v1/sessions/{id}/resources | GetSession | Data |
GET | /v1/sessions/{id}/resources/{id} | GetSession | Data |
POST | /v1/sessions/{id}/resources | UpdateSession | Data |
POST | /v1/sessions/{id}/resources/{id} | UpdateSession | Data |
DELETE | /v1/sessions/{id}/resources/{id} | UpdateSession | Data |
POST | /v1/environments | CreateEnvironment | Data |
GET | /v1/environments | ListEnvironments | Data |
GET | /v1/environments/{id} | GetEnvironment | Data |
POST | /v1/environments/{id} | UpdateEnvironment | Data |
POST | /v1/environments/{id}/archive | ArchiveEnvironment | Data |
DELETE | /v1/environments/{id} | DeleteEnvironment | Data |
GET | /v1/environments/{id}/work | GetEnvironment | Data |
GET | /v1/environments/{id}/work/poll | ProcessEnvironmentWork | Data |
GET | /v1/environments/{id}/work/{work_id} | GetEnvironment | Data |
GET | /v1/environments/{id}/work/stats | GetEnvironment | Data |
POST | /v1/environments/{id}/work/{work_id} | ProcessEnvironmentWork | Data |
POST | /v1/environments/{id}/work/{work_id}/ack | ProcessEnvironmentWork | Data |
POST | /v1/environments/{id}/work/{work_id}/heartbeat | ProcessEnvironmentWork | Data |
POST | /v1/environments/{id}/work/{work_id}/stop | ProcessEnvironmentWork | Data |
POST | /v1/vaults | CreateVault | Management |
GET | /v1/vaults | ListVaults | Management |
GET | /v1/vaults/{id} | GetVault | Management |
POST | /v1/vaults/{id} | UpdateVault | Management |
POST | /v1/vaults/{id}/archive | ArchiveVault | Management |
DELETE | /v1/vaults/{id} | DeleteVault | Management |
GET | /v1/vaults/{id}/credentials | GetVault | Management |
POST | /v1/vaults/{id}/credentials | UpdateVault | Management |
GET | /v1/vaults/{id}/credentials/{id} | GetVault | Management |
POST | /v1/vaults/{id}/credentials/{id} | UpdateVault | Management |
POST | /v1/vaults/{id}/credentials/{id}/archive | UpdateVault | Management |
DELETE | /v1/vaults/{id}/credentials/{id} | UpdateVault | Management |
POST | /v1/memory_stores | CreateMemoryStore | Data |
GET | /v1/memory_stores | ListMemoryStores | Data |
GET | /v1/memory_stores/{id} | GetMemoryStore | Data |
POST | /v1/memory_stores/{id} | UpdateMemoryStore | Data |
POST | /v1/memory_stores/{id}/archive | ArchiveMemoryStore | Data |
DELETE | /v1/memory_stores/{id} | DeleteMemoryStore | Data |
POST | /v1/memory_stores/{id}/memories | UpdateMemoryStore | Data |
GET | /v1/memory_stores/{id}/memories | GetMemoryStore | Data |
GET | /v1/memory_stores/{id}/memories/{id} | GetMemoryStore | Data |
POST | /v1/memory_stores/{id}/memories/{id} | UpdateMemoryStore | Data |
DELETE | /v1/memory_stores/{id}/memories/{id} | UpdateMemoryStore | Data |
GET | /v1/memory_stores/{id}/memory_versions | GetMemoryStore | Data |
GET | /v1/memory_stores/{id}/memory_versions/{id} | GetMemoryStore | Data |
POST | /v1/memory_stores/{id}/memory_versions/{id}/redact | UpdateMemoryStore | Data |
GET | /v1/webhooks | ListWebhooks | Management |
GET | /v1/webhooks/{id} | GetWebhook | Management |
POST | /v1/webhooks | CreateWebhook | Management |
POST | /v1/webhooks/{id} | UpdateWebhook | Management |
DELETE | /v1/webhooks/{id} | DeleteWebhook | Management |
POST | /v1/webhooks/{id}/regenerate_signing_secret | RotateWebhookSecret | Management |
Le route non presenti in questa tabella non sono disponibili su Claude Platform on AWS. Il gateway nega per impostazione predefinita qualsiasi route non elencata qui.
Policy gestite
AWS fornisce cinque policy gestite per Claude Platform on AWS. Tutte le policy gestite si applicano a Resource: "*".
| Policy | Concede |
|---|---|
AnthropicFullAccess | aws-external-anthropic:* |
AnthropicReadOnlyAccess | Get*, List*, CallWithBearerToken |
AnthropicInferenceAccess | Get*, List*, CreateInference, CreateBatchInference, CancelBatchInference, DeleteBatchInference, CountTokens, CallWithBearerToken |
AnthropicLimitedAccess | Tutte le azioni di AnthropicInferenceAccess, più tutte le azioni di Claude Managed Agents (agenti, sessioni, ambienti, vault, memory store, webhook e lavoro degli ambienti self-hosted) |
AnthropicSelfHostedEnvironmentAccess | GetEnvironment, ProcessEnvironmentWork, GetSession, UpdateSession, GetSkill, CallWithBearerToken |
AnthropicInferenceAccess è la policy gestita più ristretta sufficiente per eseguire l'inferenza. Copre sia l'inferenza sincrona sia quella batch e, tramite i wildcard Get* e List*, concede l'accesso in lettura a ogni risorsa API nel namespace, incluse le risorse di Claude Managed Agents (CMA) (agenti, sessioni, ambienti, vault, memory store e webhook). Questo include il download del contenuto dei file tramite GetFile (consulta la nota File), il download del contenuto delle skill tramite GetSkill (consulta la nota Skill) e il contenuto delle memorie tramite GetMemoryStore. I segreti delle credenziali dei vault e i segreti di firma dei webhook non vengono esposti: quei campi sono di sola scrittura e non vengono mai restituiti da GetVault o GetWebhook (consulta Autenticazione con i vault). AnthropicInferenceAccess non concede la creazione o l'eliminazione di file, la gestione delle skill, la gestione dei profili utente, la modifica dei workspace, la gestione delle chiavi di crittografia né alcuna azione di scrittura di Claude Managed Agents (create, update, archive, delete, process o rotate). Per escludere le letture CMA, sostituisci AnthropicInferenceAccess con una policy personalizzata che elenchi solo le specifiche azioni non CMA di cui hai bisogno.
AnthropicLimitedAccess include tutte le azioni di Claude Managed Agents oltre alle azioni di inferenza.
AnthropicSelfHostedEnvironmentAccess è la policy gestita più ristretta sufficiente per eseguire un worker di sandbox self-hosted. Associala al principal con cui si autentica il worker del tuo ambiente.
AssumeConsole non è inclusa in AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess o AnthropicSelfHostedEnvironmentAccess. I principal che necessitano dell'accesso alla Claude Console richiedono AnthropicFullAccess oppure una policy personalizzata che conceda aws-external-anthropic:AssumeConsole. Consulta Accesso alla Console.
Policy di esempio
Inferenza sincrona su un singolo workspace
Concede i permessi minimi per un principal IAM che esegue l'inferenza su un workspace di produzione:
{
"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"
}
]
}Isolamento del workspace per cliente
Limita un ruolo a un singolo 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": "*"
}
]
}Blocco delle funzionalità per un workspace sensibile a ZDR
Blocca l'elaborazione batch e il caricamento di file su un workspace specifico lasciando disponibile l'inferenza sincrona. Utile quando un workspace gestisce dati "Zero Data Retention" (conservazione zero dei dati), o ZDR, che non devono persistere lato server. Associa questa policy insieme a una policy Allow come AnthropicInferenceAccess o l'esempio a singolo workspace; da sola, una policy di solo Deny non concede alcun permesso:
{
"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"
}
]
}Automazione del provisioning
Concede a un ruolo CI/CD le azioni necessarie per creare e gestire i workspace, senza alcun permesso di inferenza:
{
"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 sono operazioni con ambito a livello di account. Specificare un ARN di workspace su queste azioni non ha alcun effetto; usa Resource: "*".
Vedi anche
- Claude Platform on AWS per la configurazione, l'autenticazione e la panoramica della piattaforma
- AWS IAM User Guide per la sintassi delle policy IAM e la logica di valutazione
- AWS CloudTrail User Guide per la configurazione della registrazione di audit
Was this page helpful?