Agent IA (MCP) PRO PREVIEW
PREVIEW Remarque : le serveur MCP est en test interne et n'est pas encore publié. Cette page décrit la version en test : les clés, les routes, les noms d'outils et les écrans des applications peuvent encore changer avant sa sortie.
[General]
external-mcp-server = 127.0.0.1:6180
Le moteur de Chute Mac, Chute iOS et Chute tvOS dispose de son propre serveur MCP (Model Context Protocol). Un agent IA — Claude Code, Codex ou tout autre client qui parle MCP — s'y connecte, lit ce que fait le moteur (état, politiques, règles, connexions, DNS, journal, configuration) et le modifie : sélectionner une politique, essayer une règle, réécrire une section de la configuration, mesurer les membres d'un groupe.
Il repose sur les routes de l'API de contrôle HTTP et s'authentifie avec le même secret, mais c'est un écouteur à part, sur /mcp de son propre port : il n'a besoin ni de external-http-controller ni de la console web. Il est désactivé par défaut.
PRO Remarque : le serveur MCP fait partie de Chute Pro. Sans licence, le moteur ne le démarre pas :
external-mcp-servern'ouvre aucun port, et la configuration reste modifiable. Dès qu'une licence est en vigueur, le serveur démarre sans redémarrer Chute, et il s'arrête quand la licence disparaît ; l'essai gratuit de Chute Mac compte comme une licence. L'API de contrôle HTTP elle-même n'est pas concernée. Ce que les apps affichent entre-temps est décrit dans Sans Chute Pro ; voir aussi Licence et activation.
À quoi il sert
C'est l'agent qui lit ; vous pouvez donc demander avec vos propres mots. Par exemple :
- « Pourquoi
api.example.comsort-il par HK-01 ? » — l'agent interrogematch_rule, qui nomme la règle et la politique, essaie une correction avecedit_user_rules, puis, une fois qu'elle fonctionne, l'écrit dans[Rule]avecreplace_profile_section. - « Quels nœuds d'Auto fonctionnent encore ? » —
test_policysur le groupe mesure chaque membre, l'un après l'autre, et rend compte de chacun dès qu'il a fini. - « L'application n'arrive plus à joindre son serveur depuis ce matin. » —
list_connectionsavec le filtrefailed,get_logsavec un mot-clé, etrun_diagnosticspour le réseau lui-même. - « Bloque les publicités sur ce site. » —
add_rewriteetadd_mitm_hostpour l'essayer dans le moteur en marche, puis les lignes à garder dans la configuration.
Activation
external-mcp-server (par défaut : désactivé)
external-mcp-server = 127.0.0.1:6180
L'adresse et le port du serveur MCP. Cette clé est propre à Chute : ni Surge ni Clash n'ont d'équivalent, et importer leurs configurations ne l'ajoute pas. L'adresse s'écrit comme pour external-http-controller : 127.0.0.1:6180 pour cet appareil seulement, 0.0.0.0:6180 ou *:6180 pour toutes les interfaces, [::]:6180 pour IPv6 ; tout 127.0.0.0/8, ::1 et localhost comptent comme boucle locale. Une adresse illisible est une erreur de configuration. Les apps utilisent le port 6180 quand elles l'activent.
Authentification. L'agent envoie Authorization: Bearer <token>, et le jeton est celui de l'API de contrôle HTTP :
external-http-secret, quand la configuration en a un ;- sinon le jeton que Chute génère et conserve dans le fichier
control-tokende son dossier de partage — généré même quandexternal-http-controllerest désactivé, et affiché dans les apps ; external-http-secret = nonesignifie aucune authentification, et n'est accepté que sur une adresse de boucle locale.
Hors boucle locale, le serveur MCP exige un external-http-secret explicite : ni le jeton généré ni none ne suffisent. Sans lui il ne démarre pas, et les apps indiquent pourquoi.
Il tourne avec le moteur. Il démarre quand Chute démarre et s'arrête quand Chute s'arrête ; un agent ne peut donc ni démarrer Chute, ni l'arrêter, ni faire passer l'app à une autre configuration. Un rechargement ne redémarre l'écouteur que si son adresse ou le secret a changé, et seulement après l'écriture des réponses déjà en route — un agent qui change l'adresse du serveur MCP lui-même reçoit quand même sa réponse.
external-mcp-mask-secrets (par défaut : true)
external-mcp-mask-secrets = false
Indique si les mots de passe, clés et jetons parviennent à l'agent sous forme de références — voir Masquage des secrets. C'est aussi une clé propre à Chute ; elle n'est écrite dans la configuration que lorsqu'elle vaut false.
Dans les apps
- Chute iOS : dans l'éditeur de configuration, Contrôleur externe → Serveur MCP : l'interrupteur, Port, Autoriser l'accès depuis le Wi-Fi (qui écoute sur
0.0.0.0; la ligne Secret alors requise est celle de l'API de contrôle HTTP) et Masquer les secrets. La ligne Agent IA (MCP) du Panneau de configuration, sous la console web, affiche En cours d'exécution, Non démarré ou Non configuré, et ouvre une page avec la raison pour laquelle le serveur n'écoute pas, l'adresse pour Cet appareil et, hors boucle locale, pour Autres appareils, le jeton (masqué jusqu'à Afficher le jeton ; toucher une ligne la copie), CONFIGURATION DU CLIENT avec une commandeclaude mcp addet un JSON prêts à l'emploi, et ACTIONS RAPIDES. Le serveur MCP tourne dans le VPN : VPN coupé, la page indique ce que fera la configuration actuelle. - Chute Mac : onglet Config de la fenêtre principale → Général → Serveur MCP : Activer le serveur MCP, l'adresse et le port, le secret partagé avec l'API de contrôle HTTP, Masquer les identifiants et État et configuration du client…. Tant que Chute tourne, Agent IA (MCP)… dans le menu de la barre des menus (et dans le menu … du panneau de la barre des menus) ouvre une fenêtre avec l'état, les adresses, le jeton (Afficher, Copier), si les secrets sont masqués, et Connecter un agent : les réglages pour Claude Code en HTTP, pour Claude Code via la commande
chute, et un JSON pour les autres clients. - Chute tvOS : Modification de la configuration → GÉNÉRAL → Serveur MCP : activé ou non, Adresse d'écoute (
127.0.0.1ou0.0.0.0), le port et Masquer les secrets. La même page règle le secret, qui est leexternal-http-secretde l'API de contrôle HTTP : il est affiché masqué jusqu'à ce que vous demandiez à le voir ; vide, il désigne le jeton que Chute génère, etnonecoupe l'authentification, après un avertissement. Il ne peut contenir ni espace ni saut de ligne. Le changer change aussi l'authentification de la console web et de la commandechute. Avec0.0.0.0et sans secret, la page indique que le serveur ne démarrera pas et vous permet d'en définir un sur place. La ligne Agent IA (MCP) du Panneau de configuration affiche l'état, l'Adresse, l'Adresse LAN et le Jeton, masqué jusqu'à sa sélection ; rien n'est copié sur le téléviseur.
Les interrupteurs rapides — ACTIONS RAPIDES sur iOS, Activer MCP / Désactiver MCP et Masquer les identifiants dans la fenêtre du Mac, Serveur MCP et Masquer les secrets sur la page du téléviseur — modifient ces deux clés dans le fichier de configuration actuel et l'appliquent aussitôt ; activé de là, le serveur écoute sur 127.0.0.1:6180. Sur iOS, ils sont désactivés pour un abonnement, dont la prochaine mise à jour les annulerait.
Sans Chute Pro
Sans licence, les apps disent que le serveur demande Chute Pro, au lieu de le signaler comme n'écoutant pas :
- Chute Mac : Agent IA (MCP)… dans le menu de la barre des menus et dans le menu … du panneau de la barre des menus, ainsi que Activer le serveur MCP sur la page Général, portent la capsule PRO. La fenêtre Agent IA (MCP) s'ouvre sur une note Chute Pro et un bouton Obtenir Chute Pro, et son état indique Nécessite Chute Pro, sans adresse ni jeton. Activer MCP ouvre la fenêtre Chute Pro au lieu d'activer le serveur ; le désactiver et Masquer les identifiants fonctionnent comme toujours. La fenêtre Chute Pro compte Agent IA (MCP) parmi ses fonctions.
- Chute iOS et Chute tvOS : la ligne Agent IA (MCP) du Panneau de configuration et l'interrupteur MCP de l'éditeur de configuration portent la capsule PRO. La page d'état indique Nécessite Chute Pro et propose l'accès à Chute Pro à la place de l'adresse et du jeton ; activer le serveur avec l'interrupteur rapide de cette page demande d'abord Chute Pro, comme les autres interrupteurs Chute Pro des apps.
- Sur les trois, les champs de l'éditeur de configuration restent modifiables, et la note qui liste les fonctions Chute Pro qui n'ont pas tourné cette fois nomme le serveur MCP.
Connecter un agent
En HTTP
Un client qui parle Streamable HTTP se connecte directement :
- adresse :
http://<host>:<port>/mcp— pour un agent sur le même appareil,http://127.0.0.1:6180/mcp; - en-tête :
Authorization: Bearer <token>, avec le jeton qu'affiche l'app.
Pour Claude Code :
claude mcp add --transport http chute http://127.0.0.1:6180/mcp --header "Authorization: Bearer <token>"
Pour un client configuré en JSON :
{"mcpServers": {"chute": {"type": "http", "url": "http://127.0.0.1:6180/mcp", "headers": {"Authorization": "Bearer <token>"}}}}
Chute iOS et Chute Mac copient les deux avec l'adresse et le jeton déjà remplis. Sur un iPhone, une app d'agent du même iPhone joint aussi le serveur sur 127.0.0.1.
Le serveur parle MCP 2026-07-28 et accepte les clients de 2025-11-25, 2025-06-18 et 2025-03-26. Il ne garde aucune session : chaque message JSON-RPC est un POST vers /mcp, auquel il répond en JSON — ou, pour les outils longs, par un flux d'événements — puis la connexion se ferme. GET, DELETE et OPTIONS reçoivent 405, les lots (un tableau JSON) sont refusés, un corps de requête est limité à 1 Mo, et au plus 8 connexions sont servies à la fois.
Via chute mcp
Un client qui ne sait lancer des serveurs MCP que comme des programmes qu'il démarre lui-même — ou dont la configuration ne doit pas contenir le jeton — utilise l'outil en ligne de commande chute comme relais : chute mcp transmet chaque ligne lue au serveur MCP et réécrit chaque réponse sur une ligne.
claude mcp add chute -- chute mcp
{"mcpServers": {"chute": {"command": "chute", "args": ["mcp"]}}}
Sur un Mac où tourne Chute, il n'en faut pas plus : chute mcp lit l'adresse et le jeton dans le fichier de point de terminaison à chaque message, et trouve donc aussi un Chute démarré après le client. Le jeton vient de la première de ces sources :
--token-file <path>;- la variable d'environnement
CHUTE_MCP_TOKEN; - pour un serveur sur ce Mac uniquement, le fichier de point de terminaison, puis
control-tokendans le dossier de partage.
--url http://<host>:<port>/mcp le dirige vers un autre appareil. CHUTE_MCP_ENDPOINT désigne un fichier de point de terminaison à lire à la place. --token et --token-stdin sont refusés : l'entrée standard est le canal MCP lui-même, et un jeton sur la ligne de commande finit dans la configuration du client et dans la liste des processus. Quand le serveur est injoignable, l'agent reçoit une erreur qui dit pourquoi — un port fermé renvoie à external-mcp-server, un 401 au jeton.
D'un ordinateur vers un iPhone ou une Apple TV
Sur l'appareil, écoutez sur le réseau et définissez un secret :
[General] external-mcp-server = 0.0.0.0:6180 external-http-secret = a-long-random-secretSur iOS, c'est Autoriser l'accès depuis le Wi-Fi et la ligne Secret ; sur tvOS, Adresse d'écoute
0.0.0.0et le secret, sur la même page.- Connectez le VPN, puis lisez l'adresse sous Autres appareils (iOS) ou Adresse LAN (tvOS) — par exemple
http://192.168.1.20:6180/mcp. Sur l'ordinateur, sur le même réseau :
claude mcp add --transport http chute-phone http://192.168.1.20:6180/mcp --header "Authorization: Bearer a-long-random-secret"ou, avec le secret gardé dans un fichier :
chute mcp --url http://192.168.1.20:6180/mcp --token-file ~/.config/chute/phone.token
L'adresse est celle de l'appareil sur le réseau ; elle change quand le réseau lui en attribue une autre.
Le fichier de point de terminaison
Tant que le serveur MCP écoute, le moteur écrit mcp-endpoint dans son dossier de partage, lisible par son seul propriétaire, et le supprime quand le serveur s'arrête. C'est un objet JSON de chaînes : running, configured, url, lan_url (hors boucle locale), bind, port, loopback, token, anonymous et mask_secrets — ce qu'affichent les apps. Sur un Mac, il se trouve dans ~/Library/Application Support/com.R3Studio.Chute-Mac/Share/mcp-endpoint (voir Emplacement des fichiers) ; c'est pourquoi un client local n'a besoin ni du port ni du jeton. Sur iPhone et Apple TV, il reste dans le conteneur de l'app : prenez l'adresse dans l'app.
Masquage des secrets
Ce que lit un agent part chez le fournisseur de son modèle. Par défaut, les secrets de la configuration ne lui parviennent donc jamais : chacun est remplacé, partout où il apparaît — dans la configuration et dans tout autre résultat, journal compris — par une référence comme <secret:password:3f9c0a1b2e>, faite de son type et d'un identifiant. Les adresses des serveurs restent visibles : l'agent voit toujours vers quel serveur pointe un nœud ou un téléchargement.
[Proxy]
HK-01 = trojan, hk.example.com, 443, password=<secret:password:3f9c0a1b2e>, sni=hk.example.com
[Proxy Group]
Sub = select, policy-path=https://sub.example.com<secret:url_secret:8d2e4f6a1c>
Ce qui est masqué : les mots de passe des proxys, les UUID, les clés pré-partagées, les clés privées, les mots de passe obfs et shadow-tls et les jetons comme celui de MASQUE — y compris ceux des sections WireGuard et AmneziaWG et des nœuds des fournisseurs de proxys ; les mots de passe de http-auth, external-http-secret et le mot de passe de external-controller-access ; ca-p12 et ca-passphrase ; la clé d'authentification Tailscale ; l'argument= d'un script ; le chemin, la requête et la partie utilisateur des URL d'abonnement, de policy-path, d'ensembles de règles, de modules et de #!MANAGED-CONFIG (le schéma, l'hôte et le port restent) ; et les valeurs des en-têtes de [Header Rewrite] nommés Authorization, Proxy-Authorization, ou contenant token, key, secret, auth, password ou cookie. Un secret de moins de 8 caractères est remplacé là où il figure comme valeur d'un champ, mais pas dans du texte libre comme une ligne de journal, où on ne pourrait le distinguer d'un mot ordinaire.
Réécriture. Quand l'agent réécrit du texte de configuration, une référence laissée telle quelle redevient la valeur qu'elle représente ; l'agent peut donc changer le port d'un nœud, le renommer ou réorganiser une section sans connaître son mot de passe. Une référence peut aussi être déplacée ou copiée, avec deux limites :
- elle ne revient que dans un champ du même type — une référence de mot de passe dans un champ de mot de passe ;
- la ligne doit joindre le même serveur que celui d'où vient le secret : le serveur du proxy, l'hôte de l'URL, ou la même clé de
[General].
Une référence ailleurs — sur une ligne vers un autre serveur, dans une règle, inventée, ou périmée (voir plus bas) — est refusée avec le numéro de ligne et la raison, et rien n'est appliqué : cette valeur, c'est à vous de la saisir. Un nouveau secret que l'agent écrit en entier est accepté tel quel ; il est alors, bien sûr, déjà dans le contexte de l'agent.
Une même valeur reçoit toujours la même référence ; un agent voit ainsi que deux nœuds partagent un mot de passe. Une référence vaut tant que dure le processus qui l'a émise — jusqu'à ce que Chute Mac quitte, ou que le VPN de Chute iOS ou Chute tvOS se déconnecte ; ensuite elle est refusée, et l'agent relit la configuration.
Le masquage porte sur les secrets de la configuration. Les identifiants de votre propre trafic — les cookies d'un site, un en-tête Authorization envoyé par une app — ne sont pas des secrets de configuration et ne sont pas masqués ; c'est une raison de plus pour ne les donner que sur demande explicite (voir plus bas).
Le désactiver. external-mcp-mask-secrets = false — ou l'interrupteur de masquage des apps — donne à l'agent chaque secret tel qu'il est écrit, et l'agent en est informé. Ne le faites que si vous acceptez que ces identifiants entrent dans le contexte du fournisseur du modèle de l'agent.
Contenu tiers
Les en-têtes et corps des requêtes et réponses, les lignes du journal, la sortie des scripts et le texte d'un module téléchargé depuis une URL sont écrits par d'autres — un site web, une app, l'exploitant d'un serveur. Une page web peut contenir un texte rédigé pour ressembler à des instructions adressées à un agent. Aussi :
- par défaut, les outils ne renvoient que des métadonnées : hôtes, URL, ports, politiques, règles, noms de processus, nombres d'octets, durées et état ;
- le contenu ne vient que si l'agent le demande —
get_connectionavecinclude,get_logs,run_script,get_module— et il arrive sous une cléuntrusted, que l'agent doit lire comme des données, jamais comme des instructions.
Cela garde le contexte de l'agent propre et sa facture de jetons modeste ; ce n'est pas un contrôle d'accès. Un agent qui détient le jeton peut appeler directement l'API de contrôle HTTP et tout lire.
Outils
Chaque outil est marqué comme l'un de quatre types, d'après lesquels les clients décident ce qu'ils vous demandent avant de l'appeler.
Lecture seule
| Outil | Ce qu'il fait |
|---|---|
get_status |
Si le moteur tourne et comment : mode sortant, interrupteurs, TUN, écouteurs, mémoire, connexions, fin de l'exécution précédente |
get_network_summary |
Le réseau où se trouve l'appareil — type, nom du Wi-Fi, routeur — si un réglage SSID y suspend Chute, et les adresses de l'appareil |
get_traffic |
Octets montants et descendants, et débits actuels |
list_policies |
Les groupes avec leur choix actuel, le nœud où ils aboutissent et sa latence ; group pour un groupe complet, detail pour tous les membres |
get_policy |
La ligne de configuration d'une politique et ce que le moteur en sait maintenant : serveur, port, UDP, latence, destination finale |
list_rules |
Les règles dans l'ordre d'évaluation et l'origine de chacune ; filter les restreint |
match_rule |
Quelle règle et quelle politique prendrait une requête, avant et après la résolution du nom, sans l'envoyer |
list_user_rules |
Les règles ajoutées pendant que le moteur tourne |
list_connections |
Connexions ouvertes ou enregistrées, métadonnées seulement ; filtre par hôte, processus, politique ou échec |
get_connection |
Une connexion ; ses en-têtes et corps seulement s'ils sont nommés dans include |
get_logs |
Lignes du journal du moteur, par niveau minimal et mot-clé |
get_events |
Les moments marquants de cette exécution ; after pour les seuls nouveaux |
list_dns_cache |
Les enregistrements DNS et le serveur qui a répondu pour chacun |
query_dns |
Résout un nom par les résolveurs du moteur et dit lequel a répondu |
geoip_lookup |
Pays et ASN d'une adresse ou d'un nom |
get_profile |
La configuration en cours, une page de lignes à la fois, avec sa revision |
list_profile_sections |
Les sections de la configuration, chacune avec sa révision et si elle peut être écrite |
get_profile_section |
Le texte et la révision d'une section |
validate_profile |
Analyse une configuration comme le ferait un rechargement, sans l'appliquer |
get_log_level |
Le niveau de journal et les sections journalisées |
list_scripts |
Les scripts generic que run_script peut lancer |
list_rewrites |
Les règles de réécriture et de réponse simulée en vigueur, et la liste des hôtes MitM |
list_mitm_hosts |
Les hôtes en cours de déchiffrement |
list_modules |
Les modules chargés, leurs identifiants et s'ils sont actifs |
get_module |
Le texte d'un module |
list_external_resources |
Ensembles de règles, fournisseurs de règles, fournisseurs de proxys et modules venus d'ailleurs : date de mise à jour, nombre d'entrées, dernière erreur |
get_tailscale |
Le nœud Tailscale : identité, nœud de sortie, DERP, pairs avec detail |
watch_events |
Observe les événements du moteur pendant 1 à 60 secondes et les renvoie tous |
Tests
Ceux-ci envoient leur propre trafic.
| Outil | Ce qu'il fait |
|---|---|
test_policy |
Une requête HTTPS à travers une politique, avec code d'état et durée ; pour un groupe, chaque membre, rapporté un par un |
test_policies |
Plusieurs politiques, ou toutes, rapportées une par une |
ping |
ICMP, ou le temps d'ouverture d'une connexion TCP, directement depuis l'appareil |
egress_probe |
L'adresse propre de cet appareil sur son réseau physique |
internet_test |
Une requête vers internet-test-url sans aucun proxy : y a-t-il Internet tout court |
run_diagnostics |
Santé du moteur, test Internet, adresse de sortie et une résolution DNS, étape par étape, puis un rapport |
Les durées que test_policy rapporte pour les membres d'un groupe sont des allers-retours HTTPS ; le test propre d'un groupe récupère d'ordinaire une URL en HTTP simple, si bien que les chiffres diffèrent de ceux sur lesquels le groupe choisit. Le test propre du groupe s'exécute ensuite et choisit comme toujours.
Réglages
| Outil | Ce qu'il fait |
|---|---|
set_outbound_mode |
Règle, global ou direct |
select_policy |
Un membre d'un groupe select, ou la sélection globale (GLOBAL) ; les groupes automatiques choisissent eux-mêmes et refusent |
set_feature |
MitM ou enregistrement du trafic, activé ou non |
set_log_level |
Le niveau de journal et les sections journalisées, sans rechargement |
edit_user_rules |
Remplace, complète ou vide les règles d'exécution ; une ligne qui n'est pas une règle fait refuser toute la modification |
add_mitm_host, remove_mitm_host |
La liste des hôtes MitM |
add_rewrite, remove_rewrite |
Une règle de réécriture d'URL, d'en-tête ou de corps, ou de réponse simulée, écrite comme sa ligne de configuration |
set_modules_enabled |
Active ou désactive des modules |
update_external_resource |
Récupère tout de suite un ensemble de règles, un fournisseur de règles ou un fournisseur de proxys |
replace_profile_section |
Remplace une section de la configuration, ou l'ajoute, et recharge |
replace_profile |
Remplace toute la configuration et recharge |
Destructifs
| Outil | Ce qu'il fait |
|---|---|
reload_profile |
Annule les modifications d'exécution : réécritures, hôtes MitM et interrupteurs de modules reviennent à ce que dit la configuration |
kill_connection |
Ferme une connexion ouverte ; l'app à l'autre bout la voit tomber |
flush_dns |
Vide le cache DNS, ou l'enregistrement d'un nom |
run_script |
Lance l'un des scripts generic de la configuration et renvoie sa sortie |
Comment répondent les outils
- Un résumé par défaut. Les outils de liste donnent les champs clés de chaque entrée ;
detail: trueles donne tous, pour plus de jetons. - Des pages. Les longues listes et les longs textes acceptent
offsetetlimitet renvoientnext_offsettant qu'il en reste. - 256 Ko au plus. Un résultat plus gros est coupé par entrées ou par lignes, jamais au milieu de l'une d'elles, et indique
truncated: trueavec lenext_offsetpour continuer — ce qui arrive est toujours du JSON valide. - Des erreurs en mots. Un outil qui échoue dit pourquoi, dans une phrase dont l'agent peut se servir, plutôt qu'un simple code d'état.
Combien de temps dure une modification
Sur Chute iOS et Chute tvOS, toute modification se fait dans le moteur en cours seulement. Rien n'est écrit dans le fichier de configuration ni dans les réglages propres de l'app ; un redémarrage ramène donc ce qu'ils disent, comme avec la console web.
Sur Chute Mac, l'app conserve ces modifications, comme elle conserve les mêmes modifications faites depuis ses propres menus, si bien qu'elles survivent à un redémarrage — qu'un agent les fasse, ou la console web, la commande chute ou l'API de contrôle HTTP :
- le mode sortant et les sélections de politiques, la sélection globale comprise (
set_outbound_mode,select_policy) : l'app les mémorise ; - MitM et l'enregistrement du trafic (
set_feature) : écrits dans le fichier de configuration actuel ; - la configuration elle-même (
replace_profile,replace_profile_section) : écrite dans le fichier de configuration actuel, puis appliquée comme le fait Enregistrer et appliquer dans l'app.
Leurs résultats indiquent persisted: true, et les descriptions que l'agent lit le lui disent à l'avance. Une écriture de la configuration est refusée, et rien n'est écrit, dans ces cas :
| Situation | Code | Que faire |
|---|---|---|
| La fenêtre principale a des modifications non enregistrées | user_editing |
Les enregistrer ou les abandonner d'abord dans l'app |
| Le fichier de configuration a été modifié hors de Chute | file_changed |
Le recharger d'abord dans Chute |
| La configuration actuelle n'est pas un fichier local | profile_missing |
— |
| L'app affiche une boîte de dialogue | needs_user_action |
Y répondre, puis réessayer |
Une configuration que le moteur refuse n'est pas écrite dans le fichier non plus. Si l'app n'a pas terminé en 10 secondes, l'agent reçoit host_busy : la modification peut encore prendre effet, donc l'agent relit l'état avant de réessayer. À savoir : set_feature bascule MitM ou l'enregistrement du trafic aussitôt et écrit l'interrupteur dans le fichier, mais ne recharge pas la configuration ; le texte et la revision que get_profile renvoie juste après restent donc les anciens jusqu'au prochain rechargement.
Sur toutes les plateformes, le niveau de journal, les réécritures, les hôtes MitM, les interrupteurs de modules et les règles d'exécution ne valent que pour cette exécution, et un rechargement de la configuration depuis l'app annule aussi les réécritures, les hôtes MitM et les interrupteurs de modules. reload_profile annule les réécritures, les hôtes MitM et les interrupteurs de modules sans rechargement ; le niveau de journal, l'interrupteur des connexions LAN de l'app, le mode sortant et les sélections de politiques restent tels quels. Les règles d'exécution de edit_user_rules survivent à un rechargement et disparaissent quand le moteur s'arrête.
Modifier la configuration
Demandez à l'agent de modifier la configuration section par section : get_profile_section lit une section et sa révision, replace_profile_section la réécrit avec cette révision. Si la section a changé entre-temps, l'écriture est refusée et l'agent est invité à la relire ; une modification d'une autre section ne gêne pas, si bien que deux agents peuvent éditer des sections différentes. La paire pour le fichier entier, get_profile et replace_profile, fonctionne de même avec la revision de la configuration, mais une grande configuration ne tient pas dans une seule réponse, et replace_profile accepte au plus 1 Mo.
- Une section qui contient une ligne
#!include, toutes les sections qui la suivent, et la section qui contient#!MANAGED-CONFIGne peuvent pas être écrites ainsi. - Une section écrite est relue depuis la configuration rechargée : les valeurs de
[General]et[MITM]sont écrites à la manière de Chute et les clés de[WireGuard …]réordonnées, si bien que le texte peut différer de ce qui a été envoyé. La réponse porte la nouvelle révision à utiliser ensuite. - Une configuration que Chute refuse n'est pas appliquée ; l'agent en reçoit la raison. Pour une configuration gérée, la prochaine mise à jour gérée remplace la modification.
Progression des outils longs
test_policy sur un groupe, test_policies, run_diagnostics et watch_events rendent compte au fur et à mesure. Un client qui demande la progression (un progressToken) et accepte un flux d'événements reçoit un notifications/progress par membre, politique, étape ou événement, puis le résultat, et le flux se ferme ; les autres clients reçoivent le résultat seul quand l'outil a terminé. Un outil long tourne au plus 60 secondes, puis renvoie ce qu'il a, et quatre au plus diffusent en même temps. Un client qui ferme le flux annule l'appel ; les mesures déjà envoyées vont quand même à leur terme et mettent quand même le groupe à jour.
Sécurité
- Le jeton donne le contrôle total. Qui le détient peut lire votre configuration, votre historique de connexions et votre journal, modifier votre routage et lancer vos scripts — et c'est aussi le jeton de l'API de contrôle HTTP. Gardez-le hors des fichiers partagés et des captures d'écran ; pour le changer, donnez une nouvelle valeur à
external-http-secret. - Écouter sur le réseau permet à chaque appareil de ce réseau d'essayer. La connexion est en HTTP simple, le jeton traverse donc le réseau en clair, et les échecs ne sont pas bloqués : utilisez un
external-http-secretlong et aléatoire, uniquement sur des réseaux de confiance, et revenez à127.0.0.1une fois terminé. run_scriptexécute du code. Il ne lance que les scripts generic que définit la configuration, mais ce que fait un script — requêtes, valeurs stockées, notifications —, il le fait quand l'agent le demande. Un agent autorisé à écrire la configuration peut aussi ajouter un script puis le lancer ; lisez ce qu'il modifie.- Les pages web restent dehors. Une requête qui porte l'
Origind'une page web autre que le serveur lui-même est refusée avec403, et aucun en-tête cross-origin n'est envoyé ; un site que vous visitez ne peut donc pas atteindre le serveur par votre navigateur.
Cette page est une traduction de la version anglaise. En cas de divergence, la version anglaise fait foi.