Passer au contenu principal
Afficher en Markdown

Autorisations

Kiro utilise un système d'autorisations basé sur les capacités qui vous offre un contrôle déclaratif et précis sur ce que l'agent peut faire. Vous définissez des règles par capacité avec des modèles de correspondance et des effets explicites, remplaçant les anciens modèles de confiance binaires.

CapacitéIDECLIWebMobile
Configuration YAML des autorisations✓✓N/A—
Invites d'approbation interactives✓✓✓—
Portées globales et d'espace de travail✓✓N/A—
Bac à sable infonuagique géré au lieu d'invites d'autorisationN/AN/A✓—

Sur Web, le modèle permissions.yaml ne s'applique pas : l'agent s'exécute dans un bac à sable infonuagique isolé et approuve chaque action par défaut. Ces lignes indiquent donc N/A plutôt qu'une absence de prise en charge. Lorsqu'Approve for me est activé, Web peut aussi vous demander avant qu'une action s'exécute.

Fonctionnement

Le système d'autorisations repose sur trois concepts fondamentaux :

ConceptDescription
Capacitésfs_read, fs_write, shell, web_fetch, web_search, mcp, subagent, skill, power, context, diagnostics, sandbox_network. Les méta-capacités s'étendent : all (toutes les capacités sauf sandbox_network), builtin (tous les outils intégrés), filesystem (fs_read + fs_write)
Effetsdeny (bloquer toujours), ask (vous demander), allow (procéder silencieusement), evaluate (Kiro juge l'action ; l'effet le plus faible, ajouté par le préréglage approve-for-me et actif seulement lorsque le classificateur de confiance est disponible)
Prioritédeny > ask > allow > evaluate pour les actions d'outils. Le filtrage des hôtes du bac à sable a des règles distinctes, y compris la priorité des refus de l'organisation; consultez Règles réseau du bac à sable

Propriétés de règle supplémentaires :

PropriétéDescription
Modèles de correspondanceModèles glob qui déterminent la portée de la règle (chemins de fichiers pour fs, préfixes de commande pour shell, noms de serveur/outil pour MCP)
ExcludeModèles glob facultatifs qui ne doivent PAS correspondre - permet « tout autoriser sauf X »

Règles réseau du bac à sable

La capacité sandbox_network ne s'applique que lorsque le bac à sable de commandes local est actif. Ses règles allow et deny nomment les hôtes que les commandes shell exécutées en bac à sable peuvent atteindre, et vos règles fs_read et fs_write déterminent les chemins que ces commandes peuvent voir et écrire. Elle est exclue de la méta-capacité all.

Placez les refus sandbox_network précis avant les autorisations génériques plus larges pour la compatibilité avec les filtres d'hôtes fondés sur la première correspondance. La préséance du refus régit toujours la question de savoir si l'agent peut exécuter une action d'outil. Consultez Bac à sable de commandes local pour les modèles d'hôtes et les modes réseau.

Les contrôles du bac à sable Enterprise Management exigent Kiro CLI 3.4.0 ou version ultérieure ou Kiro IDE 1.4.215 ou version ultérieure. Un refus réseau correspondant de l'organisation l'emporte sur une autorisation du développeur. Les règles KGL builtin et all nomment aussi sandbox_network; l'exclusion ci-dessus décrit le fichier local permissions.yaml, pas KGL. Voir Contrôles du bac à sable Enterprise Management.

Définition des règles

Les autorisations sont définies dans des fichiers YAML à deux niveaux :

Portée utilisateur (~/.kiro/settings/permissions.yaml) - s'applique à tous les projets. Utilisez-la pour approuver au préalable des opérations fiables :

yaml
rules: - capability: shell match: ["git *", "npm *", "npx *"] effect: allow - capability: fs_write match: ["src/**", "tests/**"] effect: allow - capability: fs_read effect: allow - capability: mcp match: ["my-server/*"] effect: allow

Portée d'espace de travail (~/.kiro/workspace-roots/<hash>/permissions.yaml) - s'applique uniquement à un projet précis. Utilisez-la pour restreindre des règles à une seule base de code :

yaml
rules: - capability: fs_write match: ["*.env", "*.pem", "*.key"] effect: deny - capability: shell match: ["rm -rf *", "sudo *"] effect: deny

Les deux portées prennent en charge tous les effets (deny, ask, allow et evaluate).

Syntaxe Exclude

Les règles prennent en charge un champ exclude pour les modèles « tout autoriser sauf » :

yaml
rules: - capability: mcp match: ["my-server/*"] exclude: ["my-server/dangerous-tool"] effect: allow

Correspondance de modèles

Les règles utilisent des modèles glob. La syntaxe diffère selon le type de capacité :

