Registre officiel de Cassandra
La boutique de modules de Cassandra, où chaque module est signé et vérifiable.
🔎 Voir les modules : https://marplestrange.github.io/cassandra-registre/ (recherche, filtres, une fiche par module)
🇬🇧 English version: README.en.md
En une phrase
Cassandra est une IA qui administre vos serveurs et votre travail. Pour lui ajouter des capacités (un thème, un pont vers un logiciel, un métier), on installe des modules. Ce dépôt est la liste officielle de ces modules, et la preuve que chacun vient bien de qui il dit venir.
Pourquoi ça existe
Un module tourne dans Cassandra, avec ses droits. Installer un module, c'est donc faire confiance à son auteur. Avant d'installer, vous devez pouvoir répondre à trois questions :
- Qui l'a écrit ? Chaque module est signé : par l'équipe de Cassandra (« Officiel ») ou par un éditeur dont l'identité a été vérifiée (« Éditeur vérifié »).
- Est-ce bien le code d'origine ? Une archive modifiée après sa signature est refusée. Le code d'un module d'éditeur doit en plus correspondre à son dépôt public : vous pouvez le relire tel qu'il est publié.
- Que demande-t-il ? Chaque fiche liste ce que le module annonce faire (parler au réseau, lancer des processus…). Un module qui fait plus que ce qu'il annonce est refusé.
Et si un module se révèle dangereux, il est révoqué : toutes les installations de Cassandra le savent et refusent de l'installer.
Installer un module
Dans Cassandra : menu de l'avatar › Logithèque › Boutique. Rien ne s'installe sans votre accord, et Cassandra vous montre ce que le module demande avant.
Ce qui protège (sans jargon)
| Risque | Ce qui l'empêche |
|---|
| Un faux module qui se fait passer pour un autre | chaque archive est signée ; un éditeur ne publie que sous son propre nom (<éditeur>_module) |
| Un module modifié en route | l'empreinte de chaque fichier est contrôlée à l'installation |
| Un site pirate qui sert un faux catalogue | la liste elle-même est signée ; Cassandra connaît la clé et refuse tout le reste |
| Un vieux catalogue rejoué pour cacher un module retiré | chaque liste a un numéro qui ne recule jamais ; Cassandra refuse un numéro plus ancien |
| Un registre abandonné qu'on croirait encore à jour | la liste expire, et une preuve de fraîcheur est renouvelée chaque jour |
| Un module qui en fait plus qu'annoncé | le code est analysé contre ses permissions déclarées avant publication |
| Une panne de l'hébergeur | des miroirs peuvent servir la même liste (tout est signé, ils n'ont pas besoin d'être sûrs) |
Ce que le registre ne garantit pas : un module installé tourne avec les droits de Cassandra. La signature dit qui a publié, la relecture dit ce que fait le code. Le détail est dans SECURITE.md.
Vérifier par vous-même
Ne nous croyez pas sur parole : un script de dix minutes de lecture, qui ne dépend que de Python et d'openssl et n'utilise pas nos outils, vérifie le registre publié.
python outils/verifier_independant.py --module billetterie
Il porte en dur les deux clés racine. Comparez leurs empreintes (SHA-256 de la clé publique) à celles-ci, et à celles que nous annonçons ailleurs (site, messages publics) : si elles concordent, vous vérifiez bien contre la clé de Cassandra, quoi qu'on ait mis dans ce dépôt.
| Clé | Empreinte SHA-256 |
|---|
| racine principale | b8480dd60c5fb3c58a78b96c1adb3e9ecf2f82dc9deae60ed174fbbfa8e5e40b |
| racine de secours | d40407cfa327559acd7fbd6d867690417cfd77e36efe423ba99ce04c8181d4ae |
Si la clé principale doit être remplacée, la procédure est dans ROTATION.md : seule la clé de secours peut l'annoncer.
Publier un module
- Copiez le modèle de module et écrivez votre module.
- Signez-le avec votre clé d'éditeur.
- Ouvrez une pull request ici : CONTRIBUER.md explique chaque étape.
- Pour devenir éditeur vérifié : editeurs/LISEZ-MOI.md.
Qui porte ce projet
Cassandra est portée par La Maison Bohème, association loi 1901 (SIREN 899 553 093), qui accepte les dons (SOUTIEN.md). Le code est libre (AGPL-3.0) : le meilleur soutien reste d'écrire ou de relire un module.
Pour les mainteneurs
python outils/registre.py verifier archives, code, éditeurs, révocations, avis, journal, index, fraîcheur ; code 1 au moindre défaut
python outils/registre.py provenance chaque archive qui déclare sa source est reconstituée depuis elle, fichier par fichier
python outils/registre.py publier --cle racine.pem --jours 180 signe l'index (série suivante), écrit docs/ et le journal
python outils/registre.py vitrine réécrit la vitrine depuis l'index publié (ne signe rien)
python outils/fraicheur.py renouveler --cle fraicheur.pem signe et publie la fraîcheur (tâche planifiée, chaque jour)
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
