Come AgentCore funziona Amazon Bedrock con IAM

Prima di utilizzare IAM per gestire l'accesso a AgentCore, scopri con AgentCore quali funzionalità IAM è disponibile l'uso.

Per avere una visione di alto livello 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 relativi alle policy di autorizzazione JSON che puoi allegare a un'identità, ad esempio un utente IAM, un gruppo di utenti o un ruolo. 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 politiche sono documenti di policy JSON allegati 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 politiche basate sulle risorse per le risorse Agent Runtime e Gateway. Queste policy sono collegate direttamente alle tue risorse e definiscono quali responsabili possono eseguire azioni su di esse.

Per informazioni su come creare e gestire politiche basate sulle risorse per le risorse di Amazon Bedrock, consulta AgentCore le politiche Resource-based per Amazon Bedrock. 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 policy AWS JSON per specificare chi ha accesso a cosa. Cioè, quale preside 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 Actions Defined by 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 Identity-based policy per Amazon Bedrock. AgentCore

Risorse politiche per AgentCore

Supporta le risorse relative alle policy: sì

Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. Cioè, quale preside 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, usa 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 AgentCore nel Service Authorization Reference. Per sapere con quali azioni puoi specificare l'ARN di ogni risorsa, consulta Actions Defined by Amazon Bedrock. AgentCore

Per visualizzare esempi di politiche AgentCore basate sull'identità, consulta esempi di Identity-based policy per Amazon Bedrock. AgentCore

Chiavi relative alle condizioni delle politiche per AgentCore

Supporta le chiavi di condizione delle policy specifiche del servizio: sì

Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. Cioè, quale preside 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 equals o less than, per abbinare la condizione nella politica ai valori della richiesta. Per visualizzare tutte le chiavi di condizione AWS globali, consulta le chiavi di contesto delle condizioni AWS globali nella Guida per l'utente IAM.

Per visualizzare un elenco di chiavi di AgentCore condizione, consulta Condition Keys for Amazon Bedrock AgentCore nel Service Authorization Reference. Per sapere con quali azioni e risorse puoi utilizzare una chiave di condizione, consulta Actions Defined by Amazon Bedrock AgentCore.

Le seguenti chiavi di condizione sono particolarmente utili quando si lavora con Amazon Bedrock AgentCore:

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:

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. È possibile allegare tag a entità e 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 condition di una policy utilizzando i tasti aws:ResourceTag/key-nameaws:RequestTag/key-name, o aws:TagKeys condition.

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 l'accesso a breve termine alle AWS risorse e vengono create automaticamente quando si utilizza la federazione o si cambia ruolo. 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 che funzionano 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 inoltrato (FAS) utilizzano le autorizzazioni del principale che chiama un AWS servizio, in combinazione con il 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 Guida per l'utente IAM.

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 include un servizio Yes nella colonna del Service-linked ruolo. Scegli il collegamento Sì per visualizzare la documentazione relativa al ruolo collegato ai servizi per tale servizio.