Modèles de système de fichiers (fs_read, fs_write) :

  • * correspond à l'intérieur d'un seul composant de chemin
  • ** correspond à travers les séparateurs de chemin
  • L'expansion d'accolades {a,b} et les classes de caractères [abc] sont prises en charge
  • Les modèles sans caractères génériques correspondent implicitement aux enfants : ~/temp correspond à ~/temp/child

Modèles Shell, Web et MCP :

  • * correspond à toute séquence de caractères
  • **, ? et les classes de caractères ne sont pas prises en charge
yaml
rules: # Allow npm commands except npm publish - capability: shell effect: allow match: - "npm *" exclude: - "npm publish*" # Deny reads to secrets at any depth - capability: fs_read effect: deny match: - "**/.env" - "**/.env.*" - "secrets/**" - "**/*.pem"

Analyse des commandes shell

Les commandes shell sont analysées avant la correspondance de modèles. Les commandes composées (utilisant ;, &&, ||, |) sont scindées, et chaque sous-commande est évaluée indépendamment. Cela empêche une règle pour npm test * de correspondre accidentellement à npm test ; curl attacker.com.

L'analyseur évalue les indicateurs à l'intérieur des options courtes combinées, de sorte qu'une commande comme grep -iP demande toujours une approbation lorsqu'un de ses indicateurs l'exige. Les options qui peuvent lancer un autre programme ne sont jamais traitées comme étant en lecture seule : tar --use-compress-program et tar --to-command demandent une approbation même lorsque la commande de base tar est approuvée.

Dans Kiro IDE 1.4.51 ou une version ultérieure et dans les sessions Kiro CLI V3, Kiro bloque les commandes bash ou PowerShell qu'il ne peut pas analyser assez précisément pour les vérifier selon vos règles d'autorisation. Il demande à l'agent de réécrire la commande au lieu de vous demander d'approuver une commande non vérifiée. Les commandes cmd.exe demandent toujours une approbation. Une règle qui demande une approbation pour chaque commande shell affiche toujours son invite habituelle lorsqu'aucune règle shell deny ne s'applique. Une règle allow ou deny inconditionnelle tranche toujours sans analyse. Si une commande valide reste bloquée après quelques réécritures, l'agent vous indique qu'il n'a pas pu la vérifier.

Portées

Les autorisations sont évaluées à travers plusieurs portées. Le tableau liste les portées que vous configurez ou rencontrez directement ; ce n'est pas un inventaire de toutes les portées que définit le moteur d'autorisations.

PortéeEmplacementEffets autorisés
KiroInvariants de sécurité codés en dur (ne peuvent pas être modifiés par la configuration)deny, ask
administrationPolitiques d'autorisations Enterprise dans managed-settings.jsondeny, ask
user~/.kiro/settings/permissions.yamldeny, ask, allow, evaluate
workspace~/.kiro/workspace-roots/<hash>/permissions.yamldeny, ask, allow, evaluate
agentIntégré dans le profil de l'agent (champ permissions)deny, ask, allow, evaluate
sessionRègles en mémoire issues des décisions de consentement prises pendant la sessiondeny, ask, allow, evaluate

Les règles sont évaluées à l'aide d'un algorithme de préséance du refus : deny > ask > allow > evaluate. Il n'y a pas de préséance entre les portées - l'effet le plus restrictif l'emporte, quelle que soit la portée dont il provient. evaluate est l'effet qu'ajoute le préréglage approve-for-me lorsqu'il est listé sous policies: dans un fichier d'autorisations user ou workspace ; consultez Préréglages de politique. Pour sandbox_network, placez les refus précis avant les autorisations génériques plus larges pour la compatibilité avec les filtres d'hôtes fondés sur la première correspondance. Voir Règles réseau du bac à sable pour les règles de refus de l'organisation.

Sous-agents

Kiro vérifie chaque appel d'outil d'un sous-agent par rapport à la politique de la session parente et aux propres permissions du sous-agent. Le résultat le plus strict l'emporte :

  • Un deny de l'une ou l'autre politique refuse l'appel.
  • Une règle ask dans l'une ou l'autre politique vous demande une approbation.
  • Si la politique de la session parente n'a aucune règle pour l'appel, Kiro vous demande une approbation, même lorsque les propres règles du sous-agent l'autorisent.

Un appel que les règles du sous-agent ne mentionnent pas suit la politique de la session parente. Les règles allow d'un sous-agent n'accordent jamais plus que ce que la session parente autorise. Une règle de capacité subagent contrôle seulement si un sous-agent peut démarrer sans invite. Consultez Autorisations des sous-agents.

Préréglages de politique

