Cryptage de pcWiki du 19/11/2026

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: CRYPTAGE, PCWIKI

Le 19/11/2026:
Statut Référence
Date 2026-11-19
Hôte(s) srv18 (wiki, vault, extension) ; hal (sources de pcWikiDecrypt)
Commande clé pcWikiDecrypt --list dump.sql

Objectif

Protéger un passage d'une page du pcwiki en l'entourant de la balise <pcSecret> et </pcSecret>. Le reste de la page, son titre, son historique et ses résumés restent visibles. Le texte du passage est chiffré en base de données : un vol de la base ne le révèle pas.

Cette fonction est fournie par l'extension locale PagePassword (MediaWiki 1.46.0), dans /var/www/html/mediawiki/extensions/PagePassword/.

Prérequis

  • Le vault pcSecretd actif sur srv18 et un secret nommé pcwiki (pcSecretClient --list doit le lister).
  • Le service pcwiki-key.service actif : il dépose la clé et l'empreinte de déverrouillage dans /run/pcwiki/ (mémoire, jamais sur disque).
  • Pour pcWikiDecrypt : libpcSecret, libsodium-dev (apt install libsodium-dev) et, pour interroger le vault, être root.

Principe

Blocs balisés

  • À l'enregistrement, le contenu de chaque bloc est chiffré (XChaCha20-Poly1305, libsodium) et stocké sous la forme PPENC1:… entre les balises. Un filet de sécurité au niveau du stockage couvre aussi edit.php et les imports.
  • À l'affichage, un visiteur voit un cadre « Contenu protégé par mot de passe » avec un lien vers le formulaire de déverrouillage.
  • Une page contenant la balise n'est jamais mise dans le cache d'analyse : son affichage dépend de la session.
  • L'index de recherche Sphinx (/etc/sphinxsearch/sphinx.conf) n'indexe que le texte public et le titre, jamais le contenu des blocs.

Pages entièrement chiffrées

Une page peut aussi être chiffrée en entier avec un mot de passe propre, par Spécial:GérerMotsDePassePages (réservé aux administrateurs). Ce mécanisme est distinct des blocs balisés.

Clé et mot de passe

  • Le mot de passe de déverrouillage est le secret pcwiki du vault lui-même : il n'est défini sur aucune page du wiki. Seule son empreinte Argon2id est déposée dans /run/pcwiki/unlock.
  • La clé de chiffrement est dérivée du même secret par Argon2id (sel pcwiki-pagepass1, mémoire environ 1 Go, quelques secondes) et déposée dans /run/pcwiki/key par /home/local/bin/pcwikiKeyDeposit.
  • Le formulaire de déverrouillage affiche une note d'aide ; son texte se modifie dans le message MediaWiki:Pcsecret-unlock-hint.

Attention : le mot de passe est unique pour tous les blocs de toutes les pages. Changer le secret pcwiki dans le vault change aussi la clé : les blocs déjà chiffrés deviennent illisibles. Ne pas le changer sans avoir d'abord déchiffré puis rechiffré les pages.

Utilisation

Protéger un passage

Dans l'éditeur du wiki, entourer le texte :

Texte public visible par tous.
<pcSecret>
Texte protégé.
</pcSecret>
Suite publique.

Fermer correctement la balise avec </pcSecret>. Une balise mal fermée est normalisée à l'enregistrement, mais MediaWiki affiche en clair une balise non reconnue tant qu'elle n'a pas été enregistrée.

Documenter la balise : pour la montrer en exemple dans une page, la placer dans <nowiki>, <syntaxhighlight>, <pre>, <source>, <math> ou un commentaire HTML correctement fermés. Ces zones sont ignorées : l'exemple n'est ni chiffré ni indexé. Une zone non fermée n'est pas ignorée.

