14. Le portail de repli par lien sécurisé¶
Le chiffrement de bout en bout s’arrête au premier correspondant qui ne publie aucune clé, et la plupart n’en publient pas. Une politique ENCRYPT = required ne laisse alors à un opérateur que deux mauvaises réponses : faire rebondir le message, ou l’envoyer en clair quand même. Le portail de lien sécurisé est la troisième : retenir le message sur le serveur, chiffré, et laisser le destinataire le lire dans un navigateur après avoir saisi un PIN qui lui est parvenu par une autre voie.
C’est la troisième branche de la politique ON_NO_KEY de pepsi-stage-encrypt (et de ON_OVERSIZE, pour un message dépassant MAX_SIZE). Gestion des clés décrit les deux autres branches, ainsi que le magasin de clés qui décide quelle branche est prise. Sous ENCRYPT = required, les deux politiques valent par défaut secure-link dès que SECURE_LINK_STAGE nomme l’étape, si bien que l’exemple ci-dessous n’a besoin d’aucune ligne ON_NO_KEY. L’étape de chiffrement achemine aussi un destinataire ici lorsque la recherche de sa clé échoue de façon répétée dans le DNS alors que les serveurs de courrier du domaine répondent : c’est en effet ce que l’on observe quand quelqu’un supprime une clé (Une recherche de clé qui échoue dans le DNS).
14.1. Le déroulement¶
Un utilisateur local envoie un message confidentiel.
pepsi-stage-encryptne trouve aucune clé utilisable pour le destinataire et, parce queON_NO_KEYvautsecure-link, l’achemine verspepsi-stage-secure-linkau lieu de le relayer.Cette étape génère un PIN et dérive de la ligne de la file un jeton d’URL de 192 bits (voir pepsi-stage-secure-link(1)). Elle dérive une clé de contenu du PIN, d’un sel propre au message et du poivre du serveur ; le jeton n’entre pas dans cette dérivation, il sert de données associées à l’AEAD. L’étape stocke ensuite uniquement le texte chiffré et supprime la ligne de la file d’attente.
Le destinataire reçoit un courrier de notification avec un lien. L”expéditeur reçoit le PIN (la valeur par défaut
PIN_DELIVERY = sender) et le transmet par téléphone, par message texte ou de vive voix.Le destinataire ouvre le lien, saisit le PIN et lit le message. Les pièces jointes peuvent être téléchargées ; si
REPLY_STAGEest configuré, une réponse peut être écrite et renvoyée à l’expéditeur.Après
EXPIRY_DAYS(7 par défaut), le message cesse d’être lisible, etpepsi-secure-link prune(exécuté chaque jour parpepsi-secure-link-prune.timer) le supprime.
Le pipeline ressemble à ceci
[stage-encrypt]
PROGRAM = pepsi-stage-encrypt
ENCRYPT = required
SECURE_LINK_STAGE = secure-link
NEXT_STAGE = srs
[stage-secure-link]
PROGRAM = pepsi-stage-secure-link
[pepsi-secure-link]
BASE_URL = https://secure.example.org
NOTIFY_STAGE = srs
ORGANIZATION = Example Ltd
# PEPPER is written to secrets.d/pepsi-secure-link.secret by pepsi-setup.
NOTIFY_STAGE se trouve sur le chemin sortant, car les courriers de notification et de PIN sont des messages que le déploiement émet et doit signer et relayer normalement. Chacun est estampillé d’un en-tête Pepsi-Origin lié à son destinataire, de sorte que lorsqu’il atteint une boîte aux lettres du même déploiement, la barrière de paiement pour envoyer le laisse passer ; une réponse écrite dans le portail passe aussi la barrière (pepsi-stage-anti-spam).
14.2. Ce que cela protège, et ce que cela ne protège pas¶
Les affirmations ci-dessous forment, dans le modèle de menace, l’entrée consacrée au message stocké dans la liste des actifs (Actifs) et la section sur le voleur de base de données (Quelqu’un qui détient une copie de la base de données). Les mécanismes sont résumés sous « Le portail de lien sécurisé » dans Modèle de sécurité, et les bornes de ressources du portail dans Disponibilité.
14.2.1. Le message stocké¶
La clé de contenu est dérivée avec Argon2id (RFC 9106) à partir de trois entrées conservées en trois endroits différents. Pepsi utilise Argon2id plutôt qu’un simple hachage ou PBKDF2 parce que le secret étiré est un court PIN (par défaut dix caractères tirés d’un alphabet de 31 symboles qui écarte les caractères ressemblants). Ce qu’il faut rendre coûteux, c’est une recherche hors ligne parallèle, et seule une fonction gourmande en mémoire renchérit le matériel qu’un attaquant emploierait, au lieu de simplement allonger le temps.
Les trois entrées :
le PIN, qui parvient au destinataire hors bande et n’est stocké nulle part ;
un sel par message, qui est une colonne de base de données (un sel n’est pas un secret — c’est ce qui empêche un seul précalcul de couvrir tous les messages, voir Devinette hors ligne de hachages de mots de passe faibles, de phrases de passe de clés et de clés dérivées) ;
un poivre côté serveur, qui ne réside que dans
secrets.d/pepsi-secure-link.secret.
Seul le texte chiffré est stocké. L’algorithme est AES-256-GCM, un AEAD : le message stocké est donc authentifié autant que confidentiel, et un texte chiffré altéré refuse de s’ouvrir au lieu de se déchiffrer en un contenu choisi par un attaquant. Nous procédons ainsi pour éviter les messages stockés malléables (Protection d’intégrité OpenPGP (MDC) absente, amovible ou non appliquée). Par conséquent :
Une base volée n’est pas une boîte aux lettres. Un vidage, une réplique ou une bande de sauvegarde livre du texte chiffré et un sel, et ni le PIN ni le poivre n’y figurent.
Un serveur compromis après coup n’est pas non plus une boîte aux lettres. Pour les messages stockés avant l’arrivée de l’attaquant, celui-ci doit encore trouver le PIN même s’il s’empare aussi du poivre, et parcourir les PIN de 10 caractères sous Argon2id coûte trop cher. Un attaquant qui garde le contrôle du pipeline voit chaque nouveau message en clair au moment où il est soumis, comme tout autre courrier en file d’attente.
Il n’existe aucun vérificateur de mot de passe. Vérifier un PIN et déchiffrer avec lui sont la même opération, car l’étiquette AEAD sert de vérification. Rien de ce qui est stocké ne peut donc être cassé hors ligne pour retrouver un PIN (Devinette hors ligne de hachages de mots de passe faibles, de phrases de passe de clés et de clés dérivées, Devinette hors ligne de hachages de mots de passe faibles, de phrases de passe de clés et de clés dérivées).
L’administrateur ne peut pas lire un message stocké. La base ne suffit pas, le poivre ne suffit pas, et les deux ensemble ne suffisent pas non plus. Il n’existe pas de
pepsi-secure-link read, pas de--decryptet pas de clé de séquestre. C’est une propriété du message stocké : l’opérateur est digne de confiance pour le courrier en transit (Modèle de menace), et un opérateur qui modifie le serveur peut capturer un message avant qu’il ne soit scellé.
Le prix de cette dernière propriété : un PIN perdu est un message perdu. Pour récupérer, l’expéditeur renvoie le message, ce qui produit un nouveau PIN et un nouveau lien. Attendez-vous à ce qu’on vous demande une clé de séquestre ; en ajouter une redonnerait exactement la capacité que cette conception vise à supprimer.
Perdre le poivre a le même effet à plus grande échelle : chaque message stocké devient illisible d’un coup. Sauvegardez-le avec le reste de secrets.d, et n’oubliez pas que le remplacer invalide chaque lien encore en cours.
14.2.2. Ce qui n’est pas protégé : les métadonnées¶
Les éléments suivants sont délibérément stockés en clair, sous forme de colonnes de base de données ordinaires :
l”expéditeur et le destinataire, car la notification et le second facteur doivent être remis, et il faut pouvoir répondre à la question « est-ce arrivé ? » ;
les horodatages — créé, expire, première lecture ;
les compteurs de cycle de vie — nombre de lectures, tentatives de PIN échouées, verrouillages, réponses ;
le journal d’accès — quand chaque tentative a eu lieu, depuis quelle adresse, et comment elle s’est terminée.
L”objet n’est pas dans cette liste. C’est en général le champ le plus révélateur, et souvent il est le message (« Résultats de la biopsie », « Lettre de licenciement »). Ni l’acheminement ni l’expiration n’en ont besoin ; il est donc stocké dans le texte chiffré, avec le corps.
Une console d’opérateur liste donc qui et quand, jamais quoi, et l’accusé de lecture aussi. Le support en est d’autant plus difficile : « le message que vous avez envoyé à Bob à 09:14 a été lu à 11:02 » est tout ce que quiconque peut dire ici, et il n’y a aucun moyen de confirmer ce qu’il contenait.
Le journal d’accès consigne l’adresse du pair et rien d’autre — pas d’agent utilisateur, et pas de géolocalisation.
14.2.3. Le second facteur¶
Toute la construction repose sur le fait que le PIN voyage par un canal que la boîte aux lettres du destinataire ne contrôle pas. PIN_DELIVERY le choisit :
sender(par défaut)Le PIN est envoyé par courrier à l”expéditeur, qui le transmet. Cela ne demande aucun service externe, fonctionne partout et utilise un canal auquel les deux correspondants font déjà confiance. Cela suppose en revanche que l’expéditeur emploie réellement un second canal : renvoyer le PIN à la même adresse anéantirait le dispositif, et le courrier du PIN le dit.
commandUn programme configuré (une passerelle SMS, un crochet de messagerie d’entreprise) reçoit le PIN sur l’entrée standard et l’adresse du destinataire en argument. L’adresse vient après un
--, afin qu’une adresse commençant par-ne puisse pas se faire passer pour une option. C’est le choix le plus sûr lorsqu’un véritable second canal existe.noneCe choix est nettement plus faible, et vous devez le faire délibérément. Le lien lui-même porte le PIN, de sorte que quiconque peut lire la boîte aux lettres du destinataire peut lire le message — précisément ce que la fonctionnalité doit empêcher. Le PIN se retrouve en outre dans une URL, et donc potentiellement dans un historique de navigateur ou dans les journaux d’un intermédiaire. Ne l’utilisez que là où la boîte aux lettres est véritablement le facteur.
14.2.4. Force brute¶
Un PIN assez court pour être lu à voix haute est assez court pour être deviné : la devinette est donc bornée deux fois. Par jeton, MAX_ATTEMPTS PIN erronés (10 par défaut) le verrouillent pendant LOCKOUT (15 minutes), et la fenêtre double à chaque nouveau verrouillage, jusqu’à 64 fois la durée de base ; pendant un verrouillage, même le bon PIN est refusé. Le compteur d’échecs est remis à zéro au début d’un verrouillage, de sorte que la fenêtre suivante offre un budget neuf plutôt qu’un reverrouillage instantané. Par source, RATE_LIMIT plafonne les requêtes par minute sur toutes les routes du portail, ce qui empêche aussi la dérivation de clé délibérément coûteuse de devenir un moyen de dépenser la mémoire du serveur.
Pendant un verrouillage, aucune tentative n’est évaluée, si bien que deviner à travers lui n’apprend rien (Limites de débit de connexion et de récupération déjouées par des situations de concurrence et des erreurs de logique). Des tentatives soumises en parallèle ne peuvent pas non plus dépasser le budget (Limites de débit de connexion et de récupération déjouées par des situations de concurrence et des erreurs de logique) : chaque tentative est comptée comme un échec avant sa dérivation de clé. Une seule instruction de base de données s’en charge ; elle détient le verrou de ligne du jeton pendant qu’elle vérifie l’absence de verrouillage et compte la tentative. Quel que soit le nombre de tentatives concurrentes, au plus MAX_ATTEMPTS sont donc testées, et celle qui épuise le budget déclenche le verrouillage qui refuse les autres. Un PIN correct efface ensuite ce décompte (et tout verrouillage) lorsque le résultat est enregistré.
Seule une véritable tentative est comptée. Un formulaire dont le champ PIN est vide, ou ne contient rien que la normalisation conserve, est refusé sans toucher au compteur et sans exécuter la dérivation. Un tel formulaire n’apprend à un attaquant rien qu’il ne sache déjà. Le compter permettrait à tout client qui resoumet le formulaire vide (une double soumission, un préchargement, un suiveur de redirection qui conserve la méthode) d’exclure un destinataire légitime de son propre message.
Une session en cours n’est pas soumise au verrouillage, de sorte qu’un tiers devinant sur le même jeton ne peut pas exclure un lecteur légitime en pleine lecture.
14.2.5. Le navigateur¶
Rendre dans un navigateur du courrier contrôlé par un attaquant est le plus grand risque de cette fonctionnalité, et Pepsi y répond en ne le faisant pas :
Le message est rendu en texte, jamais en HTML. Un message uniquement HTML est replié en texte ; le balisage ne survit pas. Il n’y a donc aucun assainisseur HTML que l’on pourrait contourner, et aucun contenu distant : la politique dit
img-src 'none'(img-src data:lorsqu’unLOGO_FILEest incorporé) et s’y tient, de sorte qu’un pixel de suivi ne puisse pas signaler que le message a été ouvert. La mise en forme et les images en ligne sont perdues ; un destinataire qui a besoin de l’original peut télécharger les parties. Nous procédons ainsi pour éviter les contournements d’assainisseur et les formulaires injectés (Des nettoyeurs HTML écrits à la main ou à passe unique laissent survivre du contenu actif, Des nettoyeurs HTML écrits à la main ou à passe unique laissent survivre du contenu actif).Chaque valeur dynamique d’une page — objet, expéditeur, date, nom de fichier, nom de l’organisation — est échappée en HTML à l’endroit où elle est écrite dans la page (XSS réfléchie et stockée ou injection HTML dans les portails et les courriers d’administration).
Chaque réponse porte
Content-Security-Policy: default-src 'none'avec un nonce par réponse pour l’unique feuille de style en ligne et aucune source de script nommée du tout, plusReferrer-Policy: no-referrer,X-Content-Type-Options: nosniff,X-Frame-Options: DENYetCache-Control: no-store(Absence de durcissement HTTPS et des en-têtes de sécurité HTTP sur le webmail).Une pièce jointe est toujours servie en
application/octet-streamcommeattachmentavec une politique de bac à sable, quel que soit le type que le message prétendait, de sorte qu’elle ne peut pas s’exécuter comme script sur l’origine du portail (Pièces jointes servies depuis la même origine avec un type de contenu actif).Le nom de fichier d’une pièce jointe est affiché et proposé sans caractères de mise en forme bidirectionnelle (U+202A à U+202E, U+2066 à U+2069, U+200E, U+200F, U+061C), de sorte qu’un forçage de droite à gauche ne peut pas faire lire
invoice<RLO>fdp.execommeinvoiceexe.pdf. Un nom de plus de 120 caractères voit sa racine tronquée, son extension étant conservée, afin qu’un remplissage ne puisse pas repousser la vraie extension hors de vue. Les archives des listes de diffusion et les condensés traitent les noms de fichiers de la même façon.L’objet, l’expéditeur et chaque nom de fichier sont enveloppés dans un élément HTML
<bdi>. Les objets et les noms affichés conservent les caractères bidirectionnels, car le texte de droite à gauche en a besoin ; l’élément garantit qu’un forçage qu’ils contiennent ne réordonne que son propre texte et ne peut pas réarranger les libellés et valeurs qui l’entourent.
14.3. Répondre¶
Dans un portail en lecture seule, le destinataire peut lire confidentiellement mais doit répondre en clair, rendant l’essentiel de ce que la fonctionnalité avait gagné. Répondre est donc pris en charge. Une réponse injecte un message depuis le web public ; ses contraintes sont donc intégrées au code plutôt que laissées à la procédure :
La réponse ne va qu’à l’expéditeur d’origine, et son expéditeur d’enveloppe est forcé au destinataire stocké. Ni l’un ni l’autre n’est une entrée : il n’y a donc rien à détourner. Cela empêche le portail de devenir un relais ouvert, et c’est pourquoi aucun champ du courrier remis ne peut rediriger une réponse (Données de liaison du portail conservées dans des champs non authentifiés du texte chiffré).
Le message injecté ne porte pas
state.local_origin. Il entre àREPLY_STAGEpour ce qu’il est : du courrier entrant qui se trouve avoir pris naissance sur notre propre serveur web. Il ne peut donc pas emprunter le chemin de soumission : il n’est pas relayé comme notre propre courrier, il n’ajoute pas son expéditeur à la liste blanche, et SRS ne le traite pas comme du courrier d’origine locale.Elle n’est pas signée en DKIM comme l’un de vos domaines. L’auteur est une partie extérieure ;
pepsi-setupavertit siREPLY_STAGEse résout en une étape de signature. La réponse porte un en-têteX-Pepsi-Secure-Link-Reply: …; author-unverifiedafin que le destinataire puisse voir comment elle est arrivée.Le corps est en text/plain, quoi qu’on ait tapé. Composer du HTML impliquerait d’assainir aussi le HTML sortant, et pas seulement l’entrant.
Les pièces jointes sont autorisées, avec des plafonds pour la taille totale, le nombre de fichiers et les réponses par message. La limite de taille est appliquée pendant que le téléversement s’écoule, de sorte qu’un client qui déclare un mauvais
Content-Lengthne gagne rien. Les téléversements ne sont jamais écrits sur disque, mais vont directement dans le message injecté. Il n’y a donc pas de seconde durée de stockage, rien ne subsiste si l’injection échoue, et aucun nom de fichier choisi par un expéditeur ne devient jamais un chemin (Traversée de chemin lors de l’extraction ou du service de membres d’archives).Chaque réponse est consignée dans le journal d’accès du message.
Répondre est désactivé à moins que REPLY_STAGE ne soit défini.
14.4. Où placer le portail¶
Un nom d’hôte dédié est recommandé : un enregistrement DNS et un SAN certbot procurent une véritable séparation des origines. Ce n’est pourtant pas exigé, et une origine partagée est sûre par construction plutôt que par discipline :
le cookie de session est limité à
Path=/secure/, de sorte qu’il n’est jamais envoyé à/metrics,/resumeou au Web Key Directory, même sur un seul hôte ;sa valeur est un AEAD scellé sous le poivre du serveur, de sorte qu’un cookie planté par un sous-domaine frère ne s’ouvre pas. Sans ce scellement, le cookie aurait besoin d’un préfixe
__Host-, que la RFC 6265bis rend incompatible avec la limitation de chemin, puisque ce préfixe exigePath=/;il est
HttpOnly,Secure,SameSite=Strictet propre à l’hôte (pas deDomain), et aucun jeton de session ne transite jamais dans une URL (XSS réfléchie et stockée ou injection HTML dans les portails et les courriers d’administration) ;les en-têtes de sécurité sont posés par route, non par hôte, de sorte que la politique stricte du portail s’applique où qu’il soit monté.
Le portail doit être joignable en HTTPS depuis le navigateur : le cookie de session porte Secure. Un reverse proxy terminant le TLS en façade convient.
14.5. Stockage et dimensionnement¶
Le texte chiffré réside dans la base en BYTEA. Cela garde tout transactionnel — créer un message sécurisé est une insertion, l’élagage un DELETE, et la sauvegarde et la restauration couvrent le contenu automatiquement, sans fichiers orphelins et sans second emplacement dont il faudrait bien régler les permissions.
Le coût est une base plus grosse et davantage de trafic WAL, en proportion du trafic du portail. Un message est stocké une fois par destinataire sans clé (chacun avec son propre PIN et son propre texte chiffré, de sorte que le PIN d’un destinataire n’ouvre jamais la copie d’un autre), et [stage-encrypt] MAX_SIZE (25 Mo par défaut) borne chacun. Dimensionnez un déploiement en conséquence, et exécutez pepsi-secure-link prune chaque jour (le paquet Debian livre pepsi-secure-link-prune.timer à cet effet). Le portail refuse de toute façon un jeton expiré, mais rien ne supprime les octets tant que la tâche ne s’exécute pas.
14.6. L’exploiter¶
pepsi-secure-link list montre ce qui est encore en cours ; show y ajoute le journal d’accès d’un message ; revoke détruit un message et le retire ainsi, au lieu de remettre le courrier dans la file d’attente ; prune supprime ce qui a expiré. Voir pepsi-secure-link(1).
La frontière en base est plus étroite que dans le reste du schéma et est vérifiée à chaque pepsi-setup run : seul le rôle pepsi-httpd peut lire secure_message.ciphertext. Chaque worker d’étape s’exécute sous le rôle pepsi, y compris ceux qui analysent du courrier hostile ; ce rôle peut créer un message, lister les métadonnées et supprimer une ligne, mais ne peut pas relire un message. pepsi-ingress, pepsi-telemetry, pepsi-crypto, pepsi-keydisc, pepsi-whitelist et pepsi-config ne peuvent pas toucher aux tables du tout (La séparation des privilèges).
14.7. Habillage¶
ORGANIZATION, BRAND_COLOR et LOGO_FILE fixent l’apparence des pages ; ORGANIZATION est aussi nommé dans les courriers de notification. La couleur doit être une couleur hexadécimale et le logo une image matricielle locale, pour la même raison : ils sont interpolés dans une page, et une valeur qui pourrait être du texte arbitraire ou un SVG élargirait la surface d’attaque de la page. Les trois courriers de notification eux-mêmes sont des modèles Mustache (secure-link, secure-pin, secure-receipt) sous [pepsi] TEMPLATE_DIR et peuvent être réécrits entièrement.
14.8. Langues¶
Les courriers et les pages de secure-link atteignent des personnes qui n’ont jamais choisi Pepsi ; ils ne sont donc pas uniquement en anglais. Les trois courriers sont livrés dans les mêmes dix langues que les avis des listes de diffusion (anglais, allemand, espagnol, français, hongrois, italien, russe, suédois, turc et ukrainien), sous les noms secure-link.<lang>.body et ainsi de suite, et les pages du portail sont traduites dans les dix mêmes langues.
Les courriers sont rédigés dans la langue du message qu’ils annoncent. Lorsque pepsi-stage-detect-language s’est exécuté plus tôt dans le pipeline, il a stocké sur le message une chaîne de type Accept-Language. Cette chaîne choisit le modèle : dans l’ordre des q, avec le repli régional habituel (de-CH → de) et l’anglais en dernier. Un pipeline sans cette étape envoie de l’anglais. La ligne d’objet est traduite avec le corps, mais à partir d’un catalogue intégré au binaire plutôt que du fichier de modèle. Un opérateur qui ajoute une onzième langue dans TEMPLATE_DIR obtient donc ce corps sous un objet en anglais ; c’est la limite documentée lorsqu’on redéfinit les modèles par des fichiers. Un objet qui n’est pas en ASCII est encodé selon la RFC 2047 à l’envoi.
Les pages sont rédigées dans la langue que demande le navigateur. Le portail lit l”Accept-Language de la requête et rien d’autre, et il le fait avant de rechercher le jeton, afin qu’un visiteur ralenti ou refusé en soit lui aussi informé dans sa propre langue. Les règles sont celles que suit chaque page de pepsi-httpd (voir La console d’administration) : les langues sont essayées dans l’ordre des q, une étiquette régionale reçoit sa langue de base, q=0 refuse une langue, et l’anglais s’applique lorsque le navigateur ne nomme aucune des langues du serveur. C’est délibérément la préférence du navigateur du destinataire, et non la langue détectée du courrier, qui décide ici : le navigateur indique la préférence propre de son utilisateur à chaque requête, et un message rédigé dans une langue que lit le destinataire ne prouve pas la langue qu’il lit le mieux.
14.9. Voir aussi¶
Gestion des clés (le magasin et la couche de découverte qui décident si un destinataire a besoin de ce repli), pepsi-stage-encrypt (ON_NO_KEY = secure-link), pepsi-stage-secure-link, pepsi-secure-link (la CLI d’opérateur), pepsi-httpd (qui sert le portail), pepsi.conf(5).