Considerazioni per AgentCore Crea un endpoint di interfaccia per AgentCore Creazione di una policy dell' endpoint per l'endpoint dell'interfaccia

Usa gli endpoint VPC dell'interfaccia (AWS PrivateLink) per creare una connessione privata tra il tuo VPC e le tue risorse Amazon Bedrock AgentCore

Puoi utilizzarlo AWS PrivateLink per creare una connessione privata tra il tuo VPC e Amazon AgentCore Bedrock. Puoi accedere AgentCore come se fosse nel tuo VPC, senza l'uso di un gateway Internet, un dispositivo NAT, una connessione VPN o una connessione Direct Connect. Le istanze del tuo VPC non necessitano di indirizzi IP pubblici per l'accesso. AgentCore

Stabilisci questa connessione privata creando un endpoint di interfaccia, fornito da. AWS PrivateLink In ciascuna sottorete viene creata un'interfaccia di rete endpoint da abilitare per l'endpoint di interfaccia. Queste sono interfacce di rete gestite dal richiedente che fungono da punto di ingresso per il traffico destinato a AgentCore.

Per ulteriori informazioni, consulta Accedere ai AWS servizi tramite AWS PrivateLink nella AWS PrivateLink Guida.

Considerazioni per AgentCore

Prima di configurare un endpoint di interfaccia per AgentCore, consulta le Considerazioni contenute nella Guida. AWS PrivateLink

AgentCore fornisce tre endpoint: AWS PrivateLink

Endpoint del piano dati - com.amazonaws.region.bedrock-agentcore
Punto finale del piano di controllo - com.amazonaws.region.bedrock-agentcore-control
Endpoint del gateway - com.amazonaws.region.bedrock-agentcore.gateway

La tabella seguente mostra lo stato del AWS PrivateLink supporto per ciascuna AgentCore primitiva:

Primitiva	Piano dati	Piano di controllo
Runtime	Supportata	Supportata
Memoria	Supportata	Supportata
Built-in Strumenti (interprete di codice, strumento browser)	Supportata	Supportata
Identità	Supportata	Supportata
Gateway	Supportata	Supportata
Valutazioni e ottimizzazioni	Supportata	Supportata
Policy	Supportata	Supportata

Per un elenco delle AWS regioni in cui sono disponibili gli endpoint di AgentCore interfaccia, vedi Regioni supportate. AWS

Importante

Le API del piano dati supportano sia le intestazioni AWS Signature Version 4 (Sigv4) per l'autenticazione sia l'autenticazione Bearer Token (OAuth). Le policy degli endpoint VPC possono limitare i chiamanti solo in base ai principali IAM e non agli utenti OAuth. Affinché OAuth-based le richieste abbiano esito positivo tramite l'endpoint VPC, l'entità principale deve essere impostata su * nella policy dell'endpoint. Altrimenti, solo i chiamanti autorizzati da SIGv4 possono effettuare chiamate riuscite sull'endpoint VPC.

AWS Le chiavi di contesto delle condizioni globali IAM sono supportate. Per impostazione predefinita, l'accesso completo a AgentCore è consentito tramite l'endpoint dell'interfaccia. È possibile controllare l'accesso allegando una policy dell'endpoint all'endpoint dell'interfaccia o associando un gruppo di sicurezza alle interfacce di rete dell'endpoint.

Crea un endpoint di interfaccia per AgentCore

Puoi creare un endpoint di interfaccia per AgentCore utilizzare la console Amazon VPC o l'interfaccia a riga di AWS comando (AWS CLI). Per ulteriori informazioni, consulta Create an interface endpoint nella Guida. AWS PrivateLink

Crea un endpoint di interfaccia per AgentCore utilizzare il seguente formato del nome del servizio:

Tutte le primitive del piano dati (Runtime, Built-in Tools, Memory, Identity): com.amazonaws.region.bedrock-agentcore
Per AgentCore Gateway: com.amazonaws.region.bedrock-agentcore.gateway
Per le operazioni sul piano di controllo (gestione del runtime e della memoria): com.amazonaws.region.bedrock-agentcore-control

Se abiliti il DNS privato per l'endpoint dell'interfaccia, puoi effettuare richieste API AgentCore utilizzando il nome DNS regionale predefinito. Ad esempio, bedrock-agentcore.us-east-1.amazonaws.com. Per Gateway in particolare, sarà simile a:. *.gateway.bedrock-agentcore.us-east-1.amazonaws.com

Creazione di una policy dell' endpoint per l'endpoint dell'interfaccia

Una policy dell’endpoint è una risorsa IAM che è possibile allegare all’endpoint dell’interfaccia. La politica predefinita degli endpoint consente l'accesso completo AgentCore tramite l'endpoint dell'interfaccia. Per controllare l'accesso consentito AgentCore dal tuo VPC, allega una policy endpoint personalizzata all'endpoint dell'interfaccia.

