- Accueil
- Documentation
- Approbations et politiques
Approbations et politiques
Fixez ce que les sessions IA peuvent faire avec des règles de politique (allow, ask, deny), et voyez comment fonctionnent les approbations humaines : qui peut approuver, expiration et rejets.
Les politiques déterminent ce qu'une session IA peut faire seule et ce qui nécessite une personne. Les approbations sont l'endroit où cette personne dit oui ou non. Les deux sont enregistrées dans le journal d'audit et dans le dossier de preuves du changement.
Politique de l'espace de travail
Ouvrez Secure → Policies. La page indique si la politique est Enforced ou Log only, le réglage de confiance, les règles en vigueur, la version et les décisions récentes. Les rôles Owner, Admin et Security Admin peuvent la modifier (permission policy-manage).
Réglage de confiance
Le réglage de confiance s'applique lorsqu'aucune règle ne correspond. Quel que soit ce réglage, le changement de code d'une session a toujours besoin d'une revue approuvée avant l'ouverture de sa pull request (voir Approbations ci-dessous).
| Réglage | Ce qu'il signifie |
|---|---|
| Trusted | Tout ce qu'une règle ne restreint pas est autorisé. |
| Limited (par défaut) | Comme Trusted, mais l'ouverture d'une pull request est un ask : elle nécessite d'abord une revue approuvée. |
| None | Les sessions peuvent toujours écrire un changement proposé, mais ne peuvent pas appeler d'outils MCP, exécuter la commande de test, ouvrir une pull request ni déployer, sauf si une règle l'autorise. |
Règles
Chaque règle a une action, une décision (allow, ask ou deny) et un motif de ressource facultatif. La règle correspondante la plus stricte l'emporte : deny l'emporte sur ask, ask l'emporte sur allow.
| Action | Libellé | Ressource | Ask possible ? |
|---|---|---|---|
workflow.dispatch | Start a session | workflow | Oui |
agent.dispatch | Run an agent step | agent | Oui |
diff.apply | Change a file | chemin, p. ex. infra/** | Oui |
github.push | Open a pull request | owner/repo | Oui |
mcp.invoke | Call an MCP tool | server/tool | Non |
shell.command | Run the test command | commande | Non |
release.deploy | Deploy automatically | environnement | Non |
Les chemins protégés sont des règles diff.apply avec un motif de fichier. Ils sont vérifiés à l'ouverture d'une pull request, sur chaque fichier que le changement touche ; la session écrit tout de même le changement. Les déploiements automatiques après une fusion sont des règles release.deploy. Une action qui ne peut pas attendre une personne ne peut pas utiliser ask ; l'éditeur le refuse.
Choisissez Edit rules pour modifier le réglage de confiance et les règles, puis enregistrez. Les règles se modifient dans un formulaire, une carte par règle, ou en JSON dans l'onglet Advanced (JSON) ; les problèmes sont listés par règle et par champ avant tout enregistrement. Chaque enregistrement crée une nouvelle version et une entrée d'audit, et What changed between versions montre les règles ajoutées, supprimées et modifiées entre deux versions quelconques. Consultez la référence des règles de politique. Switch to log only continue d'évaluer les règles et enregistre ce qu'elles auraient fait, sans rien bloquer. C'est utile pendant que vous ajustez une nouvelle politique.
Approbations
Une demande d'approbation est ouverte pour vous lorsque :
- une session produit un changement de code (chaque changement nécessite une revue, quel que soit le réglage de confiance) ;
- le démarrage d'une session rencontre une règle ask (la session attend à l'état held jusqu'à ce que la demande soit tranchée) ;
- une pull request est demandée pour un changement qui nécessite une revue et n'en a pas encore.
Ouvrez Review & Gate → Approvals. Pending requests liste chaque demande avec le nombre d'approbations qu'elle nécessite et sa date d'expiration. Choisissez Review the proposed changes pour voir le diff, puis Approve (une note facultative) ou Reject (un motif est obligatoire). La page de l'exécution propose la même décision avec Accept changes et Reject.
Le changement de code d'une session affiche sa vérification de livraison à côté des boutons : prêt, ou pas prêt avec les motifs (tests en échec, constats high ou critical ouverts). Approuver un changement dont la vérification n'est pas prête demande d'abord un motif. Ce motif est conservé sur le vote, dans le journal d'audit et dans le dossier de preuves. Cela enregistre votre approbation et rien de plus : la pull request reste fermée tant que la vérification ne passe pas. Un rejet n'a jamais besoin de la vérification.
Lorsque la dernière approbation est donnée, la plateforme tente d'ouvrir la pull request. Si elle n'y parvient pas (la vérification de livraison, ou l'hébergeur Git qui refuse le push), vous êtes informé de la raison, et la page de la session affiche le même motif.
Qui peut approuver
Les rôles Owner, Admin et Security Admin peuvent approuver par défaut ; un rôle personnalisé peut aussi recevoir cette permission. Une demande peut également désigner des approbateurs précis.
La personne qui a lancé une session ne peut pas approuver son changement lorsque quelqu'un d'autre dans l'espace de travail le peut. Rejeter est toujours autorisé. Vous travaillez seul ? Un espace de travail avec un seul approbateur approuve ses propres changements, et la piste d'audit les marque comme auto-approuvés.
Une petite équipe dont l'autre approbateur est souvent absent peut activer Let the person who launched a change approve it sous Settings → Change approvals. Ce réglage est désactivé par défaut, et seuls les rôles Owner, Admin et Security Admin peuvent le modifier. Chaque approbation qu'il permet est marquée « Self-approved — allowed by workspace setting » sur le changement, dans le journal d'audit et dans le dossier de preuves.
Règles de la décision
- Une revue de changement de code nécessite une approbation, donnée par quelqu'un d'autre que la personne qui a lancé la session (lorsque l'équipe compte quelqu'un d'autre qui peut approuver). Cela en fait une règle des deux personnes. Les approbations sont comptées par personne distincte, et voter de nouveau remplace votre vote précédent.
- Un seul rejet met fin à la demande, à l'état rejected. Elle n'est pas rouverte par l'approbation de quelqu'un d'autre.
- Les revues de changement de code expirent au bout de 7 jours ; un démarrage de session à l'état held expire au bout de 3 jours. Après l'expiration, utilisez Request approval again sur la page de l'exécution.
- Modifier un changement après son approbation remet son approbation à pending.
- Approuver un changement de code ouvre sa pull request, si la barrière qualité passe elle aussi.
Étapes suivantes
Questions fréquentes
Puis-je approuver un changement issu d'une session que j'ai lancée ?
Pas si quelqu'un d'autre dans l'espace de travail peut approuver, sauf si un administrateur a activé « Let the person who launched a change approve it » dans Settings. Un espace de travail sans autre approbateur peut toujours approuver ses propres changements. Dans les deux cas, l'approbation est marquée comme auto-approuvée.
Que se passe-t-il quand une approbation expire ?
Le changement reste bloqué. Sur la page de l'exécution, vous pouvez choisir Request approval again pour ouvrir une nouvelle revue.