Alibaba Cloud CLI:Safety policy

Escenarios

• Salvaguardas de seguridad para agentes de IA: Cuando un agente de IA utiliza la CLI para gestionar recursos en la nube, una directiva de seguridad puede interceptar operaciones destructivas (como eliminaciones) y exigir confirmación humana o bloquearlas por completo. Esto proporciona un mecanismo de humano en el bucle (HITL).

• Protecciones operativas: Configure reglas predeterminadas en los entornos de CLI de su equipo para evitar la ejecución accidental de operaciones destructivas, como eliminar recursos o detener instancias.

Consultar la directiva actual

Ejecute el siguiente comando para ver la configuración de la directiva de seguridad en formato JSON:

aliyun configure safety-policy show

Salida de ejemplo:

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

Habilitar y deshabilitar

# Enable safety policy
aliyun configure safety-policy enable

# Disable safety policy
aliyun configure safety-policy disable

Ejecute aliyun configure safety-policy show para comprobar que el campo enabled tenga el valor true.

Agregar reglas

Sintaxis del comando:

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

Ejemplo: Bloquear todas las operaciones de eliminación en todos los productos:

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

Ejemplo: Solicitar confirmación humana para las operaciones de actualización de ECS:

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

Ejecute aliyun configure safety-policy list para verificar que la regla se haya agregado correctamente.

Eliminar reglas

Especifique el patrón exacto para eliminar una regla:

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

Listar reglas

Ejecute el siguiente comando para ver todas las reglas en una lista con formato:

aliyun configure safety-policy list

Salida de ejemplo:

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

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

Formato del patrón

El parámetro --pattern utiliza el formato {product}:{operation} y admite el comodín * para coincidir con cualquier secuencia de caracteres. La coincidencia de patrones no distingue entre mayúsculas y minúsculas: *:Delete*, *:DELETE* y *:delete* coinciden con las mismas operaciones.

La CLI genera identificadores de comando distintos según el estilo de API:

Ejemplos comunes de patrones:

Valores de acción

forbid es un alias de confirm. Ambos producen un comportamiento idéntico en tiempo de ejecución.

Si ninguna regla coincide, la operación se permite de forma predeterminada (permiso implícito). Las reglas allow explícitas se utilizan para crear excepciones antes que las reglas deny o confirm más generales.

Orden de evaluación de reglas

Las reglas se evalúan de arriba hacia abajo en el orden configurado, mediante una estrategia de primera coincidencia: la primera regla que coincide surte efecto y no se revisan las siguientes. Si ninguna regla coincide, el comportamiento predeterminado es permitir la ejecución.

Por ejemplo, dadas las siguientes dos reglas:

1. ecs:Delete* → confirm

2. *:Delete* → deny

Cuando ejecuta aliyun ecs delete-instance, la primera regla (ecs:Delete*) coincide y se aplica la acción confirm, no la acción deny de la segunda regla.

Uso de allow para crear excepciones:

1. ecs:Describe* → allow

2. ecs:* → deny

Al ejecutar aliyun ecs DescribeInstances, se cumple la primera regla allow y la operación continúa con normalidad. Al ejecutar aliyun ecs DeleteInstance, se cumple la segunda regla y la operación se bloquea.

El indicador --yes

Cuando especifica el indicador --yes (o -y), las reglas confirm se omiten automáticamente (se consideran aprobadas). Las reglas deny no se ven afectadas y siguen bloqueando la ejecución.

# 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*)

También puede establecer la variable de entorno ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM en true para aprobar automáticamente todas las reglas confirm durante toda una sesión. Esto equivale a pasar --yes en cada comando:

export ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM=true

Comportamiento en terminales no interactivas

La CLI detecta si la entrada estándar es un dispositivo de terminal para determinar el entorno actual. En entornos no interactivos (como scripts, canalizaciones de CI/CD y tiempos de ejecución de agentes de IA), si una operación coincide con una regla confirm y no se especifica el indicador --yes, la CLI devuelve el siguiente error:

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.

Flujo de trabajo recomendado para agentes de IA

Cuando un agente de IA gestiona recursos en la nube a través de la CLI, siga estos pasos para configurar y utilizar las directivas de seguridad:

1. Configurar directivas de seguridad: Establezca deny para las operaciones que deban prohibirse por completo, y confirm para las operaciones que requieran aprobación.

2. Gestionar solicitudes de confirmación: Cuando el agente encuentre un bloqueo confirm, presente los detalles de la operación al usuario y solicite su aprobación.

3. Volver a ejecutar con aprobación: Una vez que el usuario confirme, el agente vuelve a ejecutar el comando con el indicador --yes.

Ejemplo de configuración: Bloquear operaciones de eliminación y requerir confirmación humana para operaciones de actualización:

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"
    }
  ]
}