Les préréglages de politique sont des ensembles nommés et composables de règles. Chaque préréglage sauf approve-for-me se compose uniquement de règles allow. Un préréglage atteint une session par l'un de deux chemins, et le chemin détermine sa portée :

  • Demandé par un client. Tout client ACP, y compris les surfaces propres à Kiro et les intégrations tierces compatibles comme les intégrations d'éditeur, les robots de revue et les harnais de CI, peut demander les préréglages composés uniquement de règles allow lorsqu'il ouvre une session. Leurs règles sont amorcées à la portée session et conservées en mémoire seulement.
  • Listé dans un fichier d'autorisations. Un préréglage nommé sous policies: dans un permissions.yaml user ou workspace est développé à la portée de ce fichier et persiste avec le fichier. Dans Kiro CLI 2.36 ou une version ultérieure, c'est ainsi que l'option approve for me sous /permissions active approve-for-me : elle écrit le préréglage dans le fichier d'autorisations de l'espace de travail.

approve-for-me est l'exception à la règle du allow seulement. Il ajoute une règle evaluate pour chaque capacité en plus d'un ensemble délimité de règles allow, et il dépend du classificateur de confiance de Kiro : lorsque le classificateur n'est pas disponible, le préréglage ne contribue aucune règle et la session continue de demander. Activez-le avec l'option approve for me sous /permissions dans une session Kiro CLI V3, là où cette option apparaît, ou avec le commutateur Approve for me dans Kiro Web; consultez Approve for me.

Application des préréglages demandés par un client

Un client ACP demande des préréglages dans le champ _meta.kiro.policyPreset d'une requête session/new ou session/load. Plusieurs préréglages peuvent être combinés ; leurs règles sont fusionnées par union.

json
{ "_meta": { "kiro": { "policyPreset": ["edit-workspace", "dev-shell"] } } }

Les règles de préréglage demandées par un client sont amorcées dans la session au moment où le client l'ouvre, indépendamment des règles que vous avez configurées dans permissions.yaml. C'est pourquoi les règles actives d'une session peuvent contenir des entrées que vous n'avez jamais écrites.

Demander un identifiant de préréglage inconnu entraîne le rejet de la demande de session. Il n'y a pas de repli silencieux vers une politique par défaut.

Préréglages disponibles

