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-server n'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.com sort-il par HK-01 ? » — l'agent interroge match_rule, qui nomme la règle et la politique, essaie une correction avec edit_user_rules, puis, une fois qu'elle fonctionne, l'écrit dans [Rule] avec replace_profile_section.
  • « Quels nœuds d'Auto fonctionnent encore ? » — test_policy sur 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_connections avec le filtre failed, get_logs avec un mot-clé, et run_diagnostics pour le réseau lui-même.
  • « Bloque les publicités sur ce site. » — add_rewrite et add_mitm_host pour 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-token de son dossier de partage — généré même quand external-http-controller est désactivé, et affiché dans les apps ;
  • external-http-secret = none signifie 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 commande claude mcp add et 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.1 ou 0.0.0.0), le port et Masquer les secrets. La même page règle le secret, qui est le external-http-secret de 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, et none coupe 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 commande chute. Avec 0.0.0.0 et 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 :

  1. --token-file <path> ;
  2. la variable d'environnement CHUTE_MCP_TOKEN ;
  3. pour un serveur sur ce Mac uniquement, le fichier de point de terminaison, puis control-token dans 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

  1. 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-secret
    

    Sur iOS, c'est Autoriser l'accès depuis le Wi-Fi et la ligne Secret ; sur tvOS, Adresse d'écoute 0.0.0.0 et le secret, sur la même page.

  2. Connectez le VPN, puis lisez l'adresse sous Autres appareils (iOS) ou Adresse LAN (tvOS) — par exemple http://192.168.1.20:6180/mcp.
  3. 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_connection avec include, 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: true les donne tous, pour plus de jetons.
  • Des pages. Les longues listes et les longs textes acceptent offset et limit et renvoient next_offset tant 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: true avec le next_offset pour 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-CONFIG ne 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-secret long et aléatoire, uniquement sur des réseaux de confiance, et revenez à 127.0.0.1 une fois terminé.
  • run_script exé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'Origin d'une page web autre que le serveur lui-même est refusée avec 403, 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.
S. Smart Rabbit LLC © All Rights Reserved            updated 2026-11-21 15:39:20

Cette page est une traduction de la version anglaise. En cas de divergence, la version anglaise fait foi.

results matching ""

    No results matching ""