AI CodeOps

Référence des règles de politique

Mis à jour le

Écrivez des règles de politique pour les sessions IA : les sept actions, allow, ask et deny, les globs de ressource, les réglages de confiance, le mode log-only et un exemple complet.

Une politique d'espace de travail décide de ce que les sessions IA peuvent faire seules, de ce qui nécessite l'approbation d'une personne et de ce qu'elles ne peuvent jamais faire. Cette page est la référence pour écrire des règles. Pour le fonctionnement des approbations une fois qu'une règle en demande une, consultez Approbations et politiques.

Les politiques ne régissent que les sessions. Ce qu'une personne peut faire est défini par son rôle.

Ouvrir la politique

Ouvrez Secure → Policies. La page affiche :

  • Enforcement : Enforced ou Log only.
  • Rules in effect, Trust posture et Version.
  • Rules : l'identifiant, l'action, la ressource et la décision de chaque règle.
  • What changed between versions : les règles ajoutées, supprimées et modifiées entre deux versions enregistrées.
  • How rules apply : les actions et ce à quoi chacune correspond.
  • Recent decisions : les derniers refus, mises en attente et résultats en mode log-only, avec View session.

La page est affichée aux rôles dotés de la permission policy-manage : Owner, Admin et Security Admin par défaut.

Format d'une règle

Vous modifiez les règles dans un formulaire, une carte par règle, ou sous forme de tableau JSON dans l'onglet Advanced (JSON). Chaque règle a ces champs :

ChampObligatoireCe que c'est
idOui1–64 caractères : lettres, chiffres, ., _, : ou -. Unique.
actionOuiL'une des actions ci-dessous, ou * pour toutes les actions.
decisionOuiallow, ask (nécessite une approbation) ou deny.
resourceNonUn glob comparé à ce que l'action touche. Omis, il signifie tout.
descriptionNonJusqu'à 500 caractères, affichés sous l'identifiant de la règle.
enabledNonfalse conserve la règle mais l'empêche de s'appliquer.

Dans le formulaire, ce sont Rule ID, Action, Decision, Resource, Description et la case à cocher On. Une politique peut contenir jusqu'à 200 règles.

Actions