ID de préréglageRègles qu'il contribue
allow-allToutes les capacités sauf sandbox_network (équivalent à capability: all, effect: allow)
edit-workspacefs_read et fs_write dans ./** seulement
read-workspacefs_read dans ./** seulement
read-allfs_read partout, plus web_fetch et web_search
read-only-shellCommandes shell en lecture seule : information système plus les requêtes git, cargo, npm, docker, kubectl et rustup
dev-shellCommandes shell en lecture seule (l'ensemble read-only-shell) plus les commandes git d'écriture ; outils de construction cargo, npm, bun, yarn ; opérations d'espace de travail mkdir, touch, mv, cp ; commandes d'inspection ls, cat, grep, echo
approve-for-meLes ensembles edit-workspace et read-only-shell, plus une règle evaluate pour chaque capacité, de sorte que Kiro juge chaque action qu'aucune règle deny, ask ou allow ne règle. Nécessite le classificateur de confiance; lorsqu'il n'est pas disponible, ce préréglage ne contribue aucune règle. Dans Kiro CLI 2.36 ou une version ultérieure, choisir approve for me sous /permissions dans une session V3 liste ce préréglage sous policies: dans le fichier d'autorisations de l'espace de travail, de sorte que ses règles s'appliquent à la portée workspace. Dans Kiro Web, le commutateur Approve for me l'applique aux nouvelles sessions; consultez Approve for me

Choisir des préréglages pour une session

Les préréglages composés uniquement de règles allow suppriment les invites pour les opérations que la session doit effectuer, et tout le reste déclenche une invite d'approbation par défaut. Choisissez le profil le plus étroit qui correspond au travail de la session. approve-for-me n'est pas dans ce tableau : il se choisit sous /permissions dans une session Kiro CLI V3, qui le liste dans le fichier d'autorisations de l'espace de travail plutôt que de le demander pour une seule session, ou avec le commutateur Approve for me dans Kiro Web, et il ne prend effet que lorsque le classificateur de confiance est disponible.

Profil de sessionPréréglagesCe que vous obtenez
Revue de code ou auditread-workspaceLes fichiers de l'espace de travail sont lus silencieusement. Les écritures et les commandes shell demandent toujours une approbation : la session vous sollicite donc avant toute modification.
Investigation et rechercheread-allLecture de fichiers partout sur le disque, plus web_fetch et web_search, pour les sessions qui retracent un problème dans le code et la documentation externe sans avoir besoin d'accès en écriture.
Diagnostic et triageread-workspace + read-only-shellL'agent lit les fichiers de l'espace de travail et interroge l'état de git, docker, kubectl et d'autres outils. Aucune écriture n'est accordée : toute modification demande donc une approbation.
Boucle autonome de compilation et de testedit-workspace + dev-shellL'agent modifie les fichiers de l'espace de travail, exécute les commandes git d'écriture et les outils de construction courants, et crée ou déplace des fichiers dans l'espace de travail sans invite à chaque action. Les écritures hors de l'espace de travail et les commandes non listées demandent toujours une approbation.
Bac à sable jetableallow-allToutes les capacités sont autorisées. Utilisez-le lorsque l'environnement constitue lui-même la limite, par exemple un conteneur supprimé après l'exécution.

Chaque profil se demande de la même façon : les identifiants de préréglage vont dans le tableau policyPreset de la demande de session. Un robot de revue de code ouvre sa session avec :

json
{ "_meta": { "kiro": { "policyPreset": ["read-workspace"] } } }

Une session de diagnostic associe les lectures de l'espace de travail aux requêtes shell en lecture seule :

json
{ "_meta": { "kiro": { "policyPreset": ["read-workspace", "read-only-shell"] } } }

Un harnais de CI qui modifie, compile et teste combine les deux préréglages avec écriture :

json
{ "_meta": { "kiro": { "policyPreset": ["edit-workspace", "dev-shell"] } } }

Les règles deny et les invariants de la portée Kiro ci-dessous s'appliquent toujours, quel que soit le profil actif.

Préréglages dans les clients intégrés et sans interface

Les mêmes profils correspondent aux modèles d'intégration courants. Une intégration d'éditeur qui embarque Kiro demande généralement edit-workspace pour que les modifications de fichiers dans l'espace de travail ne déclenchent pas d'invite. Un robot de revue de code demande read-workspace et rien de plus. Un harnais de CI ou d'évaluation qui pilote l'agent par programmation combine edit-workspace et dev-shell, puis ajoute ses propres règles deny pour tout ce que le pipeline ne doit jamais toucher.

Invariants de confiance

Les préréglages étendent ce qu'une session est autorisée à faire, mais ils ne peuvent pas remplacer des règles de préséance supérieure. L'algorithme de préséance du refus décrit dans la section Portées ci-dessus s'applique toujours intégralement :

  • Les refus absolus de portée Kiro (écritures vers ~/.kiro/settings/, .kiro/settings/, ~/.kiro/workspace-roots/, .kiroignore et les autres magasins énumérés sous Comportement par défaut) bloquent l'action, quel que soit le préréglage.
  • Les règles ask de portée Kiro (.git/**, .vscode/**, **/*.code-workspace, ainsi que les répertoires agents, hooks, workflows et powers sous .kiro et ~/.kiro) demandent toujours une approbation, même lorsqu'un préréglage accorde un accès large en écriture.
  • Toute règle deny que vous avez configurée à la portée user, workspace ou administration l'emporte sur un allow de préréglage.
  • La capacité sandbox_network ne fait pas partie de la méta-capacité all : aucun préréglage, y compris allow-all, ne modifie donc le contrôle réseau du bac à sable.

Comportement par défaut

Sans configuration permissions.yaml, la politique d'agent par défaut autorise :

  • fs_read sur ./** - lire silencieusement n'importe quel fichier de l'espace de travail
  • shell pour les commandes git courantes en lecture seule - git status, git log, git diff, git branch, et similaires
  • shell pour les commandes d'information système - pwd, whoami, uname, et similaires
  • Outils utilitaires (diagnostics, knowledge, et similaires)

La portée Kiro (codée en dur, non modifiable par la configuration) applique :

  • Toujours refusé : les écritures vers ~/.kiro/settings/, .kiro/settings/ et ~/.kiro/workspace-roots/ (empêche l'agent de modifier ses propres fichiers d'autorisation), vers .kiroignore à n'importe quelle profondeur (il définit la propre limite de lecture de l'agent), vers la configuration MCP d'un Power installé (~/.kiro/powers/installed/<name>/mcp.json) et vers les magasins d'état propres à Kiro (~/.kiro/sandbox-state/, ~/.kiro/web-session/, ~/.kiro/cloud-cache/, ~/.kiro/sandbox-curl/)
  • Demande toujours : les écritures vers .git/**, .vscode/**, **/*.code-workspace, ainsi que vers les répertoires agents, hooks, workflows et powers du .kiro de l'espace de travail et de ~/.kiro. Ces écritures demandent une approbation dans les espaces de travail approuvés comme non approuvés, et aucune règle allow de quelque portée que ce soit ne supprime l'invite, à une exception près dans le bac à sable infonuagique géré, décrite sous Confiance de l'espace de travail.
  • Demande tant que l'espace de travail n'est pas approuvé : les écritures vers .kiro/steering, .kiro/skills, .kiro/extensions, le répertoire .kiro/specs lui-même et tout répertoire .kiro que Kiro ne déclare pas, même lorsqu'une règle enregistrée autorise l'écriture. Consultez Confiance de l'espace de travail.

