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á.

Trabalhando com ações direcionadas

AWS DevOps O agente pode agir em seus serviços e AWS contas conectados quando um operador solicitar explicitamente. Por exemplo, um operador que está investigando um incidente pode pedir ao agente que descreva o estado de um recurso. Com as permissões e aprovações apropriadas, o operador também pode solicitar que o agente corrija um problema diretamente.

O agente distingue dois tipos de operações:

O modelo de segurança para ações direcionadas é a defesa em profundidade. O recurso está desativado por padrão. Você opta por meio de camadas independentes: habilitando ações direcionadas no espaço do agente, registrando uma função do IAM por conta e categorizando cada ferramenta. Cada ação direcionada exige a aprovação do operador no momento da execução. Cada aprovação e ação resultante são atribuíveis ao operador aprovador em. AWS CloudTrail

Para ações contra AWS recursos, o agente impõe suas próprias barreiras às operações do AWS SDK que ele invoca, independentemente das permissões que você concede. Para obter mais informações sobre essas barreiras, consulte Operações que o agente não executará.

Exemplo: execução de um plano de mitigação a partir de uma investigação

Este exemplo mostra a experiência completa de um cenário comum. Um operador analisa o plano de mitigação de uma investigação ou uma recomendação de melhoria. A operadora pede que o agente faça isso sem sair da conversa.

Um engenheiro de confiabilidade do site (SRE) solicita que o agente no chat procure qualquer conta que permita o acesso por SSH. 0.0.0.0/0 O agente encontra um grupo de segurança com uma regra de entrada aberta. Ele recomenda uma mitigação: restrinja a regra ao alcance da rede interna. O operador diz ao agente que o aplique.

O mesmo fluxo se aplica quando você inspeciona qualquer investigação, plano de mitigação ou recomendação de melhoria e solicita que o agente execute uma etapa. O agente transforma a etapa em uma operação proposta específica e solicita aprovação antes de agir.

O mesmo fluxo se aplica às ferramentas de terceiros. Um operador que faz a triagem do ruído de alerta solicita que o agente aumente o limite de uma regra de alerta do Grafana. AWS DevOps O agente classifica essa ferramenta como mutante e a equipe a habilitou para acesso elevado à integração. O agente apresenta uma solicitação de aprovação mostrando a ferramenta e os parâmetros. Após a aprovação, o agente invoca a ferramenta por meio da integração. AWS DevOps O agente atribui a ação ao operador aprovador.

Antes que as ações direcionadas sejam ativadas, ou sem uma função elevada registrada, o agente ainda investiga com ações somente para leitura. Ele fornece etapas de remediação manual em vez de uma alteração executável.

Pré-requisitos

Antes de usar ações direcionadas, você precisa do seguinte:

Habilitando ações direcionadas em um espaço de agentes

As ações direcionadas devem ser habilitadas no espaço do agente antes que qualquer outra configuração elevada entre em vigor. Esse é o controle primário para ações direcionadas. Se estiver desativado, registros elevados de funções e opt-ins elevados de ferramentas não surtirão efeito. As tentativas de registrar uma configuração elevada podem ser rejeitadas.

Habilitar o no console

Habilitando por meio da API

Você habilita ações direcionadas por meio do espaço do agentepreferences. Esse campo é um mapa digitado de chaves de preferência para valores booleanos. Você o configura CreateAgentSpace UpdateAgentSpace e.

O exemplo a seguir permite ações direcionadas com a AWS CLI.

aws devops-agent update-agent-space \
    --agent-space-id <your-agent-space-id> \
    --preferences elevatedActionsEnabled=true

O preferences campo tem os seguintes comportamentos:

Registrando uma função elevada para um AWS account

Para cada AWS conta associada, você pode, opcionalmente, registrar uma função elevada. A conta do monitor e todas as contas de origem oferecem suporte a um registro de função elevado. Uma função elevada é uma função do IAM em sua conta que o AWS DevOps agente supõe para realizar ações direcionadas em seu nome. Você registra a função agentElevatedRoleArn definindo a AWS configuração da associação.

