

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

# Geração de políticas: validação por política

Ao usar o serviço de criação de políticas para gerar políticas a partir de linguagem natural, a validação e a análise ocorrem ** por política individual ** durante a geração.

## Como funciona
<a name="policy-generation-validation-how"></a>

1. A linguagem natural é convertida em uma política de cedro

1. Cada política gerada é validada em relação ao esquema do gateway

1. A análise é executada em cada política individualmente

1. Os resultados estão disponíveis na resposta de geração

## Exemplo: gerar e validar uma política
<a name="policy-generation-validation-example"></a>

A recuperação dos resultados da geração é um processo de duas etapas: primeiro verifique o status da geração e, em seguida, liste os ativos gerados para ver as políticas e suas descobertas de validação.

Inicie uma geração de políticas:

```bash
aws bedrock-agentcore-control start-policy-generation \
  --policy-engine-id MyEngine-abc123 \
  --name RefundPolicy \
  --content '{
    "rawText": "Allow customer service agents to process refunds up to 500 dollars for orders placed within the last 30 days"
  }' \
  --resource '{
    "arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/MyGateway-xyz789"
  }'
```

A resposta inclui um ID e status de geração de políticas:

```json
{
  "policyGenerationId": "RefundPolicy-def456",
  "policyEngineId": "MyEngine-abc123",
  "status": "GENERATING"
}
```

Verifique o status da geração usando`get-policy-generation`:

```bash
aws bedrock-agentcore-control get-policy-generation \
  --policy-engine-id MyEngine-abc123 \
  --policy-generation-id RefundPolicy-def456
```

A resposta mostra o status geral da geração:

```json
{
  "policyGenerationId": "RefundPolicy-def456",
  "status": "GENERATED",
  "statusReasons": []
}
```

Quando o status estiver`GENERATED`, liste os ativos gerados para recuperar as políticas e suas descobertas de validação por política:

```bash
aws bedrock-agentcore-control list-policy-generation-assets \
  --policy-engine-id MyEngine-abc123 \
  --policy-generation-id RefundPolicy-def456
```

A resposta inclui cada política gerada com suas conclusões de definição e validação do Cedar:

```json
{
  "policyGenerationAssets": [
    {
      "policyGenerationAssetId": "asset-1",
      "definition": {
        "cedar": {
          "statement": "permit(\n  principal is AgentCore::OAuthUser,\n  action == AgentCore::Action::\"RefundTool___process_refund\",\n  resource == AgentCore::Gateway::\"arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/MyGateway-xyz789\"\n) when {\n  context.input.amount <= 500\n};"
        }
      },
      "findings": [
        {
          "type": "VALID"
        }
      ],
      "rawTextFragment": "Allow customer service agents to process refunds up to 500 dollars"
    },
    {
      "policyGenerationAssetId": "asset-2",
      "definition": {
        "cedar": {
          "statement": "permit(\n  principal,\n  action == AgentCore::Action::\"RefundTool___view_order_history\",\n  resource\n);"
        }
      },
      "findings": [
        {
          "type": "ALLOW_ALL",
          "description": "Overly Permissive: Policy Engine will allow every request for the specified principal (AgentCore::OAuthUser), action (RefundTool___view_order_history) and resource (gateway/*) combination if the policy is added or updated"
        }
      ],
      "rawTextFragment": "Allow customer service agents to view order history"
    }
  ]
}
```

## Conclusões de validação por política
<a name="policy-generation-findings"></a>

Cada ativo de política gerado inclui uma `findings` matriz de `Finding` objetos, cada um com um `type` `description` e. Os exemplos a seguir mostram diferentes tipos de descoberta:

Uma política que passou por validação e análise:

```json
{
  "findings": [
    {
      "type": "VALID"
    }
  ]
}
```

Uma política sinalizada como excessivamente permissiva:

```json
{
  "findings": [
    {
      "type": "ALLOW_ALL",
      "description": "Overly Permissive: Policy Engine will allow every request for the specified principal (AgentCore::OAuthUser), action (RefundTool___view_order_history) and resource (gateway/*) combination if the policy is added or updated"
    }
  ]
}
```

Uma política que não pôde ser gerada a partir da entrada de linguagem natural:

```json
{
  "findings": [
    {
      "type": "NOT_TRANSLATABLE",
      "description": "Unsupported Condition Error: The request includes conditions that rely on data or attributes currently not supported."
    }
  ]
}
```

## Conclusões comuns sobre políticas geradas
<a name="policy-common-findings"></a>

A tabela a seguir descreve os tipos de descoberta que podem ser retornados para as políticas geradas:


| Tipo de descoberta | Gravidade | Description | Ação recomendada | 
| --- | --- | --- | --- | 
|  `VALID`  | Bem-sucedida | A política é válida, Cedar, sem descobertas. Nenhuma descrição é retornada para esse tipo de descoberta. | Nenhuma ação necessária. A política está pronta para uso. | 
|  `INVALID`  | Erro | A política Cedar gerada contém erros de sintaxe ou não está em conformidade com o esquema do gateway. | Analise a política gerada em busca de violações de esquema ou problemas de sintaxe. Reformule a entrada da linguagem natural e regenere. | 
|  `NOT_TRANSLATABLE`  | Erro | A linguagem natural não pôde ser convertida em cedro válido. A solicitação pode incluir condições que dependem de dados ou atributos não suportados. | Verifique novamente o recurso de gateway direcionado para a definição das ferramentas. | 
|  `ALLOW_ALL`  | Aviso | A política de permissão se aplica a todas as combinações de principais, ações e recursos. | Confirme se o acesso irrestrito é pretendido. Adicione condições para restringir o escopo, caso contrário. | 
|  `ALLOW_NONE`  | Aviso | A política de permissão não é determinante porque não permite nada. | Revise as condições da política. A política pode conter condições contraditórias ou inacessíveis. | 
|  `DENY_ALL`  | Aviso | A política nega todas as ações de todos os diretores. | Confirme se uma negação completa é pretendida. Isso substitui todas as políticas de permissão devido à semântica de proibição-substituição-permissão. | 
|  `DENY_NONE`  | Aviso | A política de proibição não é determinante porque não nega nada. | Revise as condições da política. A política de proibição pode conter condições contraditórias ou inacessíveis. | 