Autorisations et sécurité de l’agent IA
L’agent se contente de proposer des actions. Chaque modification de fichier et chaque commande fait l’objet d’un contrôle d’autorisation sur votre machine avant que quoi que ce soit ne se produise, et rien ne peut désactiver ce contrôle.
Ce qui se produit toujours sans demande de confirmation
Section intitulée « Ce qui se produit toujours sans demande de confirmation »Les outils en lecture seule s’exécutent librement dans l’espace de travail : lecture de fichiers, liste des répertoires, recherche et lecture seule git commandes telles que status, diff, et log. L’espace de travail correspond au répertoire dans lequel vous avez lancé l’agent, ainsi qu’à tout répertoire ajouté avec --add-dir ou /add-dir. Les chemins d’accès situés en dehors de celui-ci, ..
Les échappements et les liens menant à l’extérieur sont refusés.
Modes d’autorisation
Section intitulée « Modes d’autorisation »Appuyez sur Shift+Tab pour faire défiler les modes. Le mode actuel s’affiche dans la ligne d’état .
| Mode | Modifications de fichiers | Commandes |
|---|---|---|
ask (par défaut) | Demander à chaque fois | Demander à chaque fois |
accept-edits | Exécuter sans demander de confirmation au sein de l’espace de travail | Demander à nouveau |
plan | Refusé | Refusé |
En plan En mode , l’agent recherche et décrit les modifications au lieu de les effectuer. /plan Passe en mode « plan » pour une demande de planification.
Définissez le mode de démarrage à l’aide de --permission-mode, avec /permissions mode MODE, ou avec defaultMode dans un fichier de paramètres. Il n’existe aucun mode permettant de contourner toutes les vérifications d’autorisation.
Répondre à une invite d’autorisation
Section intitulée « Répondre à une invite d’autorisation »Une invite indique exactement ce qui va se passer : le diff pour une modification, la ligne de commande complète et le répertoire de travail pour une commande, ou le serveur et les arguments pour un outil MCP. Vous pouvez choisir :
- Oui pour l’exécuter une fois.
- Oui, et ne plus poser la question pour ce préfixe de commande ou ce modèle de fichier dans ce projet. La règle est enregistrée dans vos propres paramètres pour ce projet, sous
$CONFIG/ai/projects/, jamais dans le référentiel. - Non, et expliquez à l’IA pourquoi, afin que l’agent puisse s’adapter.
Certains appels font toujours l’objet d’une demande, et aucune règle ne peut les autoriser : les commandes qui font référence à des fichiers secrets ou à des magasins d’identifiants, les modifications apportées à .champrep/ ou
.git/ éléments internes et commandes trop complexes pour être analysés en toute sécurité.
Règles d’autorisation et de refus
Section intitulée « Règles d’autorisation et de refus »Les règles se présentent sous la forme Tool ou Tool(pattern):
{ "permissions": { "allow": ["local_bash(npm test*)", "local_bash(go test ./...)", "local_edit_file(src/**)"], "deny": ["local_bash(git push*)", "local_bash(rm -rf*)", "local_read_file(secrets/**)"], "defaultMode": "ask" }}- Règles de commande tels que
local_bash(npm test*)correspondent à la ligne de commande. Les commandes reliées par;,&&,||,|, ou les substitutions sont fractionnées, et chaque doit être autorisée. - Règles de chemin d’accès tels que
local_edit_file(src/**)correspondent aux chemins d’accès relatifs à l’espace de travail.*reste dans un seul dossier ;**s’applique à tous les dossiers. - Noms des outils pouvez utiliser
*, par exemplelocal_mcp__github__*pour chaque outil d’un serveur MCP local. - A
local_read_file(...)règle de refus, ou unedeny_readliste, masque également ces fichiers à tous les outils de lecture et de recherche.
Gérer les règles sans modifier les fichiers :
/permissions/permissions allow local_bash(npm run lint*)/permissions deny local_bash(git push*)/permissions remove local_bash(npm run lint*)/permissions mode accept-edits/permissions allow, deny, et remove modifiez vos réponses enregistrées pour ce projet (sous $CONFIG/ai/projects/). Modifiez les autres fichiers directement.
Fichiers de paramètres et priorité
Section intitulée « Fichiers de paramètres et priorité »| Fichier | Portée |
|---|---|
--allowed-tools indicateur | Cette session uniquement |
$CONFIG/ai/projects/<id>.json | Vos réponses enregistrées pour ce projet (« ne plus poser la question », /permissions) |
.champrep/settings.local.json | Vous, dans ce projet (ajouté à .gitignore automatiquement) |
.champrep/settings.json | Tous les participants à ce projet (effectuez un commit pour le partager) |
$CONFIG/ai/settings.json | Vous, dans chaque projet |
Les entrées antérieures ont la priorité. Les règles de refus, quel que soit le fichier d’origine, prévalent toujours. Vos réponses enregistrées s’appliquent immédiatement car elles se trouvent en dehors du référentiel. Autorisez les règles et defaultMode dans les deux .champrep/ Les fichiers ne prennent effet qu’après que vous ayez accordé votre confiance au projet .champrep/ configuration (voir
Confiance dans les référentiels) ; les règles de refus qu’elles contiennent s’appliquent toujours. Placez les règles d’autorisation souhaitées n’importe où dans vos paramètres utilisateur. Les limites de votre forfait s’appliquent à chaque fichier, et aucun élément local ne peut les augmenter.
Exécuter champrep ai paths pour voir où $CONFIG se trouve sur votre machine.
Protection des secrets
Section intitulée « Protection des secrets »Ces règles sont appliquées par le système CLIlui-même, et non par le modèle :
- Fichiers bloqués. L’agent ne lit jamais, ne répertorie jamais le contenu ni n’envoie jamais
.envfichiers (à l’exception de.env.example), des clés privées et des certificats tels que*.pem,*.key,*.p12, etid_rsa*,.npmrc,.pypirc,.netrc, votre~/.aws,~/.ssh, et~/.gnupgdossiers, le trousseau de clés du système d’exploitation et la configuration propre CLIau . Le modèle est informé que le fichier est bloqué ; il n’en voit jamais le contenu. - Expurgation. Les sorties des outils sont analysées avant de quitter votre machine. Les secrets à haut niveau de confiance, tels que les clés d’accès au cloud, les jetons de contrôle de source, les clés de prestataires de paiement, les clés de prestataires d’IA, les blocs de clés privées et les jetons au porteur sont remplacés par
[REDACTED:<kind>]. - Clés collées. Si une invite contient un élément ressemblant à un secret, celui-ci n’est pas envoyé. Enregistrez les clés de modèle auprès de
/model registeret les identifiants MCP avec/mcpà la place. - Pas d’héritage des identifiants. Les commandes exécutées par l’agent, les hooks et les serveurs MCP locaux ne reçoivent jamais vos identifiantsCHAMPREP ni
CHAMPREP_*variables.
Ajoutez vos propres chemins d’accès bloqués à l’aide de deny_read ou local_read_file(...) Règles de refus . La liste intégrée peut être étendue, mais jamais assouplie.
Confiance dans les référentiels
Section intitulée « Confiance dans les référentiels »Un référentiel peut contenir la configuration d’un agent sous forme de .champrep/: commandes personnalisées, compétences, agents, hooks, serveurs MCP et paramètres de projet. L’ouverture d’un référentiel inconnu ne doit en aucun cas exécuter ces éléments ; ce contenu reste donc inactif jusqu’à ce que vous l’approuviez.
- Lorsqu’un projet contient ce type de contenu, l’agent vous demande une seule fois si vous souhaitez lui faire confiance et affiche son contenu.
- Si le contenu venait à changer par la suite, votre accord vous serait à nouveau demandé.
/trustaffiche l’état actuel ;/trust approveet/trust revokela modifier.
Les validations sont stockées dans $CONFIG/ai/trusted-projects.json.
Points de contrôle, diff et annulation
Section intitulée « Points de contrôle, diff et annulation »Avant chaque modification, l’agent enregistre l’état précédent du fichier sur votre machine.
| Commande | Effet |
|---|---|
/diff | Afficher toutes les modifications de fichiers effectuées au cours de cette session. |
/undo | Annule la dernière série de modifications. |
/rewind | Sélectionner un message antérieur et restaurer les fichiers à leur état antérieur à celui-ci. Esc La commande « deux fois » l’ouvre également. |
/rewind ne restaure que les fichiers ; la conversation elle-même reste inchangée. Les points de contrôle sont supprimés à la fin de la session, sauf si vous commencez par
--keep-checkpoints. Les modifications effectuées par des commandes shell, par exemple un générateur de code exécuté via local_bash, ne sont pas comptabilisés ; utilisez git pour ces derniers.
Actions dans les servicesCHAMPREP
Section intitulée « Actions dans les servicesCHAMPREP »Les actions qui modifient les données dans vos CHAMPREPservices, telles que l’envoi d’un e-mail, suivent le même processus de validation que l’application web. L’agent affiche une fiche de validation, et vous choisissez Approuver, Rejet, ou Décider plus tard. Ces actions ne sont jamais approuvées automatiquement, quel que soit le mode d’autorisation local. Lors des exécutions sans interface graphique , elles restent en attente de votre validation dans l’application webCHAMPREP.
/services indique les servicesCHAMPREP que l’IA est susceptible d’utiliser. Modifiez cette liste dans vos paramètresCHAMPREP AI sur le Web.