Tout le reste demande une approbation. Créer un fichier permissions.yaml s'ajoute à ces valeurs par défaut ; il ne les remplace pas.

Confiance de l'espace de travail

Certaines entrées de l'agent résident dans le dépôt que vous ouvrez : les profils d'agents personnalisés dans .kiro/agents/, les fichiers Steering dans .kiro/steering/, la configuration des serveurs MCP de l'espace de travail, les Skills et les fichiers Workflow. Un dépôt cloné pourrait s'en servir pour modifier le comportement de l'agent ; Kiro traite donc un espace de travail comme non approuvé jusqu'à ce que vous lui accordiez votre confiance. Votre décision est stockée hors de l'espace de travail, de sorte qu'un dépôt ne peut pas modifier son propre statut de confiance.

Tant que vous n'avez pas approuvé un espace de travail, Kiro :

  • Ne charge pas les agents personnalisés, les fichiers Steering, la configuration des serveurs MCP ni les Skills de l'espace de travail.
  • Ne charge pas les fichiers Workflow provenant de l'espace de travail, y compris les fichiers atteints par un lien depuis vos répertoires de recettes personnels ou dans le nuage. Vos propres Workflows personnels, dans le nuage, intégrés et générés restent disponibles.
  • Demande une approbation avant le démarrage de chaque commande shell, y compris les processus en arrière-plan, même lorsqu'une règle enregistrée ou une règle large autorise la commande. L'invite affiche la commande complète. Une règle deny correspondante refuse toujours.
  • Demande une approbation avant chaque appel d'outil MCP et avant chaque activation, lecture de contenu ou appel d'outil d'un Power, même lorsqu'une règle enregistrée ou autoApprove l'autorise, et demande de nouveau lorsqu'un appel est relancé après une authentification MCP ou une invite d'URL. Une règle deny correspondante refuse toujours.
  • Demande une approbation avant d'écrire dans .kiro/steering, .kiro/skills, .kiro/extensions, le répertoire .kiro/specs lui-même ou tout répertoire .kiro que Kiro ne déclare pas, tant dans l'espace de travail que dans ~/.kiro, même lorsqu'une règle enregistrée autorise l'écriture. Les écritures vers les répertoires agents, hooks, workflows et powers demandent une approbation dans tous les espaces de travail.
  • Refuse sans invite les écritures vers la base de données de mémoires sous ~/.kiro/memories/ et vers le magasin de sessions de l'agent (~/.kiro/sessions/ par défaut), de sorte qu'une session non approuvée ne puisse pas réécrire l'état d'une autre session.
  • N'autorise pas l'agent à ajouter, modifier ou supprimer des mémoires, des bases de connaissances ou des apprentissages distants. Leur lecture fonctionne toujours.

Vos règles user, administration, agent et session s'appliquent toujours, de même que le magasin par espace de travail sous ~/.kiro/workspace-roots/ : il réside hors du dépôt et se charge donc quel que soit le statut de confiance.

La confiance modifie un seul palier d'écritures dans .kiro et laisse les autres inchangés. Le tableau s'applique tant au .kiro de l'espace de travail qu'à ~/.kiro ; les fichiers sous .kiro/specs/ suivent vos règles ordinaires.

Chemin sous .kiroEspace de travail non approuvéEspace de travail approuvé
steering, skills, extensions, le répertoire specs lui-même, tout répertoire que Kiro ne déclare pasDemande une approbation, même lorsqu'une règle enregistrée autorise l'écritureSuit vos règles
agents, hooks, powers, workflowsDemande une approbationDemande une approbation, sauf dans le cas décrit sous l'exception fs_write ci-dessous
settingsRefuséRefusé

Une règle deny correspondante l'emporte dans chaque ligne.

Une seule règle lève les demandes propres aux espaces de travail non approuvés pour les répertoires .kiro : une règle allow fs_write dans votre propre fichier ~/.kiro/settings/permissions.yaml, sans restriction match et sans exclude. Elle ne supprime pas les chemins qui demandent toujours une approbation, ne remplace pas une règle ask ou deny correspondante et ne charge pas les entrées de l'espace de travail non approuvé énumérées ci-dessus. Un seul environnement élargit cette règle : dans un espace de travail approuvé à l'intérieur du bac à sable infonuagique géré où s'exécutent les sessions dans le nuage, la même règle allow fs_write sans restriction au niveau utilisateur lève aussi les invites qui demandent toujours une approbation pour .git/**, .vscode/**, **/*.code-workspace ainsi que pour les répertoires agents, hooks, workflows et powers. Hors du bac à sable infonuagique, ces chemins demandent une approbation dans tous les espaces de travail.