Déverrouiller et verrouiller

  • Cliquer sur le lien du cadre verrouillé, saisir le secret pcwiki (affichable avec pcSecretClient --print pcwiki).
  • Les blocs déverrouillés ont un fond rouge pastel et un lien « Verrouiller » en haut à droite.
  • Le déverrouillage vaut pour toute la session et expire 10 minutes après la saisie, quelle que soit l'activité. Une connexion ou la déconnexion le supprime aussi.

Modifier un bloc

Une personne déverrouillée voit le texte en clair dans le formulaire de modification ; il est rechiffré à l'enregistrement. Un bloc inchangé conserve son chiffré, ce qui évite une fausse modification dans l'historique. Une personne non déverrouillée voit le texte chiffré et ne doit pas le modifier.

Administration

Élément Valeur
Délai de déverrouillage $wgPagePasswordUnlockTTL (secondes, défaut 600)
Fichier de la clé $wgPagePasswordKeyFile (défaut /run/pcwiki/key)
Fichier d'empreinte $wgPagePasswordUnlockFile (défaut /run/pcwiki/unlock)
Journal d'audit $wgPagePasswordLogFile (défaut /var/log/pcwiki-pcsecret.log ; sans secret : événements, utilisateur, empreinte de session)
Service de dépôt systemctl status pcwiki-key ; relance : systemctl restart pcwiki-key

Sauvegardes de configuration créées : /etc/mediawiki/LocalSettings.php.20261119.avant_pagepassword et /etc/sphinxsearch/sphinx.conf.20261119.avant_pcsecret. La nouvelle requête Sphinx est prise en compte à la prochaine indexation (@daily).

Récupération : pcWikiDecrypt

Programme C++17 pour déchiffrer les pages protégées d'un dump SQL en cas de problème (base restaurée, wiki inaccessible). Il traite les pages entièrement chiffrées et les blocs balisés de la table pcwiki2text.

  • Sources sur hal : /Atelier/pcSecret/V1.04, fichiers src/ClassWiki*.cpp, includes/ClassWiki*.hpp et src/main_pcWikiDecrypt.cpp.
  • Utilise libpcSecret (ClassPcSecret) pour lire le secret pcwiki, puis dérive la clé comme pcwikiKeyDeposit.
  • Aucune cible n'a encore été ajoutée à CMakeLists.txt (fichier à ne modifier qu'avec accord). Compilation manuelle vérifiée sur hal et sur srv18 :
cd /Atelier/pcSecret/V1.04
g++ -std=c++17 -Wall -Wextra -Wpedantic -O2 -Iincludes \
    src/ClassWiki*.cpp src/main_pcWikiDecrypt.cpp \
    build/libpcSecret.a -lsodium -o /tmp/pcWikiDecrypt

Options

Option Rôle
--list liste les textes protégés (old_id, état) ; ne demande aucune clé
--show ID affiche le texte déchiffré de l'old_id ID
-o, --out FICHIER écrit le dump avec les textes déchiffrés (- : sortie standard)
--unwrap retire aussi les balises <pcSecret> (texte en clair, sans protection)
--vault-name NOM, --socket CHEMIN secret et socket du vault (défauts : pcwiki, /run/pcvault.sock)
--secret-stdin lit le secret sur l'entrée standard si le vault est indisponible
--key-file FICHIER clé déjà dérivée (64 caractères hexadécimaux)
--table NOM, --text-column N table et colonne si le dump ne contient pas de CREATE TABLE

Codes de sortie : 0 succès ; 1 erreur ; 2 succès partiel (jetons illisibles, par exemple mauvaise clé).

Exemples

# lister les textes protégés d'une base vivante
mysqldump --single-transaction wiki_pcwiki2 pcwiki2text | pcWikiDecrypt --list -

# produire un dump déchiffré, puis le restaurer
pcWikiDecrypt -o dump.clair.sql dump.sql

# lire une révision précise
pcWikiDecrypt --show 22813 dump.sql

# vault indisponible : saisir le secret
pcWikiDecrypt --secret-stdin -o dump.clair.sql dump.sql

