Security audit reportRapport d'audit de sécurité
A code-reading audit of the web access, the control socket, attachments, permission gates, prompt-rewriting protection and the orchestrator - with a downloadable PDF.Un audit par lecture du code de l'accès web, du socket de contrôle, des pièces jointes, des garde-fous de permission, de la protection des prompts et de l'orchestrateur - avec un PDF à télécharger.
Download the report: claude-cluster-audit-report.pdf, 6 pages, written from reading the code of version 1.4.62 (commit 2139c37).
Télécharger le rapport : claude-cluster-audit-report.pdf, 6 pages, écrit à partir de la lecture du code de la version 1.4.62 (commit 2139c37). Le rapport est rédigé en anglais.
1. What it coversCe qu'il couvre
| Area | Question asked |
|---|---|
| authentication of the web access and devices | can someone get in, or keep a session, without the code and your approval? |
| the control socket | who can reach it, and what protects it? |
| file access of attachments | can a path escape the allowed folders? |
| the shell and MCP permission gates | what stops a model or a device from running a command? |
| protection of the prompts and settings | what can the global session rewrite? |
| the orchestrator | can a session use it to go around its permission mode? |
Method: each entry point was followed from where a request enters to the guard and the action, and each guard was compared with what the README and the settings help promise. Nothing was exploited on a running instance; there was no dynamic testing.
| Domaine | Question posée |
|---|---|
| authentification de l'accès web et des appareils | peut-on entrer, ou garder une session, sans le code et votre accord ? |
| le socket de contrôle | qui peut l'atteindre, et qu'est-ce qui le protège ? |
| accès aux fichiers des pièces jointes | un chemin peut-il sortir des dossiers autorisés ? |
| les garde-fous de permission du shell et du MCP | qu'est-ce qui empêche un modèle ou un appareil d'exécuter une commande ? |
| protection des prompts et des réglages | que peut réécrire la session globale ? |
| l'orchestrateur | une session peut-elle s'en servir pour contourner son mode de permission ? |
Méthode : chaque point d'entrée a été suivi depuis l'endroit où une requête arrive jusqu'au garde-fou et à l'action, et chaque garde-fou comparé à ce que promettent le README et l'aide des réglages. Rien n'a été exploité sur une instance en marche ; aucun test dynamique.
2. Findings at a glanceConstats en un coup d'œil
| Id | Level | Finding |
|---|---|---|
| F1 | High | a sub-session runs arbitrary shell commands through heavy_run with no permission prompt |
| F2 | Medium | sessions.global_fork, global_edit, global_answers are meant to be protected but are not (a naming mismatch) |
| F3 | Medium | the hidden-file guard of displays checks files, not path / paths |
| F4 | Medium | the /tmp/claude-cluster-<uid> fallback of the runtime folder is predictable and unchecked |
| F5 | Medium | the local certificate authority is valid 20 years with no name constraint |
| F6 | Medium | a describe / chat one-shot run puts an API key on a command line |
| F7 | Low | [web] settings = all amounts to code execution |
| F8 | Low | web.shell = false stops !command, not an agent asked to run it |
| F9 | Low | token compared with ==; any device can rotate the code |
| F10 | Low | files up to 512 MB are read whole in memory |
| F11-F13 | Info | file creation order, scope of the protections, attachment id generator |
These are findings against the code of the commit read, not against a release; they are reported for fixing. The report details the evidence, the impact and a fix for each, then lists what was checked and holds.
| Id | Niveau | Constat |
|---|---|---|
| F1 | Élevé | une sous-session exécute des commandes shell quelconques par heavy_run sans demande de permission |
| F2 | Moyen | sessions.global_fork, global_edit, global_answers sont censés être protégés mais ne le sont pas (une erreur de nom) |
| F3 | Moyen | le garde-fou des fichiers cachés des affichages vérifie files, pas path / paths |
| F4 | Moyen | le repli /tmp/claude-cluster-<uid> du dossier d'exécution est prévisible et non vérifié |
| F5 | Moyen | l'autorité de certification locale vaut 20 ans sans contrainte de noms |
| F6 | Moyen | une exécution ponctuelle de description / chat met une clé d'API sur une ligne de commande |
| F7 | Faible | [web] settings = all revient à une exécution de code |
| F8 | Faible | web.shell = false arrête !commande, pas un agent à qui on demande de l'exécuter |
| F9 | Faible | jeton comparé par == ; tout appareil peut changer le code |
| F10 | Faible | les fichiers jusqu'à 512 Mo sont lus en entier en mémoire |
| F11-F13 | Info | ordre de création des fichiers, portée des protections, générateur d'identifiants de pièces jointes |
Ce sont des constats sur le code du commit lu, pas sur une version publiée ; ils sont signalés pour être corrigés. Le rapport détaille la preuve, l'impact et une correction pour chacun, puis liste ce qui a été vérifié et tient.
3. What holdsCe qui tient
The web login (a code compared in constant time, 5 wrong codes blocking an address, your approval, cookies bound to the device address), the Host and Origin checks, the headers and CSP nonce, the request limits, the permissions of the socket folder and of the secrets, the attachment path checks, the sniffing of uploads and the secret passing on a pipe for the sessions are all verified in the code. See Security overview.
La connexion web (un code comparé en temps constant, 5 mauvais codes qui bloquent une adresse, votre accord, des cookies liés à l'adresse de l'appareil), les contrôles Host et Origin, les en-têtes et le nonce CSP, les limites de requêtes, les permissions du dossier du socket et des secrets, les contrôles de chemin des pièces jointes, la détection du type des téléversements et le passage des secrets sur un tube pour les sessions sont tous vérifiés dans le code. Voir la vue d'ensemble de la sécurité.
4. Privacy and the GDPRVie privée et RGPD
The data of claude-cluster stays on your computer and the project has no server, so the GDPR does not apply to claude-cluster itself. It applies to what you send to the providers you connect.
Les données de claude-cluster restent sur votre ordinateur et le projet n'a aucun serveur, donc le RGPD ne s'applique pas à claude-cluster lui-même. Il s'applique à ce que vous envoyez aux fournisseurs que vous connectez.
5. What is not in itCe qui n'y est pas
Coming soon. A wider security audit of the repository, run with the Claude Code mythos audit, is coming soon and is not part of this report.
Not covered either: the agents themselves, the Android code beyond its trust model, and libutils. Dynamic tests were not part of this report: the second audit below ran them.
Bientôt. Un audit de sécurité plus large du dépôt, mené avec l'audit mythos de Claude Code, arrive bientôt et ne fait pas partie de ce rapport.
Non couverts non plus : les agents eux-mêmes, le code Android au-delà de son modèle de confiance, et libutils. Les tests dynamiques ne faisaient pas partie de ce rapport : le second audit ci-dessous les a menés.
6. The second audit, version 1.10.0Le second audit, version 1.10.0
The whole of claude-cluster read again in passes, each one with AddressSanitizer + UBSan and ThreadSanitizer on the test suite, fuzzing of the web access (tests/web_fuzz.py) and of the displays (tests/display_shapes.py), with every finding reproduced or followed to its exact code path, then fixed with its regression test.
| Id of the first audit | Now |
|---|---|
| F1 | gated by [orchestrator] sub_add |
| F2, F3, F4, F6 | fixed (the protected names, the hidden paths of a display, the runtime folder, the API key off the command line) |
| F9 | the token compared in constant time; any device can still change the code by wrong codes (the pairing only, nothing else) |
| F10 | fixed: the files of the page are streamed |
| F5 | open: the local authority is valid 20 years with no name constraint; changing it asks every device to trust a new one (a decision for you) |
| F7, F8 | documented in Security overview |
What the second audit found and fixed, the most serious first:
[web] shell = falsecould be walked around by a device of the page::set web.shell truein a prompt, a schedule or a task running a command, a tag character before!. The gate is now in one place, on every way of sending a prompt.- What ended the core: JSON nested very deep (a line of 200 000
[: the stack gone), a request using what the quit had destroyed, an exception out of any thread, two pages opening the terminal at once, a save of the state concurrent with another one (state.jsoncorrupted, the sessions lost at the next start). - What ended a terminal or took the memory of the computer: a display of an unexpected shape (again at each start: it stays in the log), the numbers of a chart (
[1e300, -1e300, 1]: a bar without end). - Keep warm: a wake-up taking back its own prompt stopped the shells and agents running in the background, and could erase a real prompt given at the same moment.
- A paste is never keys: a letter of a text pasted could allow a device, quit, start an update; in the terminal of the page, an end of paste inside a copied text made the rest of it keys.
/api/listenand/api/attachwere mixed up since the voice of the page was added: a file uploaded was sent to the speech engine.
An independent reading of each subsystem came after those fixes and confirmed 99 more points, each one reproduced or followed to its code, all fixed:
- The shell, off, was still reachable:
Ctrl+Eon the terminal page opened an editor (:!cmd,:w ~/.bashrc); acommandthat is not a string in a schedule or a task ran through/bin/sh; a NUL byte in a path fooled the check of the hidden files, and a device could write over~/.bashrc. - A file of an agent, opened by a device, ran in the origin of the page: a form in that page could send any command. It opens as text now, and a plain form can no longer reach the routes taking JSON.
- Secrets: a display given with a pin read
~/.ssh/id_rsapast the check, the global session could attach it when the session sits in the home folder, andvoice.wordscould point it at any file. - What ended the core or a terminal: the settings rewritten under the threads reading them, a pattern of deep parentheses in
:s, twousagerequests at once,max_cost: infwritten as a null that stopped every next start,:typed in the prompt, a display or a question of an unexpected size or shape. - What lost work: a keep-warm take-back cutting a real turn or a real prompt, the answer to the restore question replacing the conversation of the global session, a prompt sent during a replacement, a task sent to the session of another project after a restart, the start menu deleting an instance whose state could not be read.
- What a big log did: the output file of a background shell was read whole at every frame of its list, in the terminal, the window and the
agentsrequest (gigabytes of memory for a verbose build), and a fifo named as that file blocked the thread for ever. Only its last bytes are read now, from a regular file.
The full list, with the evidence of each one, is in the report audit/2026-11-03-security.pdf of the repository.
Tout claude-cluster relu en plusieurs passes, chacune avec AddressSanitizer + UBSan et ThreadSanitizer sur la suite de tests, du fuzzing de l'accès web (tests/web_fuzz.py) et des affichages (tests/display_shapes.py), chaque constat reproduit ou suivi jusqu'à son chemin de code exact, puis corrigé avec son test de non-régression.
| Id du premier audit | Maintenant |
|---|---|
| F1 | soumis à [orchestrator] sub_add |
| F2, F3, F4, F6 | corrigés (les noms protégés, les chemins cachés d'un affichage, le dossier d'exécution, la clé d'API hors de la ligne de commande) |
| F9 | le jeton comparé en temps constant ; un appareil peut toujours changer le code par de mauvais codes (l'appairage seulement, rien d'autre) |
| F10 | corrigé : les fichiers de la page sont envoyés en flux |
| F5 | ouvert : l'autorité locale est valable 20 ans sans contrainte de nom ; la changer demande à chaque appareil de faire confiance à une nouvelle (une décision pour vous) |
| F7, F8 | documentés dans la vue d'ensemble de la sécurité |
Ce que le second audit a trouvé et corrigé, le plus grave d'abord :
[web] shell = falsepouvait être contourné par un appareil de la page ::set web.shell truedans un prompt, une planification ou une tâche lançant une commande, un caractère d'étiquette avant!. Le contrôle est maintenant à un seul endroit, sur chaque façon d'envoyer un prompt.- Ce qui terminait le cœur : du JSON imbriqué très profond (une ligne de 200 000
[: la pile épuisée), une requête utilisant ce que la fermeture avait détruit, une exception sortant d'un thread, deux pages ouvrant le terminal en même temps, un enregistrement de l'état concurrent d'un autre (state.jsoncorrompu, les sessions perdues au lancement suivant). - Ce qui terminait un terminal ou prenait la mémoire de l'ordinateur : un affichage d'une forme inattendue (à nouveau à chaque lancement : il reste dans le journal), les nombres d'un graphique (
[1e300, -1e300, 1]: une barre sans fin). - Maintien au chaud : un réveil reprenant son propre prompt arrêtait les shells et agents en arrière-plan, et pouvait effacer un vrai prompt donné au même moment.
- Un collage n'est jamais des touches : une lettre d'un texte collé pouvait autoriser un appareil, quitter, lancer une mise à jour ; dans le terminal de la page, une fin de collage dans un texte copié faisait du reste des touches.
/api/listenet/api/attachétaient mélangés depuis l'ajout de la voix de la page : un fichier envoyé partait vers le moteur de reconnaissance vocale.
Une relecture indépendante de chaque sous-système a suivi ces corrections et confirmé 99 points de plus, chacun reproduit ou suivi jusqu'au code, tous corrigés :
- Le shell, coupé, restait atteignable :
Ctrl+Esur la page terminal ouvrait un éditeur (:!cmd,:w ~/.bashrc) ; unecommandqui n'est pas du texte dans une planification ou une tâche passait par/bin/sh; un octet NUL dans un chemin trompait le contrôle des fichiers cachés, et un appareil pouvait écraser~/.bashrc. - Un fichier d'un agent, ouvert par un appareil, s'exécutait dans l'origine de la page : un formulaire de cette page pouvait envoyer n'importe quelle commande. Il s'ouvre maintenant comme du texte, et un simple formulaire n'atteint plus les routes qui prennent du JSON.
- Secrets : un affichage donné avec un épinglage lisait
~/.ssh/id_rsasans contrôle, la session globale pouvait le joindre quand la session est dans le dossier personnel, etvoice.wordspouvait la diriger vers n'importe quel fichier. - Ce qui arrêtait le cœur ou un terminal : les réglages réécrits sous les threads qui les lisent, un motif de parenthèses profondes dans
:s, deux requêtesusageen même temps,max_cost: infécrit comme un null qui bloquait tous les démarrages suivants,:tapé dans le prompt, un affichage ou une question d'une taille ou d'une forme inattendues. - Ce qui perdait du travail : une reprise de keep warm coupant un vrai tour ou un vrai prompt, la réponse à la question de restauration remplaçant la conversation de la session globale, un prompt envoyé pendant un remplacement, une tâche envoyée à la session d'un autre projet après un redémarrage, le menu de démarrage supprimant une instance dont l'état était illisible.
- Ce que faisait un gros log : le fichier de sortie d'un shell en arrière-plan était relu en entier à chaque image de sa liste, dans le terminal, la fenêtre et la requête
agents(des gigaoctets de mémoire pour une compilation bavarde), et une fifo donnée comme fichier bloquait le thread pour toujours. Seuls ses derniers octets sont lus maintenant, et seulement dans un fichier normal.
La liste complète, avec la preuve de chacun, est dans le rapport audit/2026-11-03-security.pdf du dépôt.