Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Come AgentCore funziona Amazon Bedrock con IAM
Prima di utilizzare IAM per gestire l'accesso a AgentCore, scopri con AgentCore quali funzionalità IAM è possibile utilizzare.
| Funzionalità IAM | AgentCore supporto |
|---|---|
|
Sì |
|
|
Parziale |
|
|
Sì |
|
|
Sì |
|
|
Sì |
|
|
No |
|
|
Parziale |
|
|
Sì |
|
|
Sì |
|
|
Sì |
|
|
Sì |
Per avere una visione generale di come AgentCore e altri AWS servizi funzionano con la maggior parte delle funzionalità IAM, consulta AWS i servizi che funzionano con IAM nella IAM User Guide.
Identity-based politiche per AgentCore
Supporta le policy basate sull’identità: sì
Identity-based le policy sono documenti di policy sulle autorizzazioni JSON che puoi allegare a un'identità, ad esempio un utente, un gruppo di utenti o un ruolo IAM. Tali policy definiscono le operazioni che utenti e ruoli possono eseguire, su quali risorse e in quali condizioni. Per informazioni su come creare una policy basata su identità, consulta Definizione di autorizzazioni personalizzate IAM con policy gestite dal cliente nella Guida per l’utente di IAM.
Con le policy basate sull’identità di IAM, è possibile specificare quali operazioni e risorse sono consentite o respinte, nonché le condizioni in base alle quali le operazioni sono consentite o respinte. Per informazioni su tutti gli elementi utilizzabili in una policy JSON, consulta Guida di riferimento agli elementi delle policy JSON IAM nella Guida per l’utente IAM.
Identity-based esempi di policy per AgentCore
Per visualizzare esempi di politiche AgentCore basate sull'identità, consulta Esempi di Identity-based policy per Amazon Bedrock. AgentCore
Resource-based politiche all'interno AgentCore
Supporta le policy basate su risorse: parziale
Resource-based le policy sono documenti di policy JSON che alleghi a una risorsa. Esempi di policy basate sulle risorse sono le policy di attendibilità dei ruoli IAM e le policy di bucket Amazon S3. Nei servizi che supportano policy basate sulle risorse, gli amministratori dei servizi possono utilizzarli per controllare l’accesso a una risorsa specifica. Quando è collegata a una risorsa, una policy definisce le operazioni che un principale può eseguire su tale risorsa e a quali condizioni. In una policy basata sulle risorse è obbligatorio specificare un’entità principale. I principali possono includere account, utenti, ruoli, utenti federati o servizi. AWS
Per consentire l’accesso multi-account, è possibile specificare un intero account o entità IAM in un altro account come entità principale in una policy basata sulle risorse. Per ulteriori informazioni, consulta Accesso a risorse multi-account in IAM nella Guida per l’utente IAM.
Amazon Bedrock AgentCore supporta policy basate sulle risorse per le risorse Agent Runtime e Gateway. Queste politiche sono collegate direttamente alle tue risorse e definiscono quali principali possono eseguire azioni su di esse.
Per scoprire come creare e gestire politiche basate sulle risorse per le risorse di Amazon Bedrock, consulta Resource-based le politiche per Amazon Bedrock AgentCore . AgentCore
Resource-based esempi di policy all'interno AgentCore
Per visualizzare esempi di politiche AgentCore basate sulle risorse, consulta Casi d'uso ed esempi comuni.
Azioni politiche per AgentCore
Supporta le operazioni di policy: si
Gli amministratori possono utilizzare le politiche AWS JSON per specificare chi ha accesso a cosa. Ovvero, quale principale può eseguire azioni su quali risorse e in quali condizioni.
L’elemento Action di una policy JSON descrive le operazioni che è possibile utilizzare per consentire o negare l’accesso in una policy. Includere le operazioni in una policy per concedere le autorizzazioni di eseguire l’operazione associata.
Per visualizzare un elenco di AgentCore azioni, consulta Azioni definite da Amazon Bedrock AgentCore nel Service Authorization Reference.
Le azioni politiche AgentCore utilizzano il seguente prefisso prima dell'azione:
bedrock-agentcore
Per specificare più operazioni in una sola istruzione, occorre separarle con la virgola.
"Action": [ "bedrock-agentcore:action1", "bedrock-agentcore:action2" ]
Per visualizzare esempi di politiche AgentCore basate sull'identità, consulta Esempi di policy per Amazon Identity-based Bedrock. AgentCore
Risorse politiche per AgentCore
Supporta le risorse relative alle policy: sì
Gli amministratori possono utilizzare le politiche AWS JSON per specificare chi ha accesso a cosa. Ovvero, quale principale può eseguire azioni su quali risorse e in quali condizioni.
L’elemento JSON Resource della policy specifica l’oggetto o gli oggetti ai quali si applica l’operazione. Come best practice, specifica una risorsa utilizzando il suo nome della risorsa Amazon (ARN). Per le azioni che non supportano le autorizzazioni a livello di risorsa, utilizza un carattere jolly (*) per indicare che l'istruzione si applica a tutte le risorse.
"Resource": "*"
Per visualizzare un elenco dei tipi di AgentCore risorse e dei relativi ARN, consulta Resources Defined by Amazon Bedrock nel Service Authorization Reference. AgentCore Per sapere con quali azioni puoi specificare l'ARN di ciascuna risorsa, consulta Azioni definite da Amazon Bedrock. AgentCore
Per visualizzare esempi di politiche AgentCore basate sull'identità, consulta Identity-based Esempi di policy per Amazon Bedrock. AgentCore
Chiavi relative alle condizioni delle policy per AgentCore
Supporta le chiavi di condizione delle policy specifiche del servizio: sì
Gli amministratori possono utilizzare le politiche AWS JSON per specificare chi ha accesso a cosa. Ovvero, quale principale può eseguire azioni su quali risorse e in quali condizioni.
L’elemento Condition specifica quando le istruzioni vengono eseguite in base a criteri definiti. È possibile creare espressioni condizionali che utilizzano operatori di condizione, ad esempio uguale o minore di, per far corrispondere la condizione nella policy ai valori nella richiesta. Per visualizzare tutte le chiavi di condizione AWS globali, consulta le chiavi di contesto di condizione AWS globali nella Guida per l'utente IAM.
Per visualizzare un elenco di chiavi di AgentCore condizione, consulta Chiavi di condizione per Amazon Bedrock AgentCore nel Service Authorization Reference. Per sapere con quali azioni e risorse puoi utilizzare una chiave di condizione, consulta Azioni definite da Amazon AgentCore Bedrock.
Le seguenti chiavi di condizione sono particolarmente utili quando si lavora con Amazon AgentCore Bedrock:
-
bedrock-agentcore:InboundJwtClaim/iss- Puoi utilizzare questa chiave di condizione per limitare l'accesso alle API che accettano un JWT che rappresenta un utente finale e che funzioni con valori di claim specifici dell'emittente (iss) presenti nel JWT passato nella richiesta. È possibile applicare questa chiave di condizione alle operazioni and.GetWorkloadAccessTokenForJwtCompleteResourceTokenAuth -
bedrock-agentcore:InboundJwtClaim/sub- È possibile utilizzare questa chiave di condizione per limitare l'accesso alle API che accettano un JWT per funzionare con specifici valori di oggetto (sub) claim presenti nel JWT passato nella richiesta. È possibile applicare questa chiave di condizione alle operazioni and.GetWorkloadAccessTokenForJwtCompleteResourceTokenAuth -
bedrock-agentcore:InboundJwtClaim/aud- È possibile utilizzare questa chiave di condizione per limitare l'accesso alle API che accettano un JWT per funzionare con valori di attestazione di pubblico specifico (aud) presenti nel JWT passato nella richiesta. È possibile applicare questa chiave di condizione alle operazioni and.GetWorkloadAccessTokenForJwtCompleteResourceTokenAuth -
bedrock-agentcore:userid- È possibile utilizzare questa chiave di condizione per limitare l'accesso alle API che accettano un ID utente statico in modo che funzionino solo con i valori dell'ID utente definiti nella dichiarazione della politica. È possibile applicare questa chiave di condizione alleCompleteResourceTokenAuthoperazioniGetWorkloadAccessTokenForUserIdand. -
bedrock-agentcore:InboundJwtClaim/scope- È possibile utilizzare questa chiave di condizione per limitare l'accesso in base alla dichiarazione di ambito nel JWT trasmessa nella richiesta. -
bedrock-agentcore:InboundJwtClaim/client_id- È possibile utilizzare questa chiave di condizione per limitare l'accesso alle API che accettano un JWT per funzionare con valori di attestazione specifici presenti nel JWT passato nellaclient_idrichiesta. Questa chiave è disponibile solo quando il JWT presenta esattamente ilclient_idclaim e non è disponibile quando le informazioni vengono comunicate in altri claim simili. È possibile applicare questa chiave condizionale alleCompleteResourceTokenAuthoperazioniGetWorkloadAccessTokenForJwtand.
Per visualizzare esempi di politiche AgentCore basate sull'identità, consulta Esempi di Identity-based policy per Amazon Bedrock. AgentCore
Per informazioni dettagliate sulle chiavi di condizione per AgentCore funzionalità specifiche, consulta i seguenti argomenti:
-
Usa le chiavi di condizione IAM con Amazon Bedrock AgentCore Gateway: chiavi di condizione per le operazioni
CreateGatewayUpdateGatewayCreateGatewayTarget,, eUpdateGatewayTargetAPI. -
Usa le chiavi di condizione IAM con le impostazioni AgentCore VPC: chiavi di VPC-related condizione per il AgentCore runtime, strumenti integrati e destinazioni del gateway.
ACL in AgentCore
Supporta le ACL: no
Le liste di controllo degli accessi (ACL) controllano quali principali (membri, utenti o ruoli dell’account) hanno le autorizzazioni per accedere a una risorsa. Le ACL sono simili alle policy basate su risorse, sebbene non utilizzino il formato del documento di policy JSON.
ABAC con AgentCore
Supporta ABAC (tag nelle policy): parzialmente
Attribute-based il controllo degli accessi (ABAC) è una strategia di autorizzazione che definisce le autorizzazioni in base ad attributi chiamati tag. Puoi allegare tag alle entità e alle AWS risorse IAM, quindi progettare politiche ABAC per consentire le operazioni quando il tag del principale corrisponde al tag sulla risorsa.
Per controllare l'accesso in base ai tag, fornisci le informazioni sui tag nell'elemento condizione di una policy utilizzando i tastiaws:ResourceTag/key-name,aws:RequestTag/key-name, o di aws:TagKeys condizione.
Se un servizio supporta tutte e tre le chiavi di condizione per ogni tipo di risorsa, il valore per il servizio è Sì. Se un servizio supporta tutte e tre le chiavi di condizione solo per alcuni tipi di risorsa, allora il valore sarà Parziale.
Per maggiori informazioni su ABAC, consulta Definizione delle autorizzazioni con autorizzazione ABAC nella Guida per l’utente di IAM. Per visualizzare un tutorial con i passaggi per l’impostazione di ABAC, consulta Utilizzo del controllo degli accessi basato su attributi (ABAC) nella Guida per l’utente di IAM.
Utilizzo di credenziali temporanee con AgentCore
Supporta le credenziali temporanee: sì
Le credenziali temporanee forniscono un accesso a breve termine alle AWS risorse e vengono create automaticamente quando si utilizzano ruoli federativi o di scambio. AWS consiglia di generare dinamicamente credenziali temporanee anziché utilizzare chiavi di accesso a lungo termine. Per ulteriori informazioni, consulta Credenziali di sicurezza temporanee in IAM e AWS servizi compatibili con IAM nella IAM User Guide.
Cross-service autorizzazioni principali per AgentCore
Supporta l’inoltro delle sessioni di accesso (FAS): sì
Le sessioni di accesso diretto (FAS) utilizzano le autorizzazioni della chiamata e del servizio principale, combinate con il AWS servizio richiedente per effettuare richieste ai AWS servizi a valle. Per i dettagli delle policy relative alle richieste FAS, consulta Forward access sessions.
Ruoli di servizio per AgentCore
Supporta i ruoli di servizio: sì
Un ruolo di servizio è un ruolo IAM che un servizio assume per eseguire operazioni per tuo conto. Un amministratore IAM può creare, modificare ed eliminare un ruolo di servizio dall’interno di IAM. Per ulteriori informazioni, consulta Creare un ruolo per delegare le autorizzazioni a un AWS servizio nella IAM User Guide.
avvertimento
La modifica delle autorizzazioni per un ruolo di servizio potrebbe interrompere la funzionalità. AgentCore Modifica i ruoli di servizio solo quando AgentCore fornisce indicazioni in tal senso.
Service-linked ruoli per AgentCore
Supporta i ruoli collegati ai servizi: Sì
Un ruolo collegato al servizio è un tipo di ruolo di servizio collegato a un AWS servizio. Il servizio può assumere il ruolo di eseguire un'azione per conto dell'utente. Service-linked i ruoli vengono visualizzati nel tuo AWS account e sono di proprietà del servizio. Un amministratore IAM può visualizzare le autorizzazioni per i ruoli collegati al servizio, ma non modificarle.
Per ulteriori informazioni su come creare e gestire i ruoli collegati ai servizi, consulta Servizi AWS supportati da IAM. Trova un servizio nella tabella che includa una Yes colonna del Service-linked ruolo. Scegli il collegamento Sì per visualizzare la documentazione relativa al ruolo collegato ai servizi per tale servizio.