Cryptage de pcWiki du 19/11/2026
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
pcSecretdactif sur srv18 et un secret nommépcwiki(pcSecretClient --listdoit le lister). - Le service
pcwiki-key.serviceactif : 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 aussiedit.phpet 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
pcwikidu 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/keypar/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 avecpcSecretClient --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, fichierssrc/ClassWiki*.cpp,includes/ClassWiki*.hppetsrc/main_pcWikiDecrypt.cpp. - Utilise
libpcSecret(ClassPcSecret) pour lire le secretpcwiki, puis dérive la clé commepcwikiKeyDeposit. - 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,commentet le cache d'objets ; l'API etaction=rawne 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 formatmysqldump(littéraux_binary, hexadécimal,INSERTavec 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 parlibpcSecret, 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-datasur 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-indexn'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
- Balise de fermeture incomplète (
</pcSecretsans>) : 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. - 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/). Unsystemctl reload php8.4-fpmrègle le problème, mais déconnecte les utilisateurs du wiki. - Droits sur
/etc/php: en mode700(root seul), doncphp maintenance/run.php updatedoit se lancer en root, pas enwww-data. - Vault non rechargé :
pcSecretdgarde 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. - 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
- 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.
- Un mot de passe par page pour les blocs : écarté au profit d'un mot de passe unique, qui est le secret
pcwikidu vault. - Déverrouillage prolongé par l'activité : remplacé par une expiration absolue de 10 minutes.
- 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