Ao registrar uma função elevada, tenha em mente o seguinte:

Escrevendo a política de confiança

A função elevada deve confiar no diretor de serviço do AWS DevOps agente. A validação exercita o caminho de assumir uma função. AWS DevOps O agente usa três ações STS quando assume a função. A política de confiança deve permitir todos os três: sts:AssumeRolests:SetSourceIdentity, sts:TagSession e. Se você omitir sts:SetSourceIdentity ousts:TagSession, as ações direcionadas falharão no momento da credencial, mesmo quando o status de validação for. valid

O exemplo a seguir mostra uma política de confiança para uma função elevada. 111122223333Substitua pelo ID AWS da sua conta e us-east-1 pela AWS região do seu espaço de agente.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "aidevops.amazonaws.com"
      },
      "Action": [
        "sts:AssumeRole",
        "sts:SetSourceIdentity",
        "sts:TagSession"
      ],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:aidevops:us-east-1:111122223333:agentspace/*"
        }
      }
    }
  ]
}

As aws:SourceArn condições aws:SourceAccount e protegem contra o confuso problema do deputado. Eles garantem que a função só possa ser assumida em nome de seus próprios espaços de agentes. A região na aws:SourceArn condição deve corresponder à região do seu espaço de agente. Se você opera espaços de agentes em várias regiões, use um curinga de região (arn:aws:aidevops:*:111122223333:agentspace/*) ou o ARN específico do espaço do agente.

Concessão de permissões para a função elevada

A política de permissão da função elevada define o limite máximo do que o AWS DevOps agente pode fazer em sua conta por meio de ações direcionadas. O agente nunca opera nesse teto. Cada ação direcionada exige a aprovação do operador. As credenciais emitidas para uma ação aprovada têm uma política de sessão. A política da sessão os limita à operação e aos recursos específicos aprovados pelo operador. O agente compõe a política da sessão somente a partir de uma lista selecionada de ações de AWS IAM suportadas que o AWS DevOps agente mantém. Uma ação fora dessa lista nunca pode fazer parte de uma política de sessão. Para navegar pela lista, abra a página Configuração no console do AWS DevOps Agente. Escolha Exibir ações suportadas na seção Ações do agente. Você tem duas opções para a política de permissão.

Opção 1: anexar a política AWS gerenciada. AWS DevOps O agente fornece a política AIDevOpsAgentActionsPolicy gerenciada. Seu ARN é arn:aws:iam::aws:policy/AIDevOpsAgentActionsPolicy. Para ver o documento de política em formato de código, consulte o Guia de referência de políticas AWS gerenciadas.

A política gerenciada tem as seguintes características:

Opção 2: redigir uma política gerenciada pelo cliente. Se você quiser um teto mais rígido do que o fornecido pela política gerenciada, escreva sua própria política. Defina exatamente as ações e os recursos que você deseja que o agente toque e associe-os à função. Siga o princípio do menor privilégio: comece com as operações que você espera que os operadores aprovem e expanda somente conforme necessário. As ações direcionadas que a função não permite falham no momento da execução, mesmo quando aprovadas.

Com qualquer uma das opções, você pode restringir ainda mais o que o agente pode fazer usando políticas de controle de serviços (SCPs) e limites de permissões. Esses controles se aplicam à função elevada como qualquer outra função em sua conta. Para obter mais informações sobre como definir o escopo do acesso do agente, consulteLimitando o acesso do agente em um AWS Conta.

Ciclo de vida de validação

A forma como a validação da política de confiança é executada depende do tipo de conta.

A função é usada para ações direcionadas somente após seu status servalid.

Para contas de origem, pesquise a associação com GetAssociation ou ListAssociations e marque o agentElevatedRoleArnStatus campo. A validação normalmente é concluída em alguns minutos.

Operações que o agente não executará

Independentemente das permissões que você concede, o agente impõe suas próprias barreiras às operações do AWS SDK que ele invoca como ações direcionadas. Essas barreiras se aplicam somente a ações contra AWS recursos. Em vez disso, a classificação de ferramentas rege as ferramentas de terceiros. Para obter mais informações sobre classificação de ferramentas, consulte Ferramentas de categorização para integrações de terceiros. Essas barreiras se aplicam mesmo quando a política da função elevada permite a operação. A aprovação do operador não os substitui.

Quando orientado a realizar uma dessas operações, o agente recusa e explica o porquê. Sempre que possível, ele descreve as etapas manuais em vez disso.

Essas barreiras complementam os controles que você possui: a política de permissão da função elevada, os SCPs e os limites de permissões da função elevada.

Ferramentas de categorização para integrações de terceiros

Third-party e as integrações MCP expõem ferramentas em três categorias que determinam se o agente pode invocar a ferramenta e qual aprovação é necessária. AWS DevOps O agente atribui classificações fixas para integrações nativas. Você os atribui aos servidores MCP configurados pelo cliente.

Customer-configured Servidores MCP

Para associações de servidores MCP (incluindo a variante SigV4), você mesmo classifica as ferramentas por meio de uma lista de toolDetails entradas por ferramenta. Cada entrada tem um name e toolClassification a.

Para obter mais informações sobre como conectar e listar ferramentas MCP na lista de permissões, consulte. Conectando servidores MCP

Integrações nativas (Datadog, Grafana)

Para integrações nativas, como Datadog e Grafana, as classificações são fixadas pelo Agente. AWS DevOps Você não fornece classificações. Você não pode substituir essas classificações. Em vez disso, você escolhe ferramentas de mutação específicas por meio enabledElevatedTools de uma lista de entradas de ferramentas.

Aprovação de ações direcionadas

As ações direcionadas são humanas. Quando o agente determina que uma operação para a qual foi direcionado modifica um recurso, ele não executa a operação diretamente. Em vez disso, acontece o seguinte:

AWS DevOps O agente exibe solicitações de aprovação do operador somente no chat. Se o agente invocar uma ferramenta de mutação fora do chat, por exemplo, durante uma investigação autônoma, a chamada falhará em vez de apresentar uma solicitação de aprovação. AWS DevOps O agente nunca executa uma ferramenta de mutação sem aprovação.

As aprovações e as ações resultantes são atribuíveis ao operador aprovador em. AWS CloudTrail

O fluxo de aprovação na API

Qualquer agente consumidor pode conduzir esse fluxo da mesma forma, seja um assistente de IA, como Claude, um bot do Slack ou um cliente de operações personalizadas: ligueSendMessage, envie a solicitação de aprovação a um operador, registre a decisão e retome a conversa comUpdateApprovalAction. SendMessage

Monitorar e auditar

Solução de problemas

Uma função registrada permanece ativapending-confirmation. Isso se aplica às contas de origem (secundárias), nas quais a validação é assíncrona. A validação normalmente é concluída em alguns minutos. Se o status não mudar, verifique se a função existe e registre novamente o ARN da função para acionar a validação novamente.

O status da função éinvalid. A validação da política de confiança falhou. Verifique se:

Corrija a política de confiança e registre novamente a função.

As ações direcionadas falham mesmo que o status da função sejavalid. O valid status reflete a verificação de validação no momento do registro. Se a política de confiança foi alterada após a validação ou se sua aws:SourceArn condição estiver fixada em uma região diferente do espaço do agente, a chamada ao vivo para assumir a função ainda poderá falhar. Analise a política de confiança em relação à lista de verificação acima.

ValidationExceptionao registrar uma função elevada. As ações direcionadas devem ser habilitadas no espaço do agente antes que você possa registrar a configuração elevada. Ative as ações direcionadas no espaço do agente primeiro e depois registre a função.

Erros de incompatibilidade do nome da ferramenta durante o fornecimentotoolDetails. Cada nome toolDetails deve corresponder exatamente ao nome de uma ferramenta na lista de ferramentas habilitadas da associação, incluindo maiúsculas e minúsculas. Compare as duas listas, corrija as incompatibilidades e tente novamente.