Aller au contenu
Documentation

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.

Appuyez sur Shift+Tab pour faire défiler les modes. Le mode actuel s’affiche dans la ligne d’état .

ModeModifications de fichiersCommandes
ask (par défaut)Demander à chaque foisDemander à chaque fois
accept-editsExécuter sans demander de confirmation au sein de l’espace de travailDemander à nouveau
planRefusé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.

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é.

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 exemple local_mcp__github__* pour chaque outil d’un serveur MCP local.
  • A local_read_file(...) règle de refus, ou une deny_read liste, 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.

FichierPortée
--allowed-tools indicateurCette session uniquement
$CONFIG/ai/projects/<id>.jsonVos réponses enregistrées pour ce projet (« ne plus poser la question », /permissions)
.champrep/settings.local.jsonVous, dans ce projet (ajouté à .gitignore automatiquement)
.champrep/settings.jsonTous les participants à ce projet (effectuez un commit pour le partager)
$CONFIG/ai/settings.jsonVous, 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.

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 .env fichiers (à l’exception de .env.example), des clés privées et des certificats tels que *.pem, *.key, *.p12, et id_rsa*, .npmrc, .pypirc, .netrc, votre ~/.aws, ~/.ssh, et ~/.gnupg dossiers, 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 register et 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.

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é.
  • /trust affiche l’état actuel ; /trust approve et /trust revoke la modifier.

Les validations sont stockées dans $CONFIG/ai/trusted-projects.json.

Avant chaque modification, l’agent enregistre l’état précédent du fichier sur votre machine.

CommandeEffet
/diffAfficher toutes les modifications de fichiers effectuées au cours de cette session.
/undoAnnule la dernière série de modifications.
/rewindSé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.

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.