Faire confiance à un espace de travail dans Kiro CLI

Dans Kiro CLI 2.33 ou une version ultérieure, une session V3 interactive affiche un écran Trust this workspace? la première fois que vous lancez Kiro CLI dans un dossier, avant de charger les hooks, les agents, les serveurs MCP, le Steering, les workflows ou la configuration du serveur de langage de ce dossier. Les exécutions non interactives (--no-interactive) et les sessions V1 et V2 ne sont pas soumises à cet écran : elles chargent la configuration de l'espace de travail sans demander, comme auparavant. Cet écran est propre à Kiro CLI.

  1. Lancez Kiro CLI dans le dossier du projet. L'écran affiche le chemin du dossier et avertit que le dossier peut contenir des hooks, des agents, des serveurs MCP et des workflows qui exécutent des commandes sur votre machine.
  2. Choisissez Trust, continue pour charger la configuration du dossier et démarrer la session, ou Don't trust, exit pour quitter. Refuser ferme Kiro CLI sans rien charger du dossier et affiche Not trusted: <folder>. Kiro exited without loading this folder.
  3. Kiro enregistre une réponse de confiance comme workspaceTrusted dans le fichier d'autorisations propre à l'espace de travail sous ~/.kiro/workspace-roots/, de sorte que l'écran apparaît une seule fois par dossier. L'écran nomme le fichier exact.

Lorsque le dossier est votre répertoire personnel, l'écran précise que sa configuration .kiro est votre configuration au niveau utilisateur, et la réponse ne vaut que pour cette session. La confiance accordée à votre répertoire personnel n'est jamais enregistrée ; Kiro vous la redemande donc à chaque lancement à cet endroit.

Dans Kiro CLI 2.34 ou une version ultérieure, passez --trust-workspace pour approuver le dossier actuel le temps d'un lancement V3. L'option ignore l'écran de confiance et n'enregistre pas workspaceTrusted ; un lancement ultérieur vous le redemande donc, à moins que vous ayez déjà enregistré la confiance pour ce dossier.

Pour révoquer la confiance, retirez la ligne workspaceTrusted du fichier que l'écran a nommé ; le prochain lancement dans ce dossier affiche de nouveau l'écran. Pour confirmer qu'un dossier est approuvé, lancez de nouveau Kiro CLI dans ce dossier : l'écran n'apparaît pas et la session démarre avec la configuration du dossier chargée.

Gestion des autorisations par surface

Modes d'autorisation

Le menu de mode d'autorisation dans la zone de saisie du clavardage règle ce que Kiro fait sans demander dans ce clavardage : Supervised, Accept file changes ou Approve for me. Là où Approve for me n'est pas disponible, le clavardage affiche plutôt le commutateur Autopilot, qui bascule entre Supervised et Accept file changes (anciennement Autopilot). Paramètres → Agent → Autonomie de l'agent (clé de paramètre : kiroAgent.agentAutonomy) règle le mode de départ des nouveaux clavardages; ses valeurs s'appellent toujours Autopilot et Supervised.

La couche d'autorisations basée sur les capacités s'applique après que le mode a déterminé s'il faut procéder. En Accept file changes, les opérations autorisées s'exécutent sans invite tandis que vos règles deny et ask continuent de contrôler des capacités précises. En Supervised, Kiro demande avant d'agir, quoi qu'il arrive. En Approve for me, un modèle ne juge que les actions qu'aucune règle ne règle. Consultez Approve for me.

Flux d'approbation interactif

Lorsqu'un outil nécessite une approbation, une invite apparaît dans le clavardage. Allow et Deny sont disponibles pour l'invocation en cours. Kiro affiche aussi des choix persistants lorsqu'il peut dériver une règle enregistrée qui fonctionnera pour la commande demandée :

ActionEffet
AllowApprouver cette invocation précise, une seule fois
Always allowCréer une règle allow persistante (ouvre le sélecteur de modèle/portée)
DenyBloquer cette invocation précise, une seule fois
Always denyCréer une règle deny persistante

Si Kiro ne peut pas vérifier une règle enregistrée fonctionnelle, il masque Always allow et Always deny et explique pourquoi dans l'invite.