ActionLibelléRessource à laquelle elle correspondQuand elle est vérifiéeDécisions
workflow.dispatchStart a sessionidentifiant du workflowAu démarrage d'une sessionallow, ask, deny
agent.dispatchRun an agent stepidentifiant de l'agent, p. ex. builderAu démarrage d'une session, pour chaque agent qu'elle exécuteraallow, ask, deny
mcp.invokeCall an MCP toolserver/toolAu démarrage d'une session, pour chaque outil MCP connectéallow, deny
shell.commandRun the test commandla commandeAvant que la session exécute vos testsallow, deny
diff.applyChange a filechemin de fichier, p. ex. infra/**À l'ouverture de la pull request, pour chaque fichierallow, ask, deny
github.pushOpen a pull requestowner/repoÀ l'ouverture de la pull requestallow, ask, deny
release.deployDeploy automaticallynom de l'environnementAvant un déploiement automatique après une fusionallow, deny

Certaines actions ne peuvent pas attendre une personne : elles ne peuvent donc pas utiliser ask. L'éditeur refuse un ask sur elles. Un ask déjà stocké sur l'une d'elles est appliqué comme un deny.

Ce que fait chaque décision :

  • Démarrage de session (workflow.dispatch, agent.dispatch) : deny refuse la session. ask la retient jusqu'à ce que quelqu'un l'approuve sous Review & Gate → Approvals ; la rejeter ou la laisser expirer l'annule.
  • Outils MCP : un outil qui n'est pas autorisé n'est jamais proposé aux agents.
  • Pull request (github.push, diff.apply) : deny refuse la pull request. ask exige une revue approuvée du changement. La session s'exécute tout de même et propose son changement ; la règle décide s'il peut aboutir.
  • Déploiement automatique : tout ce qui n'est pas allow arrête le déploiement. Il est enregistré comme un déploiement bloqué, pour que vous puissiez voir qu'il n'est pas parti.

Comment les règles sont évaluées

  1. Chaque règle activée dont l'action correspond (ou vaut *) et dont la resource correspond est prise en compte.
  2. La décision la plus stricte l'emporte : deny l'emporte sur ask, et ask l'emporte sur allow. L'ordre des règles ne compte pas.
  3. Si aucune règle ne correspond, le réglage de confiance décide.

Globs de ressource

  • ** correspond à tout, y compris /.
  • * correspond à n'importe quelle suite de caractères. Pour les chemins de fichiers, server/tool et owner/repo, il s'arrête à /.
  • ? correspond à un caractère.
  • L'absence de resource, * ou ** correspond à tout.

Ainsi, src/*.ts correspond à src/app.ts mais pas à src/lib/app.ts ; utilisez src/** pour le dossier entier.

Réglage de confiance

Le réglage de confiance s'applique lorsqu'aucune règle ne correspond.

RéglageDécisions par défaut
trustedTout est autorisé.
limited (par défaut)Comme trusted, mais l'ouverture d'une pull request est ask.
nonedeny pour les outils MCP, la commande de test, les modifications de fichiers, les pull requests et les déploiements automatiques, sauf autorisation.

Chaque session qui modifie du code reçoit aussi une demande de revue sous Review & Gate → Approvals. Le réglage de confiance s'y ajoute ; il ne la supprime pas.

Exemple

Cette politique retient les mises à niveau de dépendances pour approbation, demande une revue de tout changement apporté aux fichiers d'infrastructure, bloque les déploiements automatiques en production et tient un outil MCP à l'écart des agents. Elle est présentée sous la forme du JSON que vous verriez dans l'onglet Advanced (JSON) :

[
  {
    "id": "approve-dependency-refresh",
    "action": "workflow.dispatch",
    "resource": "dependency-refresh",
    "decision": "ask",
    "description": "A person approves before a dependency upgrade session starts"
  },
  { "id": "review-infra-changes", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
  { "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" },
  { "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }
]

Modifier la politique

  1. Ouvrez Secure → Policies et choisissez Edit rules.
  2. Choisissez un Trust posture.
  3. Dans l'onglet Form, modifiez les champs d'une règle, choisissez Add rule pour en créer une, ou Remove pour en supprimer une. Décochez la case On pour conserver une règle sans l'appliquer. L'ordre des règles ne compte pas.
  4. Choisissez Save (version → N).

Pour modifier les règles sous forme de texte, ouvrez l'onglet Advanced (JSON). Les deux onglets modifient les mêmes règles : une modification faite dans l'un est donc présente lorsque vous passez à l'autre. Si le JSON ne peut pas être lu, ou contient quelque chose pour lequel le formulaire n'a pas de champ, la page reste sur l'onglet Advanced et indique ce qu'il faut corriger.

Si une règle présente un problème, rien n'est enregistré et chaque problème est listé avec sa règle et son champ, par exemple Rule 2 (no-repo-deletes), Decision: "Call an MCP tool" (mcp.invoke) can't wait for an approval, so it can't use ask. Choose allow or deny. Dans le formulaire, chaque message apparaît aussi sous son champ. Si quelqu'un d'autre a enregistré pendant que vous modifiiez, vous voyez « Policy conflict » et vos modifications ne sont pas enregistrées. Vos modifications restent dans l'éditeur pour que vous puissiez les copier ; choisissez Cancel pour charger sa version, puis refaites votre modification.

Chaque enregistrement crée une nouvelle version et une entrée policy.updated dans le journal d'audit.

Comparer des versions

What changed between versions montre la différence entre deux versions enregistrées de la politique. Il s'ouvre sur la version précédente comparée à la version actuelle ; choisissez deux autres versions quelconques sous From et To. Vous voyez :

  • les règles qui ont été Added, Removed ou Changed, avec chaque champ modifié avant et après ;
  • le Trust posture, lorsqu'il a changé.

Les règles sont appariées par identifiant, et leur ordre est ignoré. Les versions sont conservées à partir du premier enregistrement effectué après l'ajout de cette comparaison. Une politique enregistrée pour la dernière fois avant cela n'a qu'une version à montrer tant qu'elle n'est pas enregistrée de nouveau.

Mode log-only

Choisissez Switch to log only pour cesser d'appliquer la politique sans supprimer de règles. Chaque décision est toujours calculée et enregistrée, affichée comme « logged » sous Recent decisions, mais rien n'est bloqué ni retenu. Choisissez Enforce pour la réactiver. Utilisez le mode log-only pendant que vous ajustez une nouvelle politique.

Seules les décisions autres qu'un simple allow sont enregistrées.

Étapes suivantes

Questions fréquentes

L'ordre de mes règles compte-t-il ?

Non. Chaque règle correspondante est prise en compte et la décision la plus stricte l'emporte, de sorte qu'ajouter une règle ne peut jamais en assouplir une plus ancienne.

Les politiques limitent-elles ce que les personnes peuvent faire ?

Non. Les politiques régissent ce que les sessions IA peuvent faire. Ce qu'une personne peut faire est défini par son rôle.

Puis-je tester une politique sans bloquer personne ?

Oui. Choisissez Switch to log only. Les règles sont toujours évaluées et chaque décision est enregistrée, mais rien n'est bloqué ni retenu.

Cette page vous a-t-elle été utile ?