Aller au contenu
Tous les logs

La structure d'abord : ce que 8 800 sujets cyber m'ont appris

Le savoir en cybersécurité est éparpillé entre articles de blog, slides et README d'outils. Deux ans à restructurer Cyber Library m'ont appris une chose : le plus dur, ce n'est pas d'écrire, c'est la forme.

Florian Amette5 min de lecture

Apprendre la cybersécurité, c'est lire une bibliothèque où chaque livre a son propre index.

Un article de blog ici, des slides là, un README d'outil, un fil de forum de 2014. Chacun est utile. Aucun n'est d'accord sur où ranger les choses. La même technique porte trois noms, et ce dont tu as vraiment besoin se trouve entre deux ressources qui ne se citent jamais.

C'est ça qui me frustre. Le contenu existe. La forme, non.

Alors en novembre 2024, j'ai lancé Cyber Library : un seul arbre pour tout le domaine, en open source. Deux ans plus tard, écrire s'est révélé être la partie facile.

La version un ne tenait pas à l'échelle

Le premier README promettait un « référentiel structuré et à jour » en huit catégories. Les fichiers ressemblaient à ça :

offensive/network/enumeration/memcache_enumeration/service_detection/identifying_open_memcache_ports_default_11211.mdx

Un chemin qui veut tout dire ne dit rien. Et chaque nouvelle page posait la même question : on la range où ?

Petit historique de cette question, tiré de git :

QuandCe qui s'est passé
Nov. 2024Six dossiers racine, dont concepts et technology
Févr. 2025concepts devient foundation, technology disparaît, intelligence apparaît
Juil. 2025Web renommé en Browser. Puis de nouveau en Web. Le même jour.
Déc. 2025Le fichier de taxonomie est coupé en trois. Celui de la cyber approche 1 Mo de JSON
Mars 2026Refonte complète : 522 fichiers, 52 668 lignes supprimées. Sept pages survivent
Oct. 2026Cloud sort de Server : 304 fichiers, plus des redirections 301

Chaque ligne est une décision qui semblait juste au moment où on l'a prise.

Le problème, c'est la forme, pas le contenu

Le savoir en sécurité n'a pas d'axe naturel unique. Tu peux trier les attaques Active Directory par étape de la kill chain, par protocole, par outil ou par surface d'attaque. Chaque option se défend. Les mélanger, c'est ce qui tue : le jour où un dossier trie par étape et son voisin par protocole, chaque nouvelle page a deux maisons, et l'arbre se met à mentir.

Faire grandir une base de connaissances, ce n'est pas ajouter des pages. C'est ajouter des pages sans déplacer les anciennes.

Les règles qui ont fini par tenir

Elles viennent toutes de choses cassées. Chacune est maintenant écrite.

1. La structure d'abord. Chaque page est planifiée comme un sujet de la taxonomie avant que quiconque l'écrive. Aujourd'hui l'arbre compte 8 863 sujets, et la plupart sont encore des brouillons. C'est le but : la carte existe avant le territoire.

2. Un seul critère de tri par niveau. Jamais deux critères à la même profondeur. Active Directory est maintenant trié par surface d'attaque, pas par étape de la kill chain, et la section fourre-tout « Enumeration » a disparu.

3. Un concept, un seul endroit. Si un sujet peut vivre dans deux branches, c'est l'arbre qui a tort, pas le sujet.

4. Pas de tiroir à bazar. Jamais de catégorie « Vulnerabilities ». Une catégorie a au moins deux enfants. « Windows » et « Linux » vivent sous « Operating Systems », pas côte à côte à la racine.

5. Nommer la feuille, pas le chemin. C'est Injection › Command, pas Injection › Command Injection. La page sur le SMTP smuggling s'appelle Smuggling. L'arbre dit déjà SMTP.

6. Des URL stables par construction. Un sujet est une structure (un dossier sans page), une section (un dossier avec sa page) ou une page. Une section garde son URL quand des enfants arrivent plus tard : grandir ne casse pas les liens.

7. « Ready » veut dire que ça ne bougera plus. Une branche n'est marquée prête qu'une fois son sous-arbre assez stable pour grandir sans réorganisation.

8. La source de vérité, c'est la structure. Pas les dossiers. La taxonomie vit dans une base de données, derrière un serveur MCP avec des outils comme topic_find_similar et topic_check_duplicate_title. Les fichiers Markdown suivent.

Où on en est

Sujets planifiés8 863
Profondeur17 niveaux
Pages écrites1 793
Langues70
ParcoursFoundation, Offensive, Defensive, Governance, Intelligence, Career

Et comme une bibliothèque structurée se lit aussi très bien par les machines, elle fournit un serveur MCP gratuit, en lecture seule. Branche-le à Claude ou ChatGPT et ton assistant peut chercher dans l'arbre, lire une page ou parcourir un plan.

Ce n'est pas encore résolu

Je ne vais pas prétendre que l'arbre est fini. Quelques dossiers ont encore des doublons qui ne diffèrent que par la casse. Certaines règles contredisent des règles plus anciennes. Chaque gros déplacement, ce sont encore des centaines de fichiers et une pile de redirections.

Mais la question « on la range où ? » a maintenant une réponse avant que la page existe. C'est la différence entre un tas de notes et une bibliothèque.

Lis-la, casse-la

Si tu trouves une technique dans la mauvaise branche, ouvre une issue. C'est exactement le bug que je veux qu'on me remonte.

Livrez le correctif. Puis partagez le patch.