Alibaba Cloud CLI:Safety policy

Scénarios

• Barrières de sécurité pour les agents IA : Lorsqu'un agent IA utilise la CLI pour gérer des ressources cloud, une politique de sécurité peut intercepter les opérations destructrices (telles que les suppressions) et exiger une confirmation humaine ou les bloquer entièrement, offrant ainsi un mécanisme « human-in-the-loop » (HITL).

• Mesures de protection opérationnelles : Configurez des règles par défaut pour les environnements CLI d'équipe afin d'éviter l'exécution accidentelle d'opérations destructrices, telles que la suppression de ressources ou l'arrêt d'instances.

Afficher la politique actuelle

Exécutez la commande suivante pour afficher la configuration de la politique de sécurité au format JSON :

aliyun configure safety-policy show

Exemple de sortie :

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

Activer et désactiver

# Enable safety policy
aliyun configure safety-policy enable

# Disable safety policy
aliyun configure safety-policy disable

Exécutez aliyun configure safety-policy show pour vérifier que le champ enabled est défini sur true.

Ajouter des règles

Syntaxe de la commande :

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

Exemple : Bloquer toutes les opérations de suppression sur tous les produits :

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

Exemple : Exiger une confirmation humaine pour les opérations de mise à jour ECS :

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

Exécutez aliyun configure safety-policy list pour vérifier que la règle a bien été ajoutée.

Supprimer des règles

Spécifiez le modèle exact pour supprimer une règle :

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

Lister les règles

Exécutez la commande suivante pour afficher toutes les règles dans une liste formatée :

aliyun configure safety-policy list

Exemple de sortie :

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

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

Format du modèle

Le paramètre --pattern utilise le format {product}:{operation} et prend en charge le caractère générique * pour correspondre à n'importe quelle séquence de caractères. La correspondance des modèles est insensible à la casse : *:Delete*, *:DELETE* et *:delete* correspondent tous aux mêmes opérations.

La CLI construit différents identifiants de commande selon le style d'API :

Exemples courants de modèles :

Valeurs d'action

forbid est un alias de confirm. Ils produisent un comportement d'exécution identique.

Si aucune règle ne correspond, l'opération est autorisée par défaut (autorisation implicite). Les règles allow explicites servent à créer des exceptions avant les règles deny ou confirm plus larges.

Ordre d'évaluation des règles

Les règles sont évaluées de haut en bas dans l'ordre configuré, selon une stratégie de première correspondance : la première règle correspondante s'applique et les règles suivantes ne sont pas vérifiées. Si aucune règle ne correspond, l'exécution est autorisée par défaut.

Par exemple, étant donné les deux règles suivantes :

1. ecs:Delete* → confirm

2. *:Delete* → deny

Lorsque vous exécutez aliyun ecs delete-instance, la première règle (ecs:Delete*) correspond et l'action confirm est appliquée, et non l'action deny de la deuxième règle.

Utilisation de allow pour créer des exceptions :

1. ecs:Describe* → allow

2. ecs:* → deny

L'exécution de aliyun ecs DescribeInstances correspond à la première règle allow et l'opération se déroule normalement. L'exécution de aliyun ecs DeleteInstance correspond à la deuxième règle et est bloquée.

L'option --yes

Lorsque vous spécifiez l'option --yes (ou -y), les règles confirm sont automatiquement ignorées (considérées comme approuvées). Les règles deny ne sont pas affectées et bloquent toujours l'exécution.

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

Vous pouvez également définir la variable d'environnement ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM sur true pour approuver automatiquement toutes les règles confirm pendant toute une session, ce qui équivaut à passer l'option --yes à chaque commande :

export ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM=true

Comportement en terminal non interactif

La CLI détecte si l'entrée standard est un périphérique terminal pour déterminer l'environnement actuel. Dans les environnements non interactifs (tels que les scripts, les pipelines CI/CD et les environnements d'exécution d'agents IA), si une opération correspond à une règle confirm et que l'option --yes n'est pas spécifiée, la CLI renvoie l'erreur suivante :

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.

Workflow recommandé pour les agents IA

Lorsqu'un agent IA gère des ressources cloud via la CLI, suivez ces étapes pour configurer et utiliser les politiques de sécurité :

1. Configurer les politiques de sécurité : Définissez deny pour les opérations qui doivent être entièrement interdites, et confirm pour les opérations nécessitant une approbation.

2. Gérer les invites de confirmation : Lorsque l'agent rencontre un blocage confirm, présentez les détails de l'opération à l'utilisateur et demandez son approbation.

3. Réexécuter avec approbation : Une fois que l'utilisateur a confirmé, l'agent réexécute la commande avec l'option --yes.

Exemple de configuration : Bloquer les opérations de suppression et exiger une confirmation humaine pour les opérations de mise à jour :

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