Lorsque vous sélectionnez Always allow ou Always deny, vous configurez deux choses :

  • Pattern - choisissez la portée de correspondance pour la règle (p. ex., cd * pour toute commande cd, ou le chemin de commande exact)
  • Apply to - choisissez où la règle persiste :
    • All workspaces - enregistrée dans le fichier ~/.kiro/settings/permissions.yaml à portée utilisateur
    • This workspace - enregistrée dans ~/.kiro/workspace-roots/<hash>/permissions.yaml (par utilisateur, à l'extérieur du dépôt). Dans Kiro IDE, lorsque la fenêtre contient plus d'un dossier d'espace de travail, ce choix s'affiche comme This workspace folder (folder-name), ce qui vous permet de voir pour quel dossier la règle est enregistrée. Le libellé ne change pas la façon dont la règle est appliquée : les règles de commandes shell s'appliquent toujours à toute la session. Dans Kiro IDE, ce choix est aussi masqué pour les fichiers et les dossiers situés à l'extérieur de tous les dossiers d'espace de travail.
    • This session - mémorisée jusqu'à la fin de la session

Le menu déroulant de modèles suggère une version généralisée de l'opération précise - par exemple, la commande exacte git add contents/docs/ devient le modèle git add *, et le chemin exact .env.local devient .env* ou **/.env*. Vous pouvez modifier la suggestion pour la rendre plus restrictive ou plus permissive.

Pour les commandes enchaînées (p. ex., cd /path && cargo build), chaque sous-commande de la chaîne est présentée séparément pour approbation.

Approve for me

Approve for me laisse Kiro approuver les actions courantes pour vous au lieu de vous demander à chaque invite. Kiro approuve les actions qu'il juge sûres, bloque celles qu'il juge non sûres et vous demande lorsqu'il n'est pas certain. Chaque action qu'il approuve est marquée Approved for you sur la carte d'outil. Il est disponible dans les clavardages de Kiro IDE, les sessions V3 locales interactives de Kiro CLI 2.36 ou une version ultérieure et Kiro Web, dans les sessions où Kiro le propose; là où il n'est pas proposé, Kiro continue de demander.

Un clavardage où Approve for me est disponible remplace le commutateur Autopilot de la zone de saisie du clavardage par un menu de mode d'autorisation. Un clavardage où il n'est pas disponible conserve le commutateur Autopilot. Le menu propose trois modes :

  • Supervised : Kiro fait une pause après chaque tour qui modifie des fichiers afin que vous puissiez accepter ou rejeter chaque changement.
  • Accept file changes : Kiro crée, modifie et supprime des fichiers sans demander. Il demande avant d'exécuter des commandes. Ce mode s'appelait Autopilot et fonctionne de la même façon.
  • Approve for me : Pour les actions que vos règles ne couvrent pas, un modèle approuve celles qu'il juge sûres, bloque celles qu'il juge non sûres et vous demande lorsqu'il n'est pas certain.

Pour l'activer dans le clavardage actuel, ouvrez le menu de mode d'autorisation dans la zone de saisie du clavardage et choisissez Approve for me. Le mode s'applique à partir de la prochaine action de Kiro et reste associé à ce clavardage. Pour le désactiver dans ce clavardage, choisissez Supervised ou Accept file changes.

Pour l'activer dans les nouveaux clavardages, faites l'une des actions suivantes :

  • Dans What's new, activez Use Approve for me by default. Ce réglage s'applique aux nouveaux clavardages dans tous les espaces de travail.
  • Dans Kiro IDE 1.4.178 ou une version ultérieure, ouvrez la palette de commandes et exécutez Kiro: Approve For Me (User)... pour tous les espaces de travail, ou Kiro: Approve For Me (Workspace)... pour les dossiers ouverts dans la fenêtre actuelle. Choisissez Turn on (currently off). Si les dossiers ouverts ont des réglages différents, choisissez Turn on for all folders (currently mixed). Dans Kiro IDE 1.4.154, exécutez plutôt Kiro: Enable Approve For Me (User) ou Kiro: Enable Approve For Me (Workspace).

Pour vérifier le réglage, exécutez de nouveau la même commande. Elle offre Turn off (currently on) lorsque Approve for me est activé pour les nouveaux clavardages.

Un nouveau clavardage couvert par ce choix démarre en Approve for me. Un clavardage où vous avez déjà choisi un mode conserve votre choix. Un espace de travail non approuvé démarre en Supervised avec Approve for me désactivé. Si votre organisation gère Approve for me, le commutateur dans What's new l'indique et vous ne pouvez pas le modifier. Si votre organisation exige Approve for me, les commandes indiquent qu'il est toujours activé et n'offrent aucun changement.

Pour le désactiver dans les nouveaux clavardages, exécutez Kiro: Approve For Me (User)... ou Kiro: Approve For Me (Workspace)... et choisissez Turn off (currently on), ou Turn off for all folders (currently mixed) si les dossiers ouverts ont des réglages différents. Vous pouvez aussi désactiver le commutateur dans What's new. Dans Kiro IDE 1.4.154, exécutez Kiro: Disable Approve For Me (User) ou Kiro: Disable Approve For Me (Workspace). Ces commandes n'apparaissent pas dans une fenêtre connectée à une session infonuagique.

Approve for me fonctionne grâce à l'effet evaluate, l'effet le plus faible de la chaîne de règles. Chaque règle deny, ask et allow que vous avez déjà tranche en premier, et Approve for me ne traite que ce qu'aucune règle ne règle. Le préréglage autorise aussi d'emblée les lectures et les écritures dans l'espace de travail ainsi que les commandes shell en lecture seule, de sorte que celles-ci n'attendent jamais de verdict. Le préréglage est listé avec les autres sous Préréglages disponibles.

Sécurité et confiance

  • Dans Kiro Web, une action approuvée s'exécute dans le bac à sable infonuagique. Approve for me ne change pas l'accès Internet du bac à sable, ses variables d'environnement, ses serveurs MCP ni son rôle AWS. Les autres points de cette section concernent Kiro IDE et la CLI.
  • Lorsqu'Approve for me est activé, Kiro peut exécuter des commandes shell et effectuer d'autres actions dans l'espace de travail qu'aucune règle ne règle, sans vous demander d'abord.
  • Kiro juge chaque action non réglée avec son classificateur de confiance. Cela diffère des options --trust-all-tools et /tools trust-all de la CLI, qui font confiance à chaque action d'outil que vos règles ne refusent pas : Approve for me peut toujours bloquer une action ou vous demander.
  • Approve for me ne remplace pas vos contrôles de sécurité. Conservez des règles deny pour les actions que vous ne voulez jamais voir exécutées, et activez le bac à sable de commandes local afin qu'une commande approuvée soit aussi limitée dans ce qu'elle peut atteindre.
  • Un choix fait pour un espace de travail est à portée d'espace de travail : il n'atteint que cet espace de travail. Une opération de fichier à l'extérieur de l'espace de travail n'est pas jugée par Approve for me et conserve son invite habituelle.
  • Vos règles deny à chaque portée, les règles ask intégrées de Kiro pour les écritures de fichiers listées sous Invariants de confiance et toute action que Kiro juge non sûre bloquent ou demandent toujours. Kiro demande aussi chaque fois qu'il n'est pas certain, et chaque fois que le classificateur de confiance n'est pas disponible.
  • Désactivez-le dans l'IDE en exécutant Kiro: Approve For Me (User)... ou Kiro: Approve For Me (Workspace)... et en choisissant Turn off (currently on), dans la CLI sous /permissions → Policies → ask for approval, ou retirez approve-for-me de policies: dans le fichier d'autorisations qui le liste.

Niveaux de règles d'approbation

Dans Kiro CLI 2.36 ou une version ultérieure, lorsqu'une session V3 vous demande au sujet d'une commande shell, le sélecteur de règles propose jusqu'à trois niveaux de correspondance pour la règle qu'il enregistre :

NiveauExemple pour git stash popCe qu'il couvre
Correspondance exactegit stash popSeulement la commande telle qu'écrite
Sous-commandegit stash *Les deux premiers mots de la commande avec n'importe quels arguments
Motifgit *La commande de base avec n'importe quels arguments

Le niveau sous-commande apparaît lorsque le deuxième mot de la commande est un mot simple, comme stash ou Makefile, et diffère de la commande elle-même. Kiro ne propose aucun des deux niveaux de motif pour une commande qui commence par un enveloppeur de privilèges ou d'environnement comme sudo ou env, ou par une affectation d'environnement. Choisissez le niveau le plus étroit qui couvre ce que vous répétez; préférez le niveau sous-commande lorsque vous répétez une seule opération comme git stash, et le niveau motif lorsque vous faites confiance à une commande entière. Les portées de persistance et le sélecteur de dossier d'écriture sont décrits sous Portées d'approbation dans CLI V3.

Pour vérifier, exécutez de nouveau la même commande. Une commande qui correspond à la règle enregistrée ne demande plus.

Exemples d'autorisations

Voici des modèles courants pour configurer les autorisations :

ScénarioConfiguration
Approuver les lectures de fichierscapability: fs_read, effect: allow
Approuver l'écriture dans les répertoires du projetcapability: fs_write, match: ["src/**", "tests/**"], effect: allow
Bloquer les fichiers sensiblescapability: fs_write, match: ["*.env", "*.pem", "*.key"], effect: deny
Bloquer les commandes dangereusescapability: shell, match: ["rm -rf *", "sudo *"], effect: deny
Approuver un serveur MCP préciscapability: mcp, match: ["my-server/*"], effect: allow
Exiger une approbation pour le shell en productioncapability: shell, effect: ask

Migration depuis des versions antérieures

Si vous effectuez une mise à niveau depuis CLI 2.x ou IDE 0.x, consultez les pages de référence pour savoir comment les autorisations fonctionnaient auparavant et ce qui a changé :

Page mise à jour : 18 novembre 2026