Una policy di endpoint specifica le informazioni riportate di seguito:

I principali che possono eseguire azioni (AWS account, utenti IAM e ruoli IAM).
- Per AgentCore Gateway, se l'ingresso del gateway non è basato su AWS Signature Version 4 (Sigv4) (ad esempio, se si utilizza invece OAuth), è necessario specificare il Principal campo come jolly *. L'autenticazione basata su Sigv4 consente di definirlo come identità specifica. Principal AWS Questo vale anche per Runtime. AgentCore
Le azioni che possono essere eseguite.
Le risorse in cui è possibile eseguire le operazioni.

Per ulteriori informazioni, consulta Controllare l'accesso ai servizi utilizzando le politiche degli endpoint nella AWS PrivateLink Guida.

Policy sugli endpoint per varie primitive

Gli esempi seguenti mostrano le politiche degli endpoint per i diversi componenti: AgentCore

Esempio

Runtime

La seguente politica sugli endpoint consente a specifici responsabili IAM di richiamare le risorse di runtime degli agenti.


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:user/USERNAME"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:runtime/RUNTIME_ID"
      }
   ]
}

Autenticazione mista IAM e OAuth

L'InvokeAgentRuntimeAPI supporta due modalità di autorizzazione degli endpoint VPC. La seguente policy di esempio consente sia ai principali IAM che ai chiamanti OAuth di accedere a diverse risorse di runtime dell'agente.


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:runtime/customAgent1"
      },
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:runtime/customAgent2"
      }
   ]
}

La politica precedente consente solo al principale IAM di effettuare chiamate a. InvokeAgentRuntime customAgent1 Consente inoltre sia ai principali IAM che ai chiamanti OAuth di effettuare chiamate verso. InvokeAgentRuntime customAgent2

Politiche per gli endpoint Protected Resource Metadata (PRM)

L'GetRuntimeProtectedResourceMetadataAPI implementa OAuth 2.0 Protected Resource Metadata (RFC 9728). I client chiamano questo endpoint prima di disporre delle credenziali, per scoprire quale server di autorizzazione protegge il runtime di un determinato agente. Questo endpoint non è autenticato per progettazione, quindi Principal deve essere impostato su * nella policy degli endpoint.

Le policy degli endpoint VPC vengono applicate alle richieste PRM. Se la tua policy sugli endpoint non lo consente esplicitamentebedrock-agentcore:GetRuntimeProtectedResourceMetadata, le richieste PRM tramite quell'endpoint vengono negate con HTTP 403. Qualsiasi runtime OAuth-configured dell'agente a cui si accede tramite un endpoint VPC richiede l'accesso PRM per l'individuazione del server di autorizzazione.

Nota

Se disponi di una politica di blocco totale degli endpoint per l'applicazione del perimetro dei dati e non utilizzi l'autenticazione OAuth o JWT, le richieste PRM vengono negate automaticamente. Non è necessaria alcuna configurazione aggiuntiva.

La seguente policy sugli endpoint consente a qualsiasi chiamante di scoprire il server di autorizzazione (PRM) limitando le invocazioni di runtime a un principale IAM specifico:


{
   "Statement": [
      {
         "Sid": "AllowPRMDiscovery",
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:GetRuntimeProtectedResourceMetadata"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      },
      {
         "Sid": "AllowInvoke",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/RUNTIME_ID"
      }
   ]
}

Per bloccare le ricerche PRM tra più account tramite l'endpoint VPC (applicazione del perimetro dei dati), limita l'istruzione PRM allow ai soli tempi di esecuzione del tuo account:


{
   "Statement": [
      {
         "Sid": "AllowPRMOwnAccountOnly",
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:GetRuntimeProtectedResourceMetadata"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      },
      {
         "Sid": "DenyCrossAccountPRM",
         "Effect": "Deny",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:GetRuntimeProtectedResourceMetadata"
         ],
         "NotResource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      },
      {
         "Sid": "AllowInvoke",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      }
   ]
}

Code Interpreter Tool

La seguente policy sugli endpoint consente a specifici responsabili IAM di richiamare le risorse di Code Interpreter.


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeCodeInterpreter"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:code-interpreter/CODE_INTERPRETER_ID"
      }
   ]
}

Memory

====== Tutte le operazioni del piano dati

La seguente policy sugli endpoint consente ai principali IAM specifici di accedere alle operazioni del piano dati us-east-1 per una memoria specifica. AgentCore


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvent",
            "bedrock-agentcore:DeleteEvent",
            "bedrock-agentcore:GetEvent",
            "bedrock-agentcore:ListEvents",
            "bedrock-agentcore:DeleteMemoryRecord",
            "bedrock-agentcore:GetMemoryRecord",
            "bedrock-agentcore:ListMemoryRecords",
            "bedrock-agentcore:RetrieveMemoryRecords",
            "bedrock-agentcore:ListActors",
            "bedrock-agentcore:ListSessions",
            "bedrock-agentcore:BatchCreateMemoryRecords",
            "bedrock-agentcore:BatchDeleteMemoryRecords",
            "bedrock-agentcore:BatchUpdateMemoryRecords"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:memory/MEMORY_ID"
      }
   ]
}

