Como o Amazon Bedrock AgentCore funciona com o IAM
Antes de usar o IAM para gerenciar o acesso AgentCore, saiba com quais recursos do IAM estão disponíveis para uso AgentCore.
| Recurso do IAM | AgentCore apoio |
|---|---|
|
Sim |
|
|
Parcial |
|
|
Sim |
|
|
Sim |
|
|
Sim |
|
|
Não |
|
|
Parcial |
|
|
Sim |
|
|
Sim |
|
|
Sim |
|
|
Sim |
Para ter uma visão de alto nível de como AgentCore e outros AWS serviços funcionam com a maioria dos recursos do IAM, consulte AWS os serviços que funcionam com o IAM no Guia do usuário do IAM.
Identity-based políticas para AgentCore
Compatível com políticas baseadas em identidade: sim
Identity-based políticas são documentos de políticas de permissões JSON que você pode anexar a uma identidade, como um usuário do IAM, um grupo de usuários ou uma função. Essas políticas controlam quais ações os usuários e perfis podem realizar, em quais atributos e em que condições. Para saber como criar uma política baseada em identidade, consulte Definir permissões personalizadas do IAM com as políticas gerenciadas pelo cliente no Guia do Usuário do IAM.
Com as políticas baseadas em identidade do IAM, é possível especificar ações e recursos permitidos ou negados, assim como as condições sob as quais as ações são permitidas ou negadas. Para saber mais sobre todos os elementos que podem ser usados em uma política JSON, consulte Referência de elemento de política JSON do IAM no Guia do usuário do IAM.
Identity-based exemplos de políticas para AgentCore
Para ver exemplos de políticas AgentCore baseadas em identidade, consulte Identity-based exemplos de políticas para o Amazon Bedrock. AgentCore
Resource-based políticas dentro AgentCore
Compatível com políticas baseadas em recursos: Parcial
Resource-based políticas são documentos de política JSON que você anexa a um recurso. São exemplos de políticas baseadas em recursos as políticas de confiança de perfil do IAM e as políticas de bucket do Amazon S3. Em serviços compatíveis com políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Para o atributo ao qual a política está anexada, a política define quais ações uma entidade principal especificado pode executar nesse atributo e em que condições. É necessário especificar uma entidade principal em uma política baseada em recursos. Os diretores podem incluir contas, usuários, funções, usuários federados ou AWS serviços.
Para permitir o acesso entre contas, é possível especificar uma conta inteira ou as entidades do IAM em outra conta como a entidade principal em uma política baseada em recursos. Consulte mais informações em Acesso a recursos entre contas no IAM no Guia do usuário do IAM.
O Amazon Bedrock AgentCore oferece suporte a políticas baseadas em recursos para recursos do Agent Runtime e do Gateway. Essas políticas são anexadas diretamente aos seus recursos e definem quais diretores podem realizar ações sobre eles.
Para saber como criar e gerenciar políticas baseadas em recursos para os AgentCore recursos do Amazon Bedrock, consulte Resource-based as políticas do Amazon Bedrock. AgentCore
Resource-based exemplos de políticas dentro AgentCore
Para ver exemplos de políticas AgentCore baseadas em recursos, consulte Casos de uso e exemplos comuns.
Ações políticas para AgentCore
Compatível com ações de políticas: sim
Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual diretor pode realizar ações sobre quais recursos e sob quais condições.
O elemento Action de uma política JSON descreve as ações que podem ser usadas para permitir ou negar acesso em uma política. Incluem ações em uma política para conceder permissões para executar a operação associada.
Para ver uma lista de AgentCore ações, consulte Ações definidas pelo Amazon Bedrock AgentCore na Referência de autorização de serviço.
As ações de política AgentCore usam o seguinte prefixo antes da ação:
bedrock-agentcore
Para especificar várias ações em uma única declaração, separe-as com vírgulas.
"Action": [ "bedrock-agentcore:action1", "bedrock-agentcore:action2" ]
Para ver exemplos de políticas AgentCore baseadas em identidade, consulte Identity-based exemplos de políticas para o Amazon Bedrock. AgentCore
Recursos políticos para AgentCore
Compatível com recursos de políticas: sim
Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual diretor pode realizar ações sobre quais recursos e sob quais condições.
O elemento de política JSON Resource especifica o objeto ou os objetos aos quais a ação se aplica. Como prática recomendada, especifique um recurso usando seu nome do recurso da Amazon (ARN). Para ações que não oferecem suporte a permissões em nível de recurso, use um caractere curinga (*) para indicar que a declaração se aplica a todos os recursos.
"Resource": "*"
Para ver uma lista dos tipos de AgentCore recursos e seus ARNs, consulte Recursos definidos pelo Amazon Bedrock AgentCore na Referência de autorização de serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Ações definidas pelo Amazon Bedrock. AgentCore
Para ver exemplos de políticas AgentCore baseadas em identidade, consulte Identity-based exemplos de políticas para o Amazon Bedrock. AgentCore
Chaves de condição de política para AgentCore
Compatível com chaves de condição de política específicas de serviço: sim
Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual diretor pode realizar ações sobre quais recursos e sob quais condições.
O elemento Condition especifica quando as instruções são executadas com base em critérios definidos. Você pode criar expressões condicionais que usam operadores de condição, como igual ou menor que, para combinar a condição na política com os valores na solicitação. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia do usuário do IAM.
Para ver uma lista de chaves de AgentCore condição, consulte Chaves de condição do Amazon Bedrock AgentCore na Referência de autorização de serviço. Para saber com quais ações e recursos você pode usar uma chave de condição, consulte Ações definidas pelo Amazon Bedrock AgentCore.
As seguintes chaves de condição são especialmente úteis ao trabalhar com o Amazon Bedrock AgentCore:
-
bedrock-agentcore:InboundJwtClaim/iss- Você pode usar essa chave de condição para restringir o acesso às APIs que aceitam um JWT representando um usuário final para trabalhar com valores específicos de declaração do emissor (iss) presentes no JWT passado na solicitação. Você pode aplicar essa chave de condição àsCompleteResourceTokenAuthoperaçõesGetWorkloadAccessTokenForJwte. -
bedrock-agentcore:InboundJwtClaim/sub- Você pode usar essa chave de condição para restringir o acesso às APIs que aceitam um JWT para trabalhar com valores de (sub) declaração de assunto específicos presentes no JWT passado na solicitação. Você pode aplicar essa chave de condição àsCompleteResourceTokenAuthoperaçõesGetWorkloadAccessTokenForJwte. -
bedrock-agentcore:InboundJwtClaim/aud- Você pode usar essa chave de condição para restringir o acesso às APIs que aceitam um JWT para trabalhar com valores específicos de declaração de público (aud) presentes no JWT passado na solicitação. Você pode aplicar essa chave de condição àsCompleteResourceTokenAuthoperaçõesGetWorkloadAccessTokenForJwte. -
bedrock-agentcore:userid- Você pode usar essa chave de condição para restringir o acesso às APIs que aceitam uma ID de usuário estática para funcionar somente com os valores de ID de usuário definidos em sua declaração de política. Você pode aplicar essa chave de condição àsCompleteResourceTokenAuthoperaçõesGetWorkloadAccessTokenForUserIde. -
bedrock-agentcore:InboundJwtClaim/scope- Você pode usar essa chave de condição para restringir o acesso com base na declaração de escopo no JWT passada na solicitação. -
bedrock-agentcore:InboundJwtClaim/client_id- Você pode usar essa chave de condição para restringir o acesso às APIs que aceitam um JWT para trabalhar com valores declient_iddeclaração específicos presentes no JWT passado na solicitação. Essa chave só está disponível quando o JWT tem aclient_idreivindicação exata e não está disponível quando as informações são comunicadas em outras reivindicações semelhantes. Você pode aplicar essa chave de condição àsCompleteResourceTokenAuthoperaçõesGetWorkloadAccessTokenForJwte.
Para ver exemplos de políticas AgentCore baseadas em identidade, consulte Identity-based exemplos de políticas para o Amazon Bedrock. AgentCore
Para obter informações detalhadas sobre chaves de condição para AgentCore recursos específicos, consulte os tópicos a seguir:
-
Use as chaves de condição do IAM com o Amazon Bedrock AgentCore Gateway — chaves de condição para as operações
CreateGatewayUpdateGateway,CreateGatewayTarget, e deUpdateGatewayTargetAPI. -
Use chaves de condição do IAM com configurações de AgentCore VPC — chaves de VPC-related condição para AgentCore tempo de execução, ferramentas integradas e destinos de gateway.
ACLs em AgentCore
Compatível com ACLs: não
As listas de controle de acesso (ACLs) controlam quais entidades principais (membros, usuários ou perfis da conta) têm permissões para acessar um recurso. As ACLs são semelhantes às políticas baseadas em recursos, embora não usem o formato de documento de política JSON.
ABAC com AgentCore
Compatível com ABAC (tags em políticas): parcial
Attribute-based controle de acesso (ABAC) é uma estratégia de autorização que define permissões com base em atributos chamados de tags. Você pode anexar tags a entidades e AWS recursos do IAM e, em seguida, criar políticas ABAC para permitir operações quando a tag do diretor corresponder à tag no recurso.
Para controlar o acesso com base em tags, você fornece informações de tag no elemento condicional de uma política usando as chaves de aws:TagKeys condição aws:ResourceTag/key-nameaws:RequestTag/key-name, ou.
Se um serviço for compatível com as três chaves de condição para cada tipo de recurso, o valor será Sim para o serviço. Se um serviço for compatível com as três chaves de condição somente para alguns tipos de recursos, o valor será Parcial
Para saber mais sobre o ABAC, consulte Definir permissões com autorização do ABAC no Guia do usuário do IAM. Para visualizar um tutorial com etapas para configurar o ABAC, consulte Usar controle de acesso por atributo (ABAC) no Guia do usuário do IAM.
Usando credenciais temporárias com AgentCore
Compatível com credenciais temporárias: sim
As credenciais temporárias fornecem acesso de curto prazo aos AWS recursos e são criadas automaticamente quando você usa a federação ou troca de funções. AWS recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para obter mais informações, consulte Credenciais de segurança temporárias no IAM e AWS serviços que funcionam com o IAM no Guia do usuário do IAM.
Cross-service permissões principais para AgentCore
Compatibilidade com o recurso de encaminhamento de sessões de acesso (FAS): sim
As sessões de acesso direto (FAS) usam as permissões do principal chamando um AWS serviço, combinadas com o AWS serviço solicitante para fazer solicitações aos serviços posteriores. Para obter detalhes da política ao fazer solicitações de FAS, consulte Sessões de acesso direto.
Funções de serviço para AgentCore
Compatível com perfis de serviço: sim
O perfil de serviço é um perfil do IAM que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. Para obter mais informações, consulte Criar uma função para delegar permissões a um AWS serviço no Guia do usuário do IAM.
Atenção
Alterar as permissões de uma função de serviço pode interromper AgentCore a funcionalidade. Edite as funções de serviço somente quando AgentCore fornecer orientação para fazer isso.
Service-linked funções para AgentCore
Compatibilidade com perfis vinculados a serviços: sim
Uma função vinculada ao serviço é um tipo de função de serviço vinculada a um AWS serviço. O serviço pode assumir a função de realizar uma ação em seu nome. Service-linked as funções aparecem na sua AWS conta e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não editar as permissões para perfis vinculados ao serviço.
Para obter detalhes sobre como criar ou gerenciar perfis vinculados a serviços, consulte Serviços da AWS que funcionam com o IAM. Encontre um serviço na tabela que inclua um Yes na coluna de Service-linked função. Escolha o link Sim para visualizar a documentação do perfil vinculado a serviço desse serviço.