25. La console d’administration¶
Pepsi livre une petite console de navigateur, servie par pepsi-httpd sous /ui. Elle existe pour ce qui est pénible en ligne de commande : surveiller la file d’attente, parcourir les clés et les correspondants, lire le journal d’audit, et modifier la configuration avec la validation et la provenance sous les yeux.
Elle est cliente de l’API d’administration documentée (L’API d’administration) et rien de plus. Chaque page appelle les mêmes fonctions de bibliothèque qu’appellent les points de terminaison /api/v1, à travers la même authentification, les mêmes vérifications de portée et le même journal d’audit. Tout ce que la console sait faire peut donc aussi se faire avec curl, et les deux ne peuvent pas être en désaccord sur ce que contient la file d’attente ni sur la validité d’une valeur de configuration.
Note
Il y a deux API HTTP dans ce serveur et elles ne sont pas la même. /api/v1 est celle de Pepsi (L’API d’administration), dont cette console est un client : comptes, portées, sessions et CSRF, conditionnée à ADMIN = yes. /3.0/ et /3.1/ sont l’API REST de GNU Mailman 3 (L’API REST de GNU Mailman 3), réimplémentée pour que les logiciels Mailman fonctionnent avec Pepsi : un mot de passe partagé, aucune portée, les formes de quelqu’un d’autre, conditionnée à LIST_API = yes. Un exploitant rencontrera les deux ; elles partagent le serveur et rien d’autre, et aucune n’est une version de l’autre.
25.1. Trois drapeaux d’écouteur, et pour deux d’entre eux le conseil est inverse¶
pepsi-httpd sert quatre choses et en conditionne trois, chacune à son propre drapeau dans [pepsi-httpd-listener-*]. Les confondre est de loin la façon la plus simple de mal déployer la surface HTTP de Pepsi : ils sont donc réunis dans un tableau :
Drapeau |
Ce qu’il sert |
À qui il est destiné |
Où le placer |
|---|---|---|---|
|
|
L’exploitant. Jetons porteurs, sessions par mot de passe, |
Derrière un tunnel. Un socket UNIX, ou la boucle locale avec un proxy inverse. |
|
|
Les logiciels de listes de diffusion ( |
Boucle locale ou TLS. Le même refus que pour |
|
|
Le public anonyme. Aucun identifiant du tout. |
Sur l’internet ouvert. C’est la seule surface destinée à être joignable : la restriction sur le clair ne s’y applique donc délibérément pas. Mais un formulaire d’abonnement porte l’adresse de quelqu’un, utilisez donc l’écouteur TLS. |
(aucun) |
MTA-STS, Web Key Directory, autoconfiguration du courrier, le portail des liens sécurisés, |
Quiconque en a besoin, par conception. |
Là où se trouve l’écouteur public. |
Sur un écouteur dépourvu de son drapeau, chaque route conditionnée répond un simple 404, octet pour octet ce que répond un chemin inconnu. C’est pourquoi publier l’écouteur HTTPS public ne publie pas l’administration, et pourquoi un écouteur public ne peut pas être sondé pour savoir ce que ce serveur fait tourner d’autre.
25.2. L’atteindre en toute sécurité¶
La console se monte exactement sur les écouteurs où se monte l’API : ceux marqués ADMIN = yes (voir pepsi-httpd(1)). Sur tout autre écouteur, les chemins /ui répondent un simple 404, octet pour octet ce que répond un chemin inconnu, de sorte que publier l’écouteur public ne publie pas la console et qu’un écouteur public ne peut pas être sondé pour savoir si l’administration est activée ici.
pepsi-httpd refuse de la servir sur un écouteur marqué qui la transporterait en clair hors de cet hôte : le TCP en clair n’est accepté que sur une adresse de boucle locale, tandis que les écouteurs TLS et les sockets UNIX conviennent toujours. Un écouteur activé par socket (SERVE = systemd) sans TLS ne convient jamais, quoi que lie son unité. Le descripteur transmis pourrait être n’importe quoi, et le traiter comme autorisé ferait passer le cas le plus strict par la vérification la plus lâche ; donnez donc à l’administration un écouteur à elle. Il ne s’agit pas seulement d’écoute clandestine. Le cookie de session ne porte le préfixe __Host- (RFC 6265bis §4.1.3.2) que lorsqu’il est posé Secure, c’est-à-dire seulement lorsque la connexion du client est en HTTPS, puisqu’un navigateur refuse un cookie __Host- qui n’est pas Secure. Sur le chemin d’amorçage en clair par la boucle locale, ni l’un ni l’autre n’est employé : l’authentification propre de la console est donc structurellement plus faible sur une origine en clair. Un navigateur ne peut pas ouvrir une socket UNIX, aussi un déploiement typique
lie-t-il un écouteur d’administration à
127.0.0.1et l’atteint par un tunnel SSH (ssh -L 8443:127.0.0.1:8443 mail.example.com), ou biendonne-t-il à l’écouteur d’administration du TLS et un nom à lui, et le traite comme toute autre surface d’administration exposée à l’internet.
25.3. Se connecter¶
Deux des trois mécanismes de l’API sont utiles depuis un navigateur :
Un opérateur local sur la socket UNIX d’administration est identifié par SO_PEERCRED et n’a besoin d’aucun mot de passe. Les navigateurs ne savent pas parler à une socket UNIX : cette voie est donc pour curl et pour l’amorçage au premier démarrage ; c’est aussi ce qui rend acceptable la politique de session stricte ci-dessous.
Un administrateur distant se connecte à /ui/login avec un compte de pepsi.admin_account (créez-en un avec POST /api/v1/accounts). Les sessions ont un délai d’inactivité de 30 minutes et une durée de vie ferme de 12 heures quelle que soit l’activité, et il n’y a pas de « se souvenir de moi ». Cette console peut révoquer une clé, lire qui correspond avec qui et réécrire le pipeline ; un onglet de navigateur oublié ne devrait plus détenir ce pouvoir demain, et un portable volé ne devrait pas être une session d’administration permanente.
Les jetons porteurs fonctionnent aussi, mais un navigateur n’a aucun moyen d’en attacher un ; ils sont destinés à l’automatisation contre /api/v1.
Une vérification de mot de passe est un Argon2id, exécuté hors de l’exécuteur des requêtes, avec au plus une vérification par CPU à la fois ; une connexion qui ne trouve aucun créneau libre en cinq secondes reçoit une réponse de limitation de débit ([pepsi-admin] LOGIN_RATE_LIMIT limite en outre les tentatives par compte et par adresse source, et LOGIN_DAILY_LIMIT limite les connexions échouées par compte et par jour). Un compte doté d’un second facteur (pepsi-keys otp enroll --console LOGIN) doit aussi fournir le code courant à six chiffres dans le champ de code du formulaire, que l’applicateur de configuration vérifie avant l’ouverture de la session ; un code absent ou erroné reçoit exactement la même réponse qu’un mauvais mot de passe. Un compte inconnu est vérifié contre un hachage factice, de sorte que le temps de réponse ne dit pas quels comptes existent. Ce qu’un mot de passe deviné ou volé donne à un attaquant est exposé dans Un administrateur délégué.
25.3.1. Clés de sécurité¶
Un compte de console (et un utilisateur final qui se connecte par courrier, ci-dessous) peut enregistrer des clés de sécurité comme second facteur à côté du code TOTP. Les clés de sécurité sont des identifiants WebAuthn : une clé matérielle, un téléphone ou l’authentificateur intégré d’un ordinateur portable. N’importe laquelle des clés enregistrées termine une connexion, tout comme le code TOTP là où le compte en a un et où l’opérateur n’a pas exigé de clés. Une clé ne remplace jamais un mot de passe.
Ce qu’une clé ajoute par rapport à un code, c’est la résistance à l’hameçonnage. Un code TOTP est un secret que l’utilisateur saisit, et une page imitée convaincante peut le demander et le relayer à la vraie console dans ses trente secondes. Une clé signe l’origine réelle de la page et le nom de ce serveur, tous deux fournis par le navigateur et non par la page, si bien qu’une réponse obtenue sur un site imité ne se vérifie pas ici (Un proxy d’hameçonnage (adversaire au milieu)).
Enregistrement. Une fois connecté, ouvrez Clés de sécurité (/ui/security, lien à côté du bouton de déconnexion), nommez la clé, saisissez le mot de passe du compte et appuyez sur Enregistrer une clé de sécurité ; le navigateur demande la clé. Un compte qui a déjà une clé en ajoute une autre en deux temps : le mot de passe et Confirmer avec la clé de sécurité (l’une des clés existantes, ou le code TOTP là où il peut en tenir lieu), puis l’enregistrement de la nouvelle clé sur la page qui suit. Un cookie de session volé ne peut donc pas ajouter la clé du voleur. À partir de la connexion suivante, un mot de passe correct mène à une seconde page qui demande l’une des clés (ou propose le champ de code là où le TOTP peut en tenir lieu).
Supprimer une clé exige le mot de passe et une confirmation avec l’une des clés du compte (celle qu’on supprime convient) ou le code TOTP du compte ; un cookie de session volé ne peut donc ni remplacer la clé par celle de son voleur, ni la retirer. Le recours de l’opérateur pour une clé perdue est DELETE /api/v1/accounts/{id}/webauthn (qui met aussi fin aux sessions du compte), le pendant de pepsi-keys otp reset --console.
Exiger des clés. [pepsi-httpd] REQUIRE_WEBAUTHN = admins (ou users, members, all) fait d’une clé le seul second facteur de ce type de compte : le code TOTP ne termine plus une connexion, un compte sans clé est guidé dans l’enregistrement d’une clé comme dernière étape de sa connexion suivante, et sa dernière clé ne peut pas être supprimée. La valeur par défaut est no.
Les clés sont liées à [pepsi-admin] CONSOLE_URL (par défaut ENROL_URL), l’origine https:// publique sous laquelle on atteint la console ; sans l’une ni l’autre, la console ne propose pas de clés. Une clé signe pour l’hôte auprès duquel elle a été enregistrée, si bien qu’un changement d’hôte rend les clés enregistrées inutilisables. Choisissez un nom que les utilisateurs garderont. Pepsi ne demande aucune attestation (il ne juge pas les modèles d’authentificateurs) et accepte les clés ES256 et Ed25519 ; le mécanisme est décrit dans Clés de sécurité (WebAuthn).
25.4. Ce que la console peut et ne peut pas faire¶
Les actions sont au niveau des messages et des clés uniquement :
remettre en file un message bloqué à son étape actuelle, l’acheminer vers une étape de rebond, ou le supprimer sans le remettre ;
libérer ou supprimer un message que retient une étape de quarantaine (Quarantaine) ;
autoriser ou refuser un client, un domaine ou un expéditeur pour le greylisting, et retirer une telle règle (Greylisting) ;
publier ou retirer une identité locale, en rendre une principale, la supprimer, ou demander son téléversement vers le serveur de clés ;
demander à l’applicateur une clé gérée par le serveur, l’enregistrement de la propre clé publique d’un utilisateur, la révocation d’une identité, la construction d’une demande de certificat sur la clé d’une identité S/MIME, ou l’installation du certificat qu’une AC a émis à partir de celle-ci (les cinq passant par l’applicateur privilégié, ci-dessous) ;
importer à la main la clé d’un correspondant, mettre en file une recherche de découverte, revérifier une clé de correspondant en cache (la faire expirer et mettre en file une recherche forcée) et en oublier une ; ajouter une ancre de confiance, définir ou lever sa portée (les domaines de messagerie pour lesquels on lui fait confiance ; une ancre qui se porte garante de tout domaine est signalée), et en supprimer une. Chaque formulaire appelle la même fonction que son point d’accès d’API (
POST /api/v1/peers,.../discover,.../{id}/recheck,POST /api/v1/ca-trust,PUT /api/v1/ca-trust/{id}/scope), si bien que la console ne peut pas accepter ce que l’API refuse : un blob qui n’est pas une clé, une clé nommant une autre adresse, un certificat qui n’est pas celui d’une AC. Une clé de domaine*@domainreste du ressort de pepsi-keys(1) ;révoquer un message à lien sécurisé ;
configurer la PKI gérée d’un domaine et modifier ses utilisateurs : approuver ou corriger un nom, sélectionner un utilisateur, en exclure un ou en supprimer un (Certificats gérés) ; les commandes elles-mêmes, et l’identifiant de l’AC, restent l’affaire de
pepsi-keys mpki;poser ou retirer une redéfinition de configuration ;
répondre au questionnaire de configuration initiale, et demander à l’applicateur privilégié d’exécuter certbot, d’installer le schéma, de provisionner des rôles, de vérifier le DNS ou de faire tourner les clés DKIM d’un domaine.
Il n’y a délibérément aucun bouton de redémarrage, d’arrêt ou de sauvegarde. Une console web capable d’arrêter le serveur de messagerie est une console que l’on peut tromper pour qu’elle arrête le serveur de messagerie, et systemd possède déjà ce rôle. Redémarrez un composant avec systemctl restart pepsi-ingress (les pages de configuration nomment l’unité lorsqu’un changement en exige un).
Tout ce qui est privilégié ici a cette forme : la console note ce qui devrait se produire et un programme root distinct le fait. La console ne peut pas écrire /etc, exécuter certbot ni créer un rôle de base de données, et ne doit pas le pouvoir. Nous procédons ainsi pour qu’une faille dans le traitement des requêtes ne puisse pas devenir une exécution de commandes en root (voir Injection de commandes et XXE dans les interfaces de gestion des passerelles de messagerie). Voir « La configuration initiale dans le navigateur » ci-dessous.
Deux autres choses que la console ne peut pas faire, parce que le serveur ne le peut pas :
Générer ou révoquer le matériel de clé lui-même. Cela requiert le rôle de base de données
pepsi-crypto, qui détient le droit sur la colonne privée et que pepsi-httpd ne détient délibérément pas. Un niveau web capable de créer des clés de signature est un niveau web dont la compromission crée des clés de signature. Le formulaire Générer une clé gérée par le serveur de la page des identités ne fait donc que demander : il met en file une tâchegenerate-identityquepepsi-setup applyrevalide et exécute en tant quepepsi-crypto. Enregistrer ma propre clé (coller une clé publique OpenPGP en armure) met en fileregister-client-keyde la même manière, et le bouton Révoquer d’une identité, une fois confirmé, met en filerevoke-identity, car révoquer une clé de signature seule détruit sa moitié privée, ce qui est une écriture dans cette colonne. Chacun répond avec la page propre de la tâche mise en file,/ui/setup/tasks/<id>, que l’utilisateur qui l’a demandée peut ouvrir quelles que soient ses portées. Cette page affiche l’issue (terminée, échouée avec la raison, ou refusée) dès que l’applicateur l’enregistre. Les trois répondent503lorsque le paquet de l’applicateur n’est pas installé. Chaque formulaire a aussi un champ Code du second facteur : un utilisateur qui a enrôlé un second facteur (Gestion des clés) y saisit le code courant de son application d’authentification, et l’applicateur le vérifie, car la console ne le peut pas. La page d’une identité S/MIME ajoute Demander un certificat (PKCS#10) et Installer le certificat émis, qui mettent en fileidentity-csretidentity-certificatede la même manière : la demande est signée avec la clé privée de l’identité et l’installation ré-enveloppe celle-ci. La page de la tâche affiche la demande PEM seule, prête pour l’AC, ainsi que l’issue de l’installation, ou la raison pour laquelle l’installation a été refusée (un certificat sur une autre clé, pour une autre adresse, un certificat d’AC, le mauvais usage de clé).Écrire la surcouche de configuration, à moins que
[pepsi-admin] CONFIG_DBne nomme une connexion s’authentifiant comme le rôlepepsi-config. Sans elle, les pages de configuration sont en lecture seule et disent pourquoi.
La console ne montre jamais non plus les en-têtes ou le corps d’un message. Les pages de file d’attente chargent l’enveloppe, l’étape, le statut et le JSON state, et rien d’autre. C’est structurel : la requête derrière elles ne sélectionne pas ces colonnes. Lire du courrier n’est pas une fonction d’administration.
25.5. Les pages¶
Chemin |
Portée |
Ce qu’elle montre |
|---|---|---|
|
|
Tableau de bord : profondeur de file par |
|
|
Listage filtrable (par étape et par statut), paginé, avec un rechargement toutes les 30 secondes que l’on active explicitement. |
|
|
Un message : enveloppe, étape, statut et |
|
|
Les messages que retient une étape de quarantaine, du plus ancien au plus récent, avec pour chacun qui l’y a envoyé et pourquoi (Quarantaine). |
|
|
Un message retenu : enveloppe, |
|
|
Les décisions du greylisting des dernières 24 heures, les triplets récents (filtrables par état, domaine, client et destinataire) et les règles. Les formulaires d’autorisation, de refus et de retrait exigent |
|
|
Le courrier que le greylisting a différé vers la propre adresse de l’utilisateur, avec Autoriser cet expéditeur (Greylisting). |
|
|
Les paires de clés locales, filtrables par adresse, avec les formulaires Générer une clé gérée par le serveur et Enregistrer ma propre clé ( |
|
|
Une identité, avec sa garde (clé gérée par le serveur ou propre clé de l’utilisateur) et son état sur le serveur de clés, et publier / retirer / Téléverser vers le serveur de clés / rendre principale / révoquer ( |
|
|
Clés de correspondants mises en cache : source, indicateur DNSSEC, validité, état d’épinglage. Avec |
|
|
Les ancres de confiance S/MIME et leurs portées ; en ajouter une ( |
|
|
Les domaines dont les certificats S/MIME sont commandés auprès d’une AC, avec pour chacun s’il est activé, son mode d’enrôlement et son nombre d’utilisateurs ; ajouter un domaine ( |
|
|
Un domaine : ses réglages, ses utilisateurs avec leur commande la plus récente et ce qu’elle attend, et ses commandes récentes. Enregistrer les réglages, ajouter un utilisateur ( |
|
|
Les commandes passées auprès de l’AC, les plus récentes d’abord, filtrables par domaine et par adresse, ou limitées aux commandes en cours. |
|
|
Les avis destinés aux administrateurs, ou seulement les non lus (la cloche de l’en-tête des pages mène ici). Les marquer comme lus ( |
|
|
Chaque section de la configuration effective pour une portée, avec la façon dont un changement prend effet. |
|
|
Une section : la valeur de chaque option, d’où elle vient (fichier, global, domaine, adresse), et les formulaires pour poser ou retirer une redéfinition ( |
|
|
Le journal d’audit, filtrable par nature et par acteur. |
|
|
Le journal par message, sur option, filtrable par adresse ; le dit clairement lorsque |
|
|
Issues des sessions TLS sortantes par domaine de politique. |
|
|
Adresses MX que le cache du résolveur marque actuellement comme en échec. |
|
|
Les sources des rapports agrégés DMARC que d’autres destinataires ont envoyés au sujet des domaines servis ( |
|
|
Les domaines servis, le mode MTA-STS, combien d’identités sont publiées sous chacun, et les enregistrements DNS à publier avec le dernier verdict en direct pour chacun. Le bouton « vérifier le DNS maintenant » exige |
|
|
Les messages à lien sécurisé que le portail retient : correspondants, expiration, lectures, PIN erronés, verrouillages. La révocation exige |
|
|
Un message avec son historique d’accès. |
|
|
Le point d’entrée de l’entretien de configuration initiale ; chaque étape est |
|
|
Ce qui a été demandé à l’applicateur privilégié, et un formulaire pour en demander davantage. Sans |
|
|
Une action avec la progression diffusée de l’applicateur, mise à jour dès que l’applicateur écrit quelque chose. |
Aucune page ne charge un ensemble de résultats non borné : chaque listage passe par une requête portant son propre LIMIT/OFFSET, c’est donc une propriété du SQL plutôt que de ce que dessine le moteur de rendu. Les vues de file d’attente et de journal paginent avec ?limit=/?offset= (plafonnés à [pepsi-admin] PAGE_LIMIT, au plus 1000). Les listages du magasin de clés (identités, correspondants, ancres de confiance) récupèrent l’équivalent d’une page, plus une ligne pour savoir s’il y en a davantage, et disent clairement quand ils ont été tronqués ; restreignez-les avec le filtre d’adresse, ou utilisez pepsi-keys(1). La console ne demande un COUNT(*) que là où elle affiche un total (les deux vues de journal) ; l’API le fait toujours, car ses clients paginent par programme. Voir L’API d’administration.
Chaque action destructrice passe d’abord par une page de confirmation explicite : supprimer un message en file d’attente, libérer ou supprimer un message en quarantaine, révoquer ou supprimer une identité, retirer une ancre de confiance, retirer une redéfinition de configuration ou une règle de greylisting, et exclure ou supprimer un utilisateur de la PKI gérée, ce qui révoque ses certificats. Chaque mutation est écrite au journal d’audit avec la même nature d’événement que celle qu’enregistre l’API, de sorte que /ui/logs montre indifféremment les changements faits depuis la console, depuis curl et depuis les outils en ligne de commande.
Les valeurs de configuration susceptibles de porter un secret sont affichées comme ***, jamais comme des valeurs, selon la règle même qu’emploie l’API. La liste est délibérément généreuse : une valeur masquée à tort coûte à un opérateur un coup d’œil dans le fichier, alors qu’une valeur affichée à tort est publiée à tous ceux qui détiennent config:read.
25.5.1. La configuration initiale dans le navigateur¶
/ui/setup rend le même questionnaire que pepsi-setup --wizard pose à un terminal. C’est littéralement le même, car les questions, leurs formes, leurs valeurs par défaut et les conditions dans lesquelles elles sont posées vivent en un seul endroit sous forme de données (pepsi-setup-model) et les deux frontaux les rendent. Une question ajoutée à l’un est une question ajoutée aux deux.
Deux mécanismes distincts la rendent sûre :
Les réponses sont des brouillons. Chaque étape écrit dans pepsi.config_override avec l’indicateur draft, que chaque lecteur de configuration filtre structurellement. Rien ne prend effet pendant que le questionnaire est en cours, de sorte qu’une session qui expire à mi-chemin n’a pas à moitié configuré un serveur de messagerie, et rouvrir la page reprend là où on s’était arrêté. Une étape avec une mauvaise réponse se réaffiche avec le message à côté du champ et ne stocke rien, pas même les bonnes réponses de la même page, car une étape à moitié stockée est une étape qu’un opérateur doit reconstruire de mémoire.
Les actions sont des intentions. /ui/setup/tasks montre ce qui a été demandé à l’applicateur privilégié et offre un formulaire pour en demander davantage, dans son ensemble fermé : run-preflight, obtain-certificate, install-schema, provision-roles. L’ensemble est fermé pour que la sonnette ne soit pas un canal général de commandes root (voir Des appliances de messagerie stockent des secrets lisibles par tous ou non protégés). Un bouton écrit une ligne pepsi.setup_task et sonne à une sonnette ; pepsi-setup apply, tournant en root, fait le travail et rediffuse sa progression dans la ligne, qu’affiche /ui/setup/tasks/<id>. Pendant l’exécution de la tâche, la page se recharge d’elle-même (un <meta http-equiv="refresh">, pas un minuteur en script), et ce rechargement n’interroge pas en boucle : il redemande la page avec ce qu’elle affichait déjà, et le serveur retient cette requête jusqu’à 20 secondes, jusqu’à ce que la notification de l’applicateur signale une nouvelle ligne de progression ou une issue. Le résultat apparaît donc au moment même où il existe. Si le serveur a perdu sa connexion d’écoute à la base de données, il répond immédiatement et la page se rabat sur un rechargement toutes les cinq secondes. Il n’y a pas d’action de redémarrage ou d’arrêt ; un changement qui exige le redémarrage d’un composant se termine par vous le redémarrant.
Les deux exigent setup:write, lectures comprises : les réponses préparées sont la forme d’un déploiement en construction et la liste des tâches est un registre de travail privilégié. La seule exception concerne les propres demandes d’un utilisateur : les actions sur les clés des pages d’identités mettent elles aussi des tâches en file, et quiconque en a mis une en file peut l’ouvrir et la trouver dans /ui/setup/tasks, qui pour lui ne liste rien d’autre. La tâche de quelqu’un d’autre est « introuvable ».
Deux conditions indépendantes doivent être réunies avant que quoi que ce soit puisse être enregistré, et la page indique laquelle manque :
l”applicateur privilégié doit exister : le paquet Debian distinct
pepsi-httpd-admin, qui contientpepsi-setup-apply.socketet son service. C’est unRecommends, il est donc installé par défaut et peut être retiré sans emporter Pepsi avec lui ; et[pepsi-admin] CONFIG_DBdoit nommer une connexion s’authentifiant comme le rôlepepsi-config, car l’applicateur refuse toute ligne qui n’a pas été écrite par lui.
L’applicateur est vérifié en premier, car sans applicateur, configurer CONFIG_DB ne servirait à rien. Lorsque l’un ou l’autre manque, l’entretien se dégrade en lecture seule plutôt que de stocker des réponses que rien n’appliquera : chaque valeur est toujours rendue, les champs de saisie reviennent disabled/readonly, le bouton d’enregistrement disparaît, et un message éclair nomme la raison. Les appels d’API correspondants répondent 503 setup_applier_unavailable ou 503 setup_write_unavailable (voir L’API d’administration). La seule exception délibérée est le rejet d’un brouillon : cela ne peut causer aucune modification privilégiée, et un entretien coincé doit rester effaçable.
Notez que les pages /ui/config ne sont pas affectées par l’absence d’applicateur : elles écrivent pepsi.config_override, une table de base de données, non /etc. Elles n’ont besoin que de CONFIG_DB, et de rien d’autre.
Une réponse de forme password est rendue vide à chaque fois, jamais renvoyée dans un attribut value=, et soumettre l’étape en la laissant vide laisse tel quel ce qui est stocké. L’entrée d’audit d’une étape nomme les identifiants des questions et aucune valeur.
25.5.2. Liens sécurisés¶
/ui/secure liste les messages que le portail de lien sécurisé retient pour des destinataires sans clé : de qui et pour qui ils sont, quand ils expirent, combien de fois le PIN a été saisi correctement et incorrectement, et si un verrouillage est en vigueur. /ui/secure/<token> y ajoute le journal d’accès.
Le message lui-même n’est sur aucune des deux pages, et ne peut pas y être. pepsi-httpd est le portail : c’est donc le seul rôle de base de données à qui la colonne de texte chiffré est accordée. C’est exactement pour cela que les pages d’opérateur ne la lisent pas. Les requêtes derrière elles nomment chaque colonne sauf celle-là et n’en rapportent que la longueur, de sorte que la discipline vit dans le SQL plutôt que dans un champ de structure que quelqu’un a pensé à omettre. Révoquer détruit l’unique copie du message et exige donc secure:write, une capacité distincte de secure:read.
25.5.3. Le DNS sur la page des domaines¶
/ui/domains montre, à côté de chaque domaine servi, chaque enregistrement DNS que Pepsi attend qu’il publie : le nom, la valeur à publier, si le DNS en direct le porte, et quoi faire quand ce n’est pas le cas. Le texte de zone au bas de la page est le même bloc qu’imprime pepsi-setup run.
Le verdict vient de l’applicateur, non de ce serveur : établir ce qui devrait être publié suppose de lire la configuration validée et l’état du démon de signature DKIM, et le comparer suppose d’interroger le DNS. La page montre donc toujours quand la réponse a été calculée, et « vérifier le DNS maintenant » (setup:write) en demande une fraîche plutôt que de bloquer la requête sur un résolveur.
25.5.4. Clés DKIM¶
/ui/dkim (keys:read, lien depuis la page des domaines ; refusé à un principal confiné à une adresse) montre ce que le démon de signature pepsi-dkim(1) rapporte dans son fichier d’état public, le même document que celui par lequel répond GET /api/v1/keys/dkim : si la rotation est activée, et, par domaine de signature, chaque clé avec son sélecteur, son algorithme, sa taille RSA, son état (next, current, retiring, retired), son enregistrement TXT et si chaque serveur faisant autorité le sert, les changements DNS dus (enregistrements à ajouter, enregistrements qui peuvent partir) et une rotation en attente du DNS. Un domaine sans clé courante est signalé. La page l’indique lorsque le démon n’a pas encore écrit son état.
Ce serveur ne détient ni ne lit jamais une clé DKIM. Les boutons Changer de clé maintenant (en douceur : basculer une fois visibles les enregistrements de la clé suivante ; sans attendre : basculer immédiatement) ne font que demander : chacun met en file une tâche dkim-rotate que pepsi-setup apply exécute en lançant pepsi-dkim rotate en root, puisque le démon n’accepte de requêtes d’administration que de root et de son propre compte. Ils exigent setup:write et un applicateur en marche, et ne sont affichés que là où les deux sont présents.
25.5.5. Certificats gérés¶
Les pages Certificats montrent et modifient la PKI gérée : les domaines dont les utilisateurs reçoivent des certificats S/MIME d’une AC (Certificats d’une AC commerciale : la PKI gérée). La lecture exige keys:read. Chaque modification exige keys:write : les réglages, l’ajout d’un domaine, l’ajout d’un utilisateur, la correction ou l’approbation d’un nom, la sélection d’un utilisateur, son exclusion ou sa suppression, et le marquage des avis comme lus. Ces réglages décident de ce que l’AC facture à l’organisation et du nom que porte un certificat ; c’est pourquoi ils exigent la portée qui modifie les clés. Un principal confiné à une adresse (own:) ne voit rien de tout cela : aucun lien, aucune cloche, et chaque page et chaque formulaire sont refusés, puisque les réglages et la liste des utilisateurs appartiennent au déploiement, non à une adresse.
/ui/mpki liste les domaines gérés et porte le formulaire qui en ajoute un. Un nouveau domaine démarre désactivé, avec les valeurs par défaut, et le navigateur passe ensuite à sa page. /ui/mpki/domains/<domain> a trois parties :
Réglages : l’interrupteur, qui reçoit un certificat (le mode d’enrôlement), ce qu’il advient des noms tirés de l’en-tête
From:, un ou deux certificats par utilisateur, l’algorithme de clé, la durée de validité, la fenêtre de renouvellement, la limite quotidienne, l’adresse de notification, ainsi que le produit, l’identifiant d’organisation et l’URL d’API de l’AC. Les enregistrer revient à la même modification quepepsi-keys mpki domain set.Utilisateurs : une ligne par utilisateur avec le nom, sa provenance, s’il est confirmé, la sélection, si l’utilisateur reçoit un certificat, la commande la plus récente, ce qu’elle attend et sa dernière erreur. Pour chaque utilisateur, Approuver le nom confirme le nom tel qu’il est, Enregistrer le nom le corrige (ce qui le confirme aussi), Toujours inscrire et Laisser décider le domaine règlent la sélection, et Exclure et Supprimer l’utilisateur révoquent les certificats de l’utilisateur à la prochaine exécution de la tâche de commande. Ces deux actions passent d’abord par une page de confirmation, puisqu’un certificat révoqué ne peut pas être rétabli. Ajouter un utilisateur crée un utilisateur sous le nom que tape l’administrateur, ce qui le confirme.
Commandes : les vingt commandes les plus récentes du domaine, avec un lien vers
/ui/mpki/orders, qui les liste toutes et filtre par adresse ou sur les commandes en cours.
/ui/mpki/notices liste les avis qu’écrit la tâche de commande (une commande soumise, installée, retenue avec son motif, échouée ou révoquée), avec Marquer comme lu pour chaque avis et Tout marquer comme lu. Un avis marqué comme lu l’est pour chaque administrateur, et la console enregistre qui l’a marqué. Pour un principal qui a keys:read, l’en-tête des pages porte une cloche, Avis, avec le nombre d’avis non lus ; elle coûte un comptage par affichage de page, et un échec du comptage ne coûte que la cloche, jamais la page.
La console ne parle jamais à l’AC, et ne voit ni ne règle jamais l’identifiant d’AC, un fichier que seul pepsi-keys mpki credential set écrit et que pepsi-httpd ne peut pas lire. Elle ne peut pas non plus agir sur une commande : libérer, réessayer et annuler des commandes sont des sous-commandes de pepsi-keys mpki order, parce que pepsi-httpd n’a aucun droit d’écriture sur mpki_order. Les formulaires appellent les mêmes fonctions que /api/v1/mpki (L’API d’administration) : la console accepte et refuse donc ce que fait l’API, et les deux enregistrent les types d’audit qu’enregistre la ligne de commande (mpki.domain.set, mpki.user.add, mpki.user.set, mpki.user.delete ; une exclusion ou une suppression au niveau warning), plus mpki.notice.read.
25.5.6. Quarantaine¶
/ui/quarantine liste les messages que retient une étape pepsi-stage-quarantine(1), comme le fait pepsi-queue quarantine list : le jeton, l’étape, quand le message est arrivé et depuis quand il est retenu, son enveloppe, ainsi que les champs by et reason de son enregistrement de quarantaine (milter:<name> pour un filtre). La page d’un message y ajoute le From: et le Subject: que l’ingress a stockés avec l’enveloppe, ainsi que la fin de la rétention (MAX_HOLD). Comme les pages de la file, celles-ci ne montrent jamais les en-têtes ni le corps d’un message : pepsi-httpd ne peut pas les lire. Consultez le contenu sur le serveur avec pepsi-queue --headers --body.
Avec queue:write, la page propose Libérer et Supprimer sans remettre, chacun derrière une page de confirmation, puisqu’un message libéré est remis et qu’un message supprimé est perdu. La libération rend le message à son étape de quarantaine, qui le fait suivre vers son RELEASE_STAGE ; elle ne passe pas par workqueue_resume, qui refuse le courrier retenu. Une suppression est consignée dans le journal du courrier facultatif. Les deux appellent les fonctions de pepsi-queue quarantine et enregistrent ses natures d’événement d’audit (queue.quarantine-release, queue.quarantine-delete). Lorsqu’aucune étape n’exécute pepsi-stage-quarantine, la page indique que rien ne peut être retenu.
25.5.7. Greylisting¶
Là où pepsi-greylist(1) fonctionne, la navigation propose Liste grise (logs:read) pour un opérateur et Courrier différé pour un utilisateur connecté pour sa propre adresse. Le serveur décide une fois, au démarrage, si le déploiement pratique le greylisting : une section [pepsi-greylist], ou une section de milter d’ingress qui nomme la socket du démon.
/ui/greylist montre les décisions des dernières 24 heures par issue, telles que les compte pepsi-greylist stats (à partir des compteurs horaires du démon, si bien que la page ne parcourt pas les triplets), les triplets récents et les règles. Les triplets peuvent être filtrés par état (en attente d’une nouvelle tentative, accepté, tenté une seule fois), par domaine, par adresse ou réseau du client, et par destinataire. Avec config:write, chaque triplet a un formulaire de règle : choisissez son expéditeur, le domaine du client ou celui de l’expéditeur, ou le réseau ou l’adresse du client, puis Autoriser ou Refuser. Un autre formulaire ajoute une règle quelconque, avec une note et une durée, et chaque règle peut être retirée après confirmation. Les règles sont écrites par greylist_rule_add avec origin = console et l’identité de l’opérateur, et sont auditées sous greylist.rule.added et greylist.rule.removed, comme depuis la ligne de commande. Une règle de domaine correspond aussi au domaine de l’expéditeur d’enveloppe, que n’importe qui peut écrire ; la page le signale.
/ui/deferred est la page de l’utilisateur : les expéditeurs que le greylisting a priés d’attendre avant que leur courrier vers la propre adresse de l’utilisateur soit accepté, avec la première et la dernière tentative, le nombre de tentatives et l’indication qu’un réessai est passé ou non. Autoriser cet expéditeur, à côté d’un report ou pour une adresse saisie à l’avance, met l’expéditeur sur la propre liste blanche de l’utilisateur. C’est la liste blanche que consulte le WHITELIST_BYPASS du démon pour l’utilisateur, si bien que l’expéditeur n’est plus retardé pour cet utilisateur, et ce n’est pas une règle, qui laisserait passer l’expéditeur pour tout le monde. La ligne est celle qu’écrit pepsi-whitelist add pour une adresse, DKIM exigé, de sorte qu’elle ne compte que pour le courrier que le domaine de l’expéditeur authentifie. Lorsque le démon ne consulte aucune liste blanche propre à l’utilisateur ([pepsi-greylist] WHITELIST_NAME ou une étape de liste blanche dont le nom contient {localpart} ou {login}), la page indique qu’autoriser un expéditeur n’est pas disponible et ne propose aucun formulaire. Audité sous whitelist.sender.added.
Le serveur ne peut ni écrire les tables du greylisting ni lire aucune liste blanche : une règle ne change que par les deux fonctions de règle SECURITY DEFINER, et une ligne de liste blanche que par whitelist_add_user_sender, qui prend une seule adresse littérale et refuse une liste blanche partagée.
25.5.8. Pages pour l’utilisateur final¶
La portée own:<address> est définie et appliquée, et un principal ne détenant qu’elle atteint les pages d’identités et de correspondants restreintes à sa propre adresse. Les pages d’une autre adresse répondent 404, et les objets partagés (les modifications du cache de clés de correspondants, les ancres de confiance) sont refusés d’emblée. Il atteint aussi le journal du courrier, restreint à sa propre adresse ; y demander une autre adresse est refusé avec 403. Là où le greylisting fonctionne, il atteint le courrier que le greylisting a différé vers son adresse et peut mettre un expéditeur sur sa propre liste blanche (Greylisting). La navigation lui donne les liens vers ces pages. Sur ses propres identités, il peut aussi agir : demander une clé gérée par le serveur, enregistrer sa propre clé publique, demander un téléversement vers le serveur de clés, publier, retirer, rendre une clé principale, demander une révocation, et demander une demande de certificat ou l’installation d’un certificat émis sur son identité S/MIME, c’est-à-dire tout sauf supprimer une ligne (voir Gestion des clés). Chacune de ces actions est demandée à l’applicateur de configuration, qui vérifie le second facteur de l’adresse lorsqu’un second facteur est enrôlé (les formulaires prennent le code), et la réponse est la page de la tâche, qui indique quand le changement est fait.
25.5.8.1. Se connecter par courrier¶
Un utilisateur final obtient un tel principal en prouvant qu’il contrôle la boîte aux lettres. Lorsque [pepsi-admin] ENROL_STAGE est défini, la page de connexion propose « se connecter avec un lien envoyé à votre adresse électronique », qui mène à /ui/enrol :
L’utilisateur saisit une adresse. Lorsque ce serveur sert l’adresse, un lien à usage unique lui est envoyé, injecté à
ENROL_STAGEdepuis l’expéditeur nul. Le serveur sert une adresse lorsqu’il détient pour elle une identité non révoquée dans le magasin de clés, ou lorsque l’adresse est un compte local auquel livre une étape Maildir ou.forward. La page dit la même chose que cela ait eu lieu ou non (« si ce serveur gère cette adresse, un lien de connexion lui a été envoyé »), et la recherche s’exécute après l’envoi de la réponse, si bien que ni le texte ni le temps de réponse ne révèlent quelles adresses existent.Le lien (
ENROL_URL/ui/enrol/<token>) ouvre une page de confirmation ; l’ouvrir ne change rien, car les analyseurs de liens récupèrent les liens. La soumettre ouvre une session de navigateur détenant exactementown:<address>, avec les mêmes cookies, durées de vie et protections CSRF qu’une connexion par mot de passe, et mène aux propres identités de l’utilisateur. Lorsqu’un second facteur est enrôlé (voir Gestion des clés), la soumission exige le code TOTP courant de l’adresse. Lorsque l’adresse a une clé de sécurité (enregistrée sur la propre page Clés de sécurité de l’utilisateur, comme ci-dessus), la soumission mène à une page qui la demande à la place ; le code TOTP en tient encore lieu là où l’adresse en a un et oùREQUIRE_WEBAUTHNne nomme pasusers, et seulement lorsque l’applicateur signale qu’il a réellement vérifié un code. Supprimer la dernière clé d’un utilisateur final exige une assertion par celle-ci ; le recours de l’opérateur estDELETE /api/v1/webauthn/{address}.
Le lien fonctionne une fois, pendant ENROL_LIFETIME (30 minutes par défaut), accepte au plus cinq soumissions, et est remplacé par le prochain lien envoyé à la même adresse. Seul le SHA-256 de son jeton est stocké (pepsi.own_enrolment), comme seul le condensat du cookie de session l’est (pepsi.own_session) ; les deux tables appartiennent à pepsi-httpd seul. Les demandes sont limitées par adresse cible (ENROL_MAIL_PER_HOUR, par défaut 3 liens par heure) et par adresse client (ENROL_RATE_LIMIT, par défaut 20 par heure).
Le second facteur est vérifié par l’applicateur privilégié, non par ce serveur : otp_key et la clé qui enveloppe ses secrets sont hors de portée du niveau web. La confirmation met en file une tâche confirm-enrolment portant le code, sous la portée propre de l’adresse, et la session n’est ouverte que lorsque cette tâche se termine en done. L’applicateur laisse passer une adresse qui n’a pas de second facteur, si bien que le niveau web n’apprend même pas si un second facteur est enrôlé. L’enrôlement exige donc l’applicateur (le paquet pepsi-httpd-admin et [pepsi-admin] CONFIG_DB) ; sans lui, le formulaire d’adresse répond que la connexion par courrier n’est pas disponible ici et n’envoie rien.
Le mécanisme et ce contre quoi il ne protège pas sont décrits dans Connexion à la console par e-mail ; le récit du modèle de menaces sur une boîte aux lettres volée est Quelqu’un qui peut lire la boîte aux lettres d’un utilisateur.
La console doit être joignable par les utilisateurs pour que tout ceci serve : ENROL_URL nomme l’origine https:// d’un écouteur ADMIN = yes (ou du proxy inverse TLS placé devant), et le lien pointe toujours là. Il ne pointe jamais vers le Host que portait la requête, car un attaquant pourrait le choisir.
Ce qu’un utilisateur final peut y faire est ce que own:<address> permet : lire ses propres identités, clés de correspondants, journal du courrier et courrier différé par le greylisting, effectuer les opérations de clé ci-dessus, et autoriser un expéditeur que le greylisting a différé. Les pages sont par ailleurs en lecture seule : les utilisateurs modifient toujours leurs propres réglages par courrier, via pepsi-stage-edit-settings(1), et peuvent gérer leurs clés par courrier via l’adresse de contrôle pepsi-keys@ de l’étape de chiffrement.
25.6. Deux moteurs de modèles, deux usages¶
Pepsi rend deux sortes de texte assez différentes et emploie un moteur différent pour chacune. N’essayez donc pas de redéfinir une page de la console comme on redéfinit un rebond.
Les corps de courrier sont des modèles Mustache, livrés comme fichiers sous [pepsi] TEMPLATE_DIR (bounce-<name>.<lang>.body, payment-request.<lang>.body, edit-settings.<lang>.body, wallet.<lang>.body). Ils sont éditables par l’opérateur et par langue : on attend d’un opérateur qu’il réécrive la prose qu’un correspondant lira, et qu’il ajoute une langue, sans rien reconstruire. Le modèle sans logique est le bon choix ici : il n’y a rien à calculer, et l’on peut confier sans risque à un opérateur un modèle qui ne peut pas exécuter de code.
Les pages de la console sont des modèles askama, compilés dans le binaire et vérifiés en types au moment du build contre les structures Rust qu’ils rendent. Il n’y a rien à installer à l’exécution, rien à maintenir en phase avec le binaire, et un champ renommé est une erreur de build plutôt qu’une case vide en production. La console est surtout faite de tableaux et de conditions, ce que le modèle sans logique rend pénible.
La conséquence pratique : il n’y a aucun moyen de redéfinir une page de la console, et ce n’est pas prévu. Si une page dit quelque chose de faux, c’est un bogue à signaler, non un fichier à éditer.
25.7. Pas de script, pas de ressources distantes¶
La console ne livre aucun JavaScript, à une exception près. Chaque action est un formulaire ou un lien : elle fonctionne donc avec les scripts désactivés. Cela vaut aussi pour le rafraîchissement automatique facultatif de la file d’attente, qui est un <meta http-equiv="refresh"> que le lecteur active et désactive par un lien plutôt qu’un minuteur. Les graphiques sont de petits SVG en ligne écrits à la main et générés sur le serveur : ils se rendent donc dans la même requête que le reste de la page.
Rien n’est chargé depuis un autre hôte : une feuille de style, compilée dans le binaire et servie depuis /ui/static/console.css. La Content-Security-Policy interdit donc le script d’emblée plutôt que d’autoriser celui de la console, et interdit l’encadrement (frame-ancestors 'none', avec X-Frame-Options: DENY à côté).
L’exception est une cérémonie de clé de sécurité, qu’aucun formulaire ne peut mener : navigator.credentials est une interface de script. Trois pages en mènent une : la seconde étape d’une connexion, la confirmation de la connexion par courrier lorsqu’elle demande une clé, et Clés de sécurité. Elles chargent un unique script statique, webauthn.js, compilé dans le binaire comme la feuille de style. Leur politique autorise ce fichier par son SHA-256 (que la balise porte aussi en integrity) et son URL exacte sur CONSOLE_URL, et rien d’autre : pas de script en ligne, pas de 'self', pas d”eval. Le script lit les paramètres de la cérémonie dans les attributs data- du bouton, place la réponse du navigateur dans des champs cachés et soumet le formulaire ordinaire ; sans script, le bouton reste caché, si bien qu’un tel navigateur voit le champ TOTP là où il y en a un. Toutes les autres pages conservent la politique sans script-src. Nous procédons ainsi pour qu’un échappement oublié ne puisse toujours pas exécuter de script (voir Absence de durcissement HTTPS et des en-têtes de sécurité HTTP sur le webmail). Les pages sont envoyées avec Cache-Control: no-store, de sorte que les données d’administration ne restent pas dans un cache partagé ni dans le bouton retour après une déconnexion.
La falsification de requête inter-sites est refusée deux fois. Chaque formulaire porte le jeton CSRF de la session en champ caché, vérifié contre un condensat stocké avec la session ; et une requête modifiante dont l’en-tête Origin nomme un autre hôte est refusée avant même que son corps ne soit lu. Ce second contrôle couvre le formulaire de connexion, l’unique formulaire qui par définition n’a pas encore de session (voir XSS réfléchie et stockée ou injection HTML dans les portails et les courriers d’administration).
Les valeurs venues de l’extérieur (un objet, le nom d’affichage d’un expéditeur, une valeur d’en-tête, le texte de réponse d’un rebond, l’identifiant utilisateur d’une clé) sont échappées par défaut au rendu, et les tests l’exercent avec des entrées hostiles plutôt que de s’y fier. Le seul balisage que la console émet sans échappement est le SVG de ses propres graphiques, qui par construction ne contient que des nombres (voir XSS réfléchie et stockée ou injection HTML dans les portails et les courriers d’administration).
25.8. Accessibilité¶
La console est du HTML simple : un lien d’évitement vers le contenu principal, un <h1> par page, des tableaux avec <caption> et <th scope=…>, une étiquette pour chaque champ de formulaire, et aria-current="page" sur l’entrée de navigation où vous vous trouvez. Chaque action est un véritable <button> à l’intérieur d’un formulaire : elle est donc atteignable et actionnable au clavier sans raccourci à apprendre, et l’anneau de focus est dessiné explicitement parce que celui par défaut disparaît sur certains fonds. Le clair et le sombre viennent tous deux de prefers-color-scheme ; il n’y a pas de sélecteur de thème, car un sélecteur exige du script ou un cookie et le système d’exploitation connaît déjà la réponse.
Les graphiques portent aria-hidden et ne sont jamais l’unique présentation de quoi que ce soit : les mêmes nombres figurent dans le tableau à côté de chaque figure.
La navigation n’offre que ce que vos identifiants permettent, car un lien qui répond 403 est pire que pas de lien du tout.
25.9. Les pages publiques des listes de diffusion¶
Une seconde surface de navigation, distincte, conditionnée à LISTS = yes (voir Trois drapeaux d’écouteur, et pour deux d’entre eux le conseil est inverse) et documentée ici parce qu’un exploitant rencontre les deux :
/listsL’index des listes annoncées, groupées par domaine. Une liste dont l’attribut
advertisedest faux est absente de l’index et reste joignable par URL. C’est le sens qu’amont donne à cet attribut, et ce n’est pas une frontière de sécurité. « Non annoncée » se lit comme « cachée » ; elle ne l’est pas./lists/<list-id>La description d’une liste, son texte
info, son adresse d’envoi, les formulaires d’abonnement et de désabonnement, un lien vers les archives quand la politique en autorise un, et la liste des membres seulement simember_roster_visibilityvautpublic./lists/<list-id>/confirm/<token>Ce vers quoi pointe un lien de confirmation. Un ``GET`` n’achève rien : il affiche à quoi sert le jeton et demande un unique
POST. Les clients de messagerie, les générateurs d’aperçus de liens et les analyseurs de sécurité récupèrent les liens, plusieurs d’entre eux avant la personne. C’est une différence délibérée avec l’adresse-confirm+<token>, où l”arrivée est la confirmation parce que le jeton a voyagé dans l’enveloppe et que seul son propriétaire a pu l’y mettre./archives/list/<list@domain>/…Les archives : vue d’ensemble, mois, fil, message, pièce jointe, recherche. Les formes d’URL sont celles de HyperKitty, si bien que chaque en-tête
Archived-At:qu’un déploiement migré a émis continue de fonctionner. Voir Archives.
Trois choses au sujet de ces pages méritent d’être connues avant de les déployer.
Elles ne livrent aucun JavaScript, sauf sur les deux pages de membre qui mènent une cérémonie de clé de sécurité (ci-dessous). La Content-Security-Policy n’a donc pas de script-src (pas même 'self') et dit default-src 'none'. Le prix en est les parties interactives de HyperKitty : le repli des fils se fait par <details>, il n’y a pas de recherche en direct ni de réponse dans la page. Cela a été décidé délibérément, et une politique qui autorise ce qui n’est pas utilisé est une politique qui autorisera un jour ce qui est injecté (voir Absence de durcissement HTTPS et des en-têtes de sécurité HTTP sur le webmail).
Les corps de messages sont du texte échappé, jamais du balisage. L’attribut archive_rendering_mode d’amont propose text ou markdown. Pepsi stocke et expose l’attribut, parce que l’ensemble des attributs est le contrat de compatibilité, et rend text dans les deux cas. Rendre du markdown fourni par un utilisateur dans notre propre origine est précisément ce que la politique ci-dessus doit rendre impossible, et un moteur markdown est une surface d’injection HTML avec des étapes en plus. Rendre du texte ne laisse aucun assainisseur à mal faire, ce qui évite le balisage et les formulaires injectés (voir Des nettoyeurs HTML écrits à la main ou à passe unique laissent survivre du contenu actif et Des nettoyeurs HTML écrits à la main ou à passe unique laissent survivre du contenu actif).
Les adresses sont obscurcies pour les visiteurs anonymes. Une page d’archives affiche alice@... plutôt que l’adresse entière, pour l’expéditeur et pour chaque adresse d’un corps de message ou d’un extrait de recherche, à l’exception des adresses de publication et de rôle de la liste elle-même (list@domain, list-request@domain et les autres), publiées à dessein ; les pièces jointes sont servies telles que stockées. Un membre connecté les voit entières. Les archives conservent les vraies adresses, parce qu’obscurcir à l’entrée serait irréversible et que le traitement des rebonds a besoin de l’adresse réelle. L’obscurcissement est donc une décision de rendu. Ce n’est pas un contrôle de sécurité et ce n’est pas censé l’être : qui est sur la liste a l’adresse dans sa propre copie du message. Ce que cela empêche, c’est la collecte en masse qui fait d’archives publiques une source de spam.
25.9.1. Les formulaires qui font envoyer du courrier par le serveur¶
S’abonner, c’est demander au serveur d’envoyer un message à une adresse dont personne n’a prouvé la maîtrise. Sans limitation, quelqu’un pourrait s’en servir pour harceler un inconnu de courriers, et Pepsi ne livre aucun CAPTCHA, par la même décision qui exclut JavaScript. Donc :
chacun de ces formulaires est limité en débit sur l’adresse cible (deux courriers par adresse et par heure) autant que sur l’adresse du client ;
une seconde soumission alors qu’un jeton est encore valide réutilise ce jeton au lieu d’en émettre un autre, de sorte que dix soumissions ne font pas dix messages ;
la réponse est identique selon que l’adresse est déjà membre ou non : le formulaire n’est donc pas un oracle d’appartenance.
La dernière est la raison pour laquelle la page dit « si cette adresse peut être abonnée, une confirmation lui a été envoyée » et rien de plus utile. Ces règles limitent l’énumération d’adresses par les formulaires ; une différence de temps de réponse entre les deux chemins n’est pas exclue (voir Portails et API divulguant des données d’utilisateurs ou du matériel de clés sans authentification).
Avertissement
Le niveau web n’envoie aucun courrier de lui-même. Les formulaires, la List API et les pages de membre exécutent le même processus d’abonnement que les commandes par courrier -join et -leave et déposent le même jeton dans pepsi.list_pending, mais seule l’étape des commandes par courrier injecte la demande de confirmation ; le niveau web enregistre le jeton et répond comme s’il avait été envoyé. Tant que ce n’est pas branché (docs/ROADMAP.md), un visiteur qui s’abonne, s’inscrit ou réinitialise un mot de passe via le web attend un message qui ne vient pas. Un opérateur peut lire le jeton dans la table et transmettre le lien, ajouter le membre avec pepsi-list members add, ou réinitialiser un mot de passe avec pepsi-list owner reset-password.
25.10. Deux systèmes de comptes, et aucun n’accorde rien à l’autre¶
C’est la chose la plus facile à mal comprendre dans la couche web : elle est donc énoncée aussi platement que possible.
Pepsi a deux sortes de comptes de navigateur, dans deux tables, avec deux jeux de cookies, et ils n’ont aucun rapport :
La console de l’exploitant |
Le compte du membre de liste |
|
|---|---|---|
À qui il est destiné |
Celui qui fait tourner le serveur de courrier |
Quiconque s’abonne à une liste, ainsi que les propriétaires et modérateurs de ces listes |
Table des comptes |
|
|
Table des sessions |
|
|
Cookies |
|
|
Drapeau d’écouteur |
|
|
Où il devrait être joignable |
La boucle locale, par un tunnel SSH |
L’internet public |
Créé par |
Un opérateur, via |
L’inscription via |
Ce qu’il peut faire |
La configuration, la file d’attente, les clés et les journaux. Pas les listes : celles-ci se gèrent avec pepsi-list(1) ou par l’API REST Mailman |
Ses propres abonnements, plus les listes dont son adresse est propriétaire ou modératrice |
Aucun n’est une version affaiblie de l’autre. Un compte d’exploitant n’est membre de rien, et un compte de membre, même celui d’un propriétaire de liste, ne peut lire ni la file, ni la configuration, ni les clés de qui que ce soit. Les deux sont séparés parce que leur conseil de déploiement est inverse : la console est ce que le manuel dit de garder hors de l’internet, et on ne peut évidemment pas demander à un propriétaire de liste d’ouvrir un tunnel SSH pour approuver un message retenu.
25.10.2. Si vous servez les deux surfaces depuis un seul nom d’hôte¶
L’assistant en avertit et ne peut pas l’empêcher. Les cookies sont liés à l’hôte et non à l’écouteur : un déploiement qui place ADMIN = yes et LISTS = yes derrière un même nom n’a exactement que deux choses pour séparer les surfaces, les noms de cookies et le contrôle, par le garde, de la table d’où vient une session.
C’est une ligne mince, et elle est mince par conception et non par accident. Elle est testée dans les deux sens : une session de membre présentée à une route d’exploitant est refusée exactement comme le serait l’absence de cookie, et une session d’exploitant présentée à une route de membre de même, sans que l’une ou l’autre produise une erreur distinguable. Préférez néanmoins deux noms, ou mieux deux écouteurs : ADMIN sur la boucle locale et LISTS en public est l’agencement que le reste de ce chapitre suppose.
25.11. Les pages du membre¶
/lists/registerCrée un compte et produit un jeton de vérification, en une seule instruction de base de données qui est la même que l’adresse soit connue ou non (comme le formulaire de réinitialisation ci-dessous), de sorte que ni la réponse ni le travail qui la sous-tend ne disent quelles adresses ont des comptes. Non oraculaire et limité en débit, comme le formulaire d’abonnement ci-dessus et pour la même raison. Avec
[pepsi-list] WEB_REGISTRATION = no, la page et son gestionnaire n’existent pas (404) et la page de connexion ne les propose pas ; la connexion, les réinitialisations de mot de passe et les liens de vérification des comptes existants continuent de fonctionner, et les comptes viennent depepsi-list, d’un import ou d’un propriétaire de liste. Le jeton n’est pas envoyé par courrier (voir l’avertissement ci-dessus) : il reste danspepsi.list_pending(payload->>'account' = 'verify') jusqu’à ce que l’opérateur transmette le lien ou qu’il expire./lists/verify/<token>Confirme l’adresse et définit le mot de passe, en une seule étape. Il n’y a pas de page « choisir un mot de passe » séparée, car un lien de vérification qui ne fait que vérifier laisse un compte où personne ne peut se connecter. Le mot de passe doit compter au moins dix caractères, ne pas figurer sur la liste livrée des mots de passe courants et ne pas contenir l’adresse ; un mot de passe refusé consomme le lien, et la page indique d’en demander un nouveau.
/lists/sign-in,/lists/sign-outSe connecter avec n’importe quelle adresse vérifiée du compte et l’unique mot de passe du compte. Un membre peut détenir plusieurs adresses (le modèle d’amont est un utilisateur à plusieurs adresses), et c’est ce qui fait fonctionner « je me suis abonné avec mon adresse professionnelle ». Une adresse non vérifiée ne peut pas se connecter : elle n’a rien prouvé.
/lists/resetProduit un lien de réinitialisation (
payload->>'account' = 'reset'), lui non plus pas envoyé par courrier. Un lien, jamais un mot de passe : un mot de passe envoyé est un mot de passe qui reste pour toujours dans une boîte.pepsi-list owner reset-passwordest la voie de l’opérateur, et par défaut il l”affiche au lieu de l’envoyer, précisément pour cette raison. Il n’y a pas de récupération fondée sur des connaissances, comme des questions de sécurité (voir Mots de passe faibles et questions de récupération de compte devinables)./lists/meSes adresses, et ses abonnements sur toutes les listes, chacun avec son mode et son état de remise.
/lists/me/securityLes clés de sécurité (WebAuthn) du membre, un second facteur que les pages d’hameçonnage ne peuvent pas utiliser. En enregistrer une exige le mot de passe ; dès lors, la connexion exige le mot de passe et l’une des clés, fournie sur une seconde page (
/lists/sign-in/second-factor). Ajouter une clé supplémentaire, et en supprimer une, exigent le mot de passe et une assertion par l’une des clés existantes ; un ajout enregistre ensuite la nouvelle clé sur la page qui suit. Un compte de membre n’a pas de TOTP, si bien qu’un membre qui perd toutes ses clés est rétabli par l’opérateur (DELETE /api/v1/webauthn/members/{address}) ; une réinitialisation de mot de passe ne supprime pas de clé, sans quoi la boîte aux lettres seule permettrait de la contourner. Les clés sont liées à[pepsi-list] BASE_URL, qui doit être une URLhttps://pour qu’il en soit proposé ; lorsque[pepsi-httpd] REQUIRE_WEBAUTHNnommemembers, chaque membre en enregistre une à la connexion suivante. Les deux pages qui mènent la cérémonie chargent l’unique script statique, comme celles de la console ; toutes les autres pages ici restent sans script.
25.11.1. Pourquoi une préférence peut ne pas s’appliquer là où on l’attend¶
Les six préférences de remise sont cherchées le long d’une chaîne : cet abonnement, puis cette adresse, puis ce compte, puis le défaut de la liste. Tout niveau peut être non défini. Un membre qui pose une préférence sur son compte et constate qu’elle ne s’applique pas à une liste l’a donc généralement posée à un niveau qu’un niveau plus précis surcharge.
/lists/me montre donc, pour chaque abonnement, de quel niveau la valeur provient. Cette colonne est la réponse à la seule question que cette conception provoque à coup sûr.
25.12. La console du propriétaire et du modérateur¶
/lists/<list-id>/adminLa page d’où l’on part : les messages retenus, les demandes d’abonnement et (pour un propriétaire) des liens vers les écrans de réglages et la liste des membres.
/lists/<list-id>/admin/held/<request-id>Un message retenu, ses octets exacts affichés en texte. Accepter libère ces octets, non un nouveau rendu de ceux-ci : un message retenu est conservé sous sa forme réseau précisément pour qu’une libération puisse être remise pour de vrai, signatures et pièces jointes intactes.
C’est la page la plus hostile du site : le courrier d’un inconnu, rendu là où le clic d’un modérateur peut agir. Le corps est donc du texte échappé dans un
<pre>, la politique n’autorise aucun script, et chaque bouton porte un jeton CSRF. Nous procédons ainsi pour éviter le cross-site scripting stocké via le courrier (voir Des nettoyeurs HTML écrits à la main ou à passe unique laissent survivre du contenu actif)./lists/<list-id>/admin/settings/<screen>Les réglages de liste modifiables, sur onze écrans suivant le regroupement de Postorius lui-même, parce qu’un propriétaire qui migre cherchera un réglage là où il se trouvait. Le texte d’aide en regard de chaque champ est celui de Postorius, repris ; voir la note d’attribution dans Listes de diffusion.
Les écrans sont générés à partir de la même déclaration qui pilote l’API REST et la ligne de commande : une valeur refusée ici est refusée là-bas, dans les mêmes termes, et un réglage ne peut pas être présent à un endroit et absent à un autre. Un douzième écran,
pepsi, contient les réglages que Pepsi a inventés (donthold_dmarc_failures; Les réglages que Pepsi a inventés), validés commepepsi-list list set-extles valide ; une valeur vide ramène un réglage à sa valeur par défaut.Les six attributs de modèle
*_urifigurent aussi sur ces écrans, de sorte qu’un propriétaire qui veut son propre message d’accueil ou son propre pied de page pose l’URI là où résident tous les autres réglages, et non sur une page à part./lists/<list-id>/admin/rosterLes membres, les propriétaires et les modérateurs ; les interdictions de la liste ; et ses règles d’en-tête, avec les interdictions et les règles du serveur affichées à côté en lecture seule. Celles du serveur priment, et un propriétaire qui cherche pourquoi une règle ne se déclenche jamais doit voir celle qui s’est déclenchée d’abord.
Ajouter une adresse est la seule action de ce palier qui abonne quelqu’un sans son accord. C’est une action de propriétaire, elle est écrite au journal d’audit avec le propriétaire comme acteur, et l’adresse ajoutée n’est pas marquée vérifiée : la parole d’un propriétaire n’est pas la preuve qu’une boîte existe.
Tout ce qui se passe dans cette console est audité par le même journal que chaque action d’exploitant, avec le compte du membre comme acteur. detail ne porte jamais de contenu de message : accepter un message retenu consigne la demande et le condensé du message, non le corps. Le journal est élagué par la minuterie [pepsi-admin] EVENT_RETENTION_DAYS de l’exploitant ; comparez-la à la durée pendant laquelle vous voulez garder l’historique de modération.
25.13. Les langues des interfaces¶
Chaque page que sert pepsi-httpd choisit sa langue d’après l’en-tête Accept-Language de la requête, selon une seule règle : une étiquette régionale reçoit sa langue (de-CH obtient les pages allemandes, car une variante d’une langue en est plus proche que l’anglais), l’ordre des q de l’en-tête est respecté plutôt que son ordre d’écriture, un q=0 est lu comme un refus (de, en;q=0 signifie donc allemand et non « allemand, puis n’importe quoi »), et un en-tête qui ne nomme rien de ce dont dispose le serveur se rabat sur l’anglais.
Ce qui diffère, c’est le nombre de langues de chaque surface. La console d’administration et le portail du lien sécurisé sont servis dans les dix langues dans lesquelles sont livrés les modèles de notification : anglais, allemand, espagnol, français, hongrois, italien, russe, suédois, turc et ukrainien. Les libellés de la console forment un catalogue par langue (pepsi-httpd/src/ui/strings/), ceux du portail de même (pepsi-secure-link/src/strings/), et un test refuse un catalogue dans lequel une phrase a été laissée en anglais. Les trois courriers du portail (la notification, le PIN et l’accusé de lecture) sont des modèles dans les mêmes dix langues, avec leurs lignes d’objet traduites en même temps ; voir Le portail de repli par lien sécurisé.
Les pages publiques des listes de diffusion sont servies en anglais, allemand ou français, les trois langues dans lesquelles existe le manuel, et cette lacune est énoncée plutôt que cachée. Les modèles de notification (le message d’accueil, la demande de confirmation, les avertissements de rebond) existent en dix langues, parce qu’ils viennent de GNU Mailman, qui les a en trente-quatre (voir Listes de diffusion). Un membre qui lit un message d’accueil en allemand et suit son lien arrive sur une page allemande ; un membre suédois arrive sur une page anglaise. Ajouter une langue aux pages publiques revient à traduire environ 170 libellés courts : c’est un après-midi et un correctif, pas un projet.
Le choix se fait d’après l’en-tête seul, avant tout accès à la base. C’est délibéré : une page publique est joignable par n’importe qui, et choisir un mot en lisant un enregistrement signifierait qu’une requête non authentifiée touche la base, sur un serveur dont le pool de workers est d’une connexion. La préférence enregistrée d’un membre connecté ne surcharge donc pas l’en-tête.