Accesso a tutte le memorie

La seguente policy sugli endpoint consente a specifici responsabili IAM di accedere a tutte le memorie.


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvent",
            "bedrock-agentcore:DeleteEvent",
            "bedrock-agentcore:GetEvent",
            "bedrock-agentcore:ListEvents",
            "bedrock-agentcore:DeleteMemoryRecord",
            "bedrock-agentcore:GetMemoryRecord",
            "bedrock-agentcore:ListMemoryRecords",
            "bedrock-agentcore:RetrieveMemoryRecords",
            "bedrock-agentcore:ListActors",
            "bedrock-agentcore:ListSessions",
            "bedrock-agentcore:BatchCreateMemoryRecords",
            "bedrock-agentcore:BatchDeleteMemoryRecords",
            "bedrock-agentcore:BatchUpdateMemoryRecords"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:memory/*"
      }
   ]
}

Restrizione dell'accesso tramite API

La seguente policy sugli endpoint concede l'autorizzazione a un responsabile IAM specifico di creare eventi in una specifica risorsa di memoria. AgentCore


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvent"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:memory/MEMORY_ID"
      }
   ]
}

Browser Tool

La seguente policy sugli endpoint consente a specifici responsabili IAM di connettersi alle risorse di Browser Tool.


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:ConnectBrowserAutomationStream"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:browser/BROWSER_ID"
      }
   ]
}

Gateway

Di seguito è riportato l'esempio di una policy dell'endpoint personalizzata. Quando colleghi questa policy all'endpoint dell'interfaccia, consente a tutti i principali di richiamare il gateway specificato nel campo. Resource


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:InvokeGateway"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:gateway/my-gateway"
      }
   ]
}

Identity

La seguente policy sugli endpoint consente l'accesso alle risorse di Identity.


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "*"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:workload-identity-directory/default/workload-identity/WORKLOAD_IDENTITY_ID"
      }
   ]
}

Evaluations and Optimizations

La seguente policy sugli endpoint consente a specifici responsabili IAM di accedere alle operazioni di valutazione e ottimizzazione.


{
   "Statement": [
      {
         "Sid": "AllowBatchEvaluations",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:StartBatchEvaluation",
            "bedrock-agentcore:GetBatchEvaluation",
            "bedrock-agentcore:ListBatchEvaluations",
            "bedrock-agentcore:StopBatchEvaluation",
            "bedrock-agentcore:DeleteBatchEvaluation"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:batch-evaluate/*"
      },
      {
         "Sid": "AllowRecommendations",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:StartRecommendation",
            "bedrock-agentcore:GetRecommendation",
            "bedrock-agentcore:ListRecommendations",
            "bedrock-agentcore:DeleteRecommendation"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:recommendation/*"
      },
      {
         "Sid": "AllowEvaluators",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvaluator",
            "bedrock-agentcore:GetEvaluator",
            "bedrock-agentcore:ListEvaluators",
            "bedrock-agentcore:UpdateEvaluator",
            "bedrock-agentcore:DeleteEvaluator"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:evaluator/*"
      },
      {
         "Sid": "AllowOnlineEvaluationConfigs",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateOnlineEvaluationConfig",
            "bedrock-agentcore:GetOnlineEvaluationConfig",
            "bedrock-agentcore:ListOnlineEvaluationConfigs",
            "bedrock-agentcore:UpdateOnlineEvaluationConfig",
            "bedrock-agentcore:DeleteOnlineEvaluationConfig"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:online-evaluation-config/*"
      },
      {
         "Sid": "AllowABTests",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateABTest",
            "bedrock-agentcore:GetABTest",
            "bedrock-agentcore:ListABTests",
            "bedrock-agentcore:UpdateABTest",
            "bedrock-agentcore:DeleteABTest"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:ab-test/*"
      },
      {
         "Sid": "AllowConfigurationBundles",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateConfigurationBundle",
            "bedrock-agentcore:GetConfigurationBundle",
            "bedrock-agentcore:GetConfigurationBundleVersion",
            "bedrock-agentcore:ListConfigurationBundles",
            "bedrock-agentcore:ListConfigurationBundleVersions",
            "bedrock-agentcore:UpdateConfigurationBundle",
            "bedrock-agentcore:DeleteConfigurationBundle"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:configuration-bundle/*"
      }
   ]
}

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

VPC e AWS PrivateLink

Configura Gateway VPC Egress