View a markdown version of this page

Como o Amazon Bedrock AgentCore funciona com o IAM - Base da Amazônia AgentCore

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como o Amazon Bedrock AgentCore funciona com o IAM

Antes de usar o IAM para gerenciar o acesso AgentCore, saiba quais recursos do IAM estão disponíveis para uso AgentCore.

Para obter uma visão geral 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ítica de permissões JSON que você pode anexar a uma identidade, como um usuário do IAM, grupo de usuários ou 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 de Agent Runtime e Gateway. Essas políticas são vinculadas 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 as Resource-based 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 Exemplos e casos de uso 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 a quê. Ou seja, qual diretor pode realizar ações com 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 pela 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 de políticas para AgentCore

Compatível com recursos de políticas: sim

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso a quê. Ou seja, qual diretor pode realizar ações com 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 de tipos de AgentCore recursos e seus ARNs, consulte Recursos definidos pela 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 pela 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 da 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 a quê. Ou seja, qual diretor pode realizar ações com 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 para 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 pela 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 a APIs que aceitam um JWT representando um usuário final para trabalhar com valores de declaração específicos do emissor (iss) presentes no JWT passado na solicitação. Você pode aplicar essa chave de condição às CompleteResourceTokenAuth operações GetWorkloadAccessTokenForJwt e.

  • 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 específicos de assunto (sub) reivindicação presentes no JWT passado na solicitação. Você pode aplicar essa chave de condição às CompleteResourceTokenAuth operações GetWorkloadAccessTokenForJwt e.

  • 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 reivindicação de público (aud) presentes no JWT passado na solicitação. Você pode aplicar essa chave de condição às CompleteResourceTokenAuth operações GetWorkloadAccessTokenForJwt e.

  • bedrock-agentcore:userid- Você pode usar essa chave de condição para restringir o acesso às APIs que aceitam um ID de usuário estático 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 às CompleteResourceTokenAuth operações GetWorkloadAccessTokenForUserId e.

  • 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 transmitida 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 de client_id declaração específicos presentes no JWT passado na solicitação. Essa chave só está disponível quando o JWT tem a client_id reivindicaçã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 às CompleteResourceTokenAuth operações GetWorkloadAccessTokenForJwt e.

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:

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 o controle de acesso (ABAC) é uma estratégia de autorização que define permissões com base em atributos chamados 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 principal corresponder à tag no recurso.

Para controlar o acesso com base em tags, você fornece informações sobre tags no elemento de condição de uma política usando as chaves aws:ResourceTag/key-nameaws:RequestTag/key-name,, ou aws:TagKeys condicional.

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 federação ou troca de funções. AWS recomenda que você gere dinamicamente credenciais temporárias 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 que está 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 a serviços é 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 em 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 inclui 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.