Alibaba Cloud CLI:Safety policy

Cenários

• Barreiras de segurança para agentes de IA: Quando um agente de IA usa o CLI para gerenciar recursos de nuvem, uma política de segurança pode interceptar operações destrutivas (como exclusões) e exigir confirmação humana ou bloqueá-las completamente, fornecendo um mecanismo de humano no loop (HITL).

• Salvaguardas operacionais: Configure regras padrão para ambientes de CLI da equipe a fim de evitar a execução acidental de operações destrutivas, como excluir recursos ou parar instâncias.

Visualizar a política atual

Execute o comando abaixo para visualizar a configuração da política de segurança no formato JSON:

aliyun configure safety-policy show

Exemplo de saída:

{
  "enabled": false,
  "rules": []
}

Ativar e desativar

# Enable safety policy
aliyun configure safety-policy enable

# Disable safety policy
aliyun configure safety-policy disable

Execute aliyun configure safety-policy show para verificar se o campo enabled está definido como true.

Adicionar regras

Sintaxe do comando:

aliyun configure safety-policy add --pattern <pattern> --action <deny|confirm>

Exemplo: Bloquear todas as operações de exclusão em todos os produtos:

aliyun configure safety-policy add --pattern '*:Delete*' --action deny

Exemplo: Exigir confirmação humana para operações de atualização do ECS:

aliyun configure safety-policy add --pattern 'ecs:Update*' --action confirm

Execute aliyun configure safety-policy list para confirmar que a regra foi adicionada.

Remover regras

Especifique o padrão exato para remover uma regra:

aliyun configure safety-policy remove --pattern '*:Delete*'

Listar regras

Use o comando a seguir para visualizar todas as regras em uma lista formatada:

aliyun configure safety-policy list

Exemplo de saída:

Safety policy: enabled
Config file: /home/user/.aliyun/safety-policy.json

Rules:
  1. *:Delete* -> deny
  2. ecs:Update* -> confirm

Formato do padrão

O parâmetro --pattern utiliza o formato {product}:{operation} e suporta o caractere curinga * para corresponder a qualquer sequência de caracteres. A correspondência de padrões não diferencia maiúsculas de minúsculas: *:Delete*, *:DELETE* e *:delete* correspondem às mesmas operações.

O CLI constrói identificadores de comando diferentes dependendo do estilo da API:

Exemplos comuns de padrões:

Valores de ação

forbid é um alias para confirm. Ambos produzem comportamento idêntico em tempo de execução.

Se nenhuma regra corresponder, a operação será permitida por padrão (permissão implícita). Regras explícitas de allow servem para criar exceções antes de regras mais amplas de deny ou confirm.

Ordem de avaliação das regras

As regras são avaliadas de cima para baixo na ordem configurada, usando uma estratégia de primeira correspondência: a primeira regra correspondente entra em vigor e as regras subsequentes não são verificadas. Se nenhuma regra corresponder, o padrão é permitir a execução.

Por exemplo, dadas as duas regras a seguir:

1. ecs:Delete* → confirm

2. *:Delete* → deny

Ao executar aliyun ecs delete-instance, a primeira regra (ecs:Delete*) corresponde, e a ação confirm é aplicada — não o deny da segunda regra.

Uso de allow para criar exceções:

1. ecs:Describe* → allow

2. ecs:* → deny

A execução de aliyun ecs DescribeInstances corresponde à primeira regra allow e a operação prossegue normalmente. Já a execução de aliyun ecs DeleteInstance corresponde à segunda regra e é bloqueada.

A flag --yes

Quando você especifica a flag --yes (ou -y), as regras de confirm são automaticamente ignoradas (tratadas como aprovadas). As regras de deny não são afetadas e continuam bloqueando a execução.

# confirm rules are skipped, operation executes directly
aliyun ecs update-instance --InstanceId i-bp1xxxxx --yes

# deny rules are not affected, operation is still blocked
aliyun ecs delete-instance --InstanceId i-bp1xxxxx --yes
# Output: ERROR: operation blocked by safety policy: ecs delete-instance (rule: *:Delete*)

Também é possível definir a variável de ambiente ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM como true para aprovar automaticamente todas as regras de confirm durante uma sessão inteira, o que equivale a passar --yes em cada comando:

export ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM=true

Comportamento em terminais não interativos

O CLI detecta se a entrada padrão é um dispositivo de terminal para determinar o ambiente atual. Em ambientes não interativos (como scripts, pipelines de CI/CD e runtimes de agentes de IA), se uma operação corresponder a uma regra de confirm e a flag --yes não for especificada, o CLI retorna o seguinte erro:

Safety policy requires confirmation for: ecs update-instance
This operation cannot run in non-interactive mode without explicit approval. If you are an agent, ask the user whether this operation is allowed; after they confirm (e.g. reply yes), re-run the same command with --yes.

Fluxo de trabalho recomendado para agentes de IA

Quando um agente de IA gerencia recursos de nuvem por meio do CLI, siga estas etapas para configurar e usar políticas de segurança:

1. Configure as políticas de segurança: Defina deny para operações que devem ser totalmente proibidas e confirm para operações que exigem aprovação.

2. Gerencie solicitações de confirmação: Quando o agente encontrar um bloco de confirm, apresente os detalhes da operação ao usuário e solicite aprovação.

3. Reexecute com aprovação: Após a confirmação do usuário, o agente executa novamente o comando com a flag --yes.

Exemplo de configuração: Bloquear operações de exclusão e exigir confirmação humana para operações de atualização:

aliyun configure safety-policy enable
aliyun configure safety-policy add --pattern '*:Delete*' --action deny
aliyun configure safety-policy add --pattern '*:Update*' --action confirm

{
  "enabled": true,
  "rules": [
    {
      "pattern": "ecs:Describe*",
      "action": "allow"
    },
    {
      "pattern": "*:Delete*",
      "action": "deny"
    },
    {
      "pattern": "ecs:Update*",
      "action": "confirm"
    }
  ]
}