Le dump déchiffré contient le texte en clair : le stocker comme un secret, puis le supprimer après usage. Avec les balises conservées, le wiki continue de masquer les blocs (extension et vault requis) ; avec --unwrap le texte devient public.

Vérification

Contrôles réellement effectués le 2026-11-19 :

  • Sur une page de test, la base ne contient que du chiffré : plus aucune trace du texte secret dans les tables text, searchindex, comment et le cache d'objets ; l'API et action=raw ne renvoient pas le clair.
  • Parcours web complet : verrouillé, mauvais mot de passe refusé, déverrouillage par le secret du vault, bloc ouvert sur fond rouge pastel, lien Verrouiller, bloc de nouveau verrouillé.
  • Expiration à 10 minutes (test en ligne de commande : valide à 9 minutes, refusée à 10 minutes 10, sans prolongation par la lecture).
  • pcWikiDecrypt : dump synthétique au format mysqldump (littéraux _binary, hexadécimal, INSERT avec liste de colonnes, jeton altéré, mauvais secret, secret inconnu) et 5 révisions réelles de la base, avec les trois sources de clé (fichier, vault par libpcSecret, entrée standard).

Non testés : l'enregistrement d'une page depuis le formulaire web par un utilisateur connecté, et la déconnexion réelle depuis le navigateur.

Limites

  • Données non chiffrées : titres, auteurs, tailles, liens (pagelinks, catégories) et empreinte SHA-1 du contenu restent lisibles en base.
  • Copies hors du wiki : dumps, sauvegardes et journaux binaires MySQL réalisés avant la protection peuvent contenir l'ancien texte en clair.
  • Révisions supprimées : les révisions déjà dans les archives restent en clair ; la protection ne concerne que les révisions actuelles.
  • Serveur compromis : qui contrôle www-data sur srv18 lit /run/pcwiki/key. La protection couvre le vol de la base, pas l'intrusion sur le serveur.
  • Typesense : son indexation de pcwiki n'a pas été modifiée ; le binaire /root/bin/typesense-index n'a pas été examiné.
  • Secrets déjà dans le wiki : une page existante contient une clé d'API en clair, lisible publiquement. À renouveler ou à mettre dans un bloc protégé.

Pièges rencontrés

  1. Balise de fermeture incomplète (</pcSecret sans >) : MediaWiki ne reconnaît pas la balise et affiche le texte en clair à tout le monde. La détection de l'extension est maintenant tolérante et normalise la fermeture à l'enregistrement.
  2. Cache mémoire PHP-FPM : après une correction en ligne de commande, le site servait encore l'ancien texte (cache des révisions dans APCu, non vidé par maintenance/). Un systemctl reload php8.4-fpm règle le problème, mais déconnecte les utilisateurs du wiki.
  3. Droits sur /etc/php : en mode 700 (root seul), donc php maintenance/run.php update doit se lancer en root, pas en www-data.
  4. Vault non rechargé : pcSecretd garde le coffre en mémoire ; après modification du fichier, un redémarrage est nécessaire, et la machine doit être enrôlée (pcSecretd --enroll-machine) sinon le démon ne repart pas.
  5. Méthode retirée de MediaWiki 1.46 : ContentHandler::getContentText() n'existe plus ; son usage provoquait une erreur fatale à l'enregistrement d'une page contenant la balise.

Pistes écartées

  1. Indexer le contenu protégé dans Sphinx : l'index serait en clair sur disque, ce qui contredit le chiffrement en base. Choix retenu : indexer seulement le texte public et le titre.
  2. Un mot de passe par page pour les blocs : écarté au profit d'un mot de passe unique, qui est le secret pcwiki du vault.
  3. Déverrouillage prolongé par l'activité : remplacé par une expiration absolue de 10 minutes.
  4. Page Spécial pour définir le mot de passe : retirée, le mot de passe vient du vault.

Rédigé par Claude Code — 2026-11-19