95.1.28. pepsi-stage-reencrypt

seal decrypted inbound mail to the recipient’s own key before filing it

Section du manuel:

1

95.1.28.1.1. Nom

pepsi-stage-reencrypt - l’étape de rechiffrement pour le stockage du pipeline Pepsi.

95.1.28.1.2. Synopsis

pepsi-stage-reencrypt [GLOBAL-OPTIONS] worker

95.1.28.1.3. Description

pepsi-stage-reencrypt est un programme d’étape exécuté par pepsi-dispatch(1) comme un worker persistant lisant les identifiants de message sur l’entrée standard. Il charge la ligne pepsi.workqueue du message (refusant d’agir sauf si son status est running) et lit sa section [stage-<stage>].

pepsi-stage-decrypt(1) ouvre le courrier chiffré pour la clé de passerelle (MTA) d’un utilisateur, afin que les étapes de langue, de spam, de whitelist et d’apprentissage de clés puissent le lire. Le texte clair est alors ce qui serait classé dans la boîte aux lettres. Cette étape s’exécute après tous ces lecteurs et remet le message sous chiffrement, cette fois pour la clé que l’utilisateur a enregistrée pour son propre client de messagerie. Cette clé est la clé MUA : une ligne custody = client dans pepsi.crypto_identity. L’utilisateur l’enregistre avec pepsi-keys(1) identity import ou avec les commandes de clés par e-mail, ou bien Pepsi l’apprend de l’en-tête Autocrypt: des messages que l’utilisateur soumet lui-même. Ce qui est classé est alors un texte chiffré que seul ce client peut ouvrir.

Elle n’agit que sur un message que l’étape de déchiffrement a ouvert : state.crypto.in doit indiquer qu’il est arrivé chiffré et qu’il a été déchiffré. Le courrier arrivé en clair n’est jamais touché, car le sceller revendiquerait une confidentialité qu’il n’a jamais eue sur le réseau. Le courrier que l’étape de déchiffrement a laissé fermé parce qu’il était déjà chiffré pour la clé MUA (for_client) n’a besoin de rien non plus. Seuls les destinataires que cet hôte sert sont pris en compte ; un destinataire vers lequel un alias a été développé chez un autre fournisseur est laissé tel quel.

Pour chaque destinataire local, la copie scellée est chiffrée pour chaque clé MUA active capable de recevoir du chiffrement. Un utilisateur qui détient deux clés, par exemple un jeton matériel et sa sauvegarde ou une clé par appareil, peut donc ouvrir la boîte aux lettres avec celle qu’il a sous la main. Un message porte un seul protocole : lorsque les clés mêlent OpenPGP et S/MIME, le protocole de la clé la plus récente l’emporte et les autres sont consignées comme ignorées. Au plus huit clés sont utilisées, les plus récentes d’abord. Si l’on ne peut pas sceller pour une clé, par exemple parce que son certificat a expiré, qu’elle est inférieure à [pepsi] CRYPTO_MIN_RSA_BITS ou qu’elle figure sur la liste des clés connues comme compromises, seule cette clé est écartée, avec un avertissement, et la copie est scellée pour les autres ; ce n’est que lorsqu’aucune clé n’est utilisable que ON_NO_CLIENT_KEY s’applique. Pour S/MIME, le plus faible des enregistrements de capacités des clés décide du conteneur, afin que chaque appareil de l’utilisateur puisse le lire. Un message à plusieurs destinataires est d’abord scindé en une ligne par destinataire si l’un d’eux doit être scellé ou refusé, puisque chaque copie est scellée pour les clés d’une seule personne ; state.dsn.rcpt est découpé de concert.

Le courrier adressé à un alias fonctionne de la même manière, parce que l’étape s’exécute après pepsi-stage-aliases(1) : un message chiffré pour la clé de passerelle d’une adresse de rôle est ouvert avec cette clé, développé vers les membres de l’alias, et la copie de chaque membre est scellée pour les propres clés de ce membre.

95.1.28.1.4. Où la placer

Immédiatement avant la remise locale (pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1)), et donc :

  • après pepsi-stage-decrypt(1) : placée avant lui, l’étape ne trouve rien d’ouvert et ne fait que laisser passer le courrier ;

  • après chaque étape qui lit le contenu : détection et blocage de langue, les filtres de whitelist et de pay-to-send, pepsi-stage-autocrypt-learn(1) (qui lit le gossip dans le texte clair), pepsi-stage-vacation(1) ;

  • après pepsi-stage-aliases(1) et pepsi-stage-dot-forward(1) : une copie redirigée ailleurs ne doit pas partir scellée pour la clé d’un utilisateur local, car son nouveau destinataire ne peut pas l’ouvrir.

pepsi-setup(1) avertit lorsqu’aucune étape de déchiffrement n’y mène, et lorsqu’elle mène à l’une des étapes ci-dessus. Notez que le script Sieve d’un serveur LMTP voit le message scellé : les règles qui testent le corps, ou avec PROTECT_HEADERS l’objet, ne correspondent plus.

95.1.28.1.5. Ce qu’elle écrit

Le découpage de l’enveloppe est celui qu’utilise pepsi-stage-encrypt(1). Les champs Content-* et Autocrypt-Gossip: (Autocrypt Level 1 §5.3) vont à l’intérieur du texte chiffré, et tout le reste demeure dans le bloc extérieur. Cela comprend Received:, From:/To:/Date:/Message-ID:, l’en-tête Autocrypt: propre à l’expéditeur (qu’un client doit lire avant de pouvoir déchiffrer quoi que ce soit), les champs DKIM/ARC, et X-Pepsi-Crypto, le verdict de la passerelle sur la manière dont le message est arrivé. Avec PROTECT_HEADERS, les champs RFC 5322 sont aussi copiés à l’intérieur et le Subject extérieur devient ....

Aucune signature n’est ajoutée. L’étape de déchiffrement a déjà jugé la signature de l’expéditeur et enregistré son verdict dans state.crypto.in et dans X-Pepsi-Crypto. Une signature de la passerelle dirait seulement « la passerelle a scellé ceci », et un client de messagerie ne peut pas la distinguer d’une signature de l’auteur. Une signature de l’expéditeur qui a survécu au déchiffrement sous forme de couche MIME (S/MIME, ou multipart/signed PGP/MIME à l’intérieur du texte chiffré) fait partie du texte clair : elle est donc scellée avec lui et se vérifie toujours dans le client. Une signature OpenPGP empaquetée dans le même flux que le chiffrement est consommée par le déchiffrement et ne peut pas être reconstruite ; le client affiche alors un message non signé et l’en-tête de verdict de la passerelle.

Le conteneur suit [pepsi] CRYPTO_ALLOW_DOWNGRADE exactement comme pour le chiffrement sortant (voir pepsi.conf(5)). Pour une clé client S/MIME, l’enregistrement des capacités par pair s’applique en outre : un utilisateur local dont le client ne sait pas lire l”AuthEnvelopedData (Thunderbird) a besoin de pepsi-keys peer capability set ADDRESS cbc, sans quoi la copie stockée arrive vide. Sans enregistrement, la copie est scellée en AuthEnvelopedData AES-256-GCM.

95.1.28.1.6. Sans clé

ON_NO_CLIENT_KEY décide de ce qui arrive à un destinataire local qui n’a aucune clé MUA utilisable, soit parce qu’aucune n’est enregistrée, soit parce qu’on ne peut sceller pour aucune (un certificat expiré, un conteneur que la politique refuse, une clé inférieure à [pepsi] CRYPTO_MIN_RSA_BITS ou figurant sur la liste des clés connues comme compromises pepsi.compromised_key ; ce second cas est aussi journalisé comme avertissement) :

plaintext (par défaut)

Classer le texte clair, exactement comme sans cette étape.

bounce

Refuser le message : l’acheminer vers BOUNCE_STAGE avec le statut étendu 5.7.5 (RFC 3463, échec cryptographique). La DSN renvoyée ne porte ni le corps ni aucun en-tête que l’expéditeur aurait pu protéger, parce que l’expéditeur a chiffré le message et qu’une DSN voyage en clair : le bloc d’en-têtes est réduit à From, Sender, To, Cc, Date et Message-ID, le corps est vidé, et RET=HDRS est imposé quoi que l’expéditeur ait demandé. Sans BOUNCE_STAGE, la ligne passe à failed à la place (et pepsi-setup(1) refuse cette combinaison).

Un message arrivé dans un EnvelopedData S/MIME (AES-CBC ou 3DES, sans protection d’intégrité ; state.crypto.in.layers nomme le conteneur) est abandonné au lieu d’être rebondi, avec un avertissement dans le journal et la clé de télémétrie decrypt-dropped. Cette étape ne voit jamais qu’un message que l’étape de déchiffrement a ouvert, de sorte que son rebond indiquerait à l’expéditeur que le texte chiffré s’est ouvert : pour un texte chiffré CBC modifié, que son remplissage était valide. Un message abandonné ressemble pour son expéditeur à un message qui ne s’est pas ouvert.

Un refus génère un bounce plutôt que de différer, à dessein. Un report garderait le texte clair dans la file d’attente pendant toute la durée de vie du message, ce qui serait une exposition plus longue, et non plus courte ; de plus, rien ne réveillerait le message lorsqu’une clé serait enregistrée.

L’option est lue à travers la couche de surcharge par adresse, de sorte que la valeur par défaut du site dans la section peut être changée pour un destinataire avec pepsi-settings(1)

pepsi-settings set bob@example.org reencrypt ON_NO_CLIENT_KEY bounce

95.1.28.1.7. Configuration

Les options résident dans la propre section [stage-<name>] de l’étape (voir pepsi.conf(5)) :

NEXT_STAGE (obligatoire)

Remise locale.

BOUNCE_STAGE

Où va un refus ; requis lorsque ON_NO_CLIENT_KEY vaut bounce dans la section, et conseillé dès qu’une surcharge par adresse pourrait le dire.

ON_NO_CLIENT_KEY = plaintext | bounce

Voir Sans clé. Par défaut plaintext.

PROTECT_HEADERS = yes | no

Copie les champs RFC 5322 à l’intérieur du texte chiffré et remplace le Subject extérieur par .... La valeur par défaut est no, comme pour pepsi-stage-encrypt(1) : la copie est destinée à la boîte aux lettres, dont le serveur liste et recherche les messages d’après l’objet extérieur, et un client qui ne sait pas regarder à l’intérieur affiche chaque objet comme ....

ENABLED = yes | no

Lorsque l’option est désactivée, l’étape transmet chaque message inchangé. Par défaut yes.

LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER, REQUIRE_ACCOUNT

Quels destinataires cet hôte sert, avec la signification et les valeurs par défaut de pepsi-stage-decrypt(1) (LOCAL_DOMAINS se rabat sur [pepsi-ingress] ACCEPTED_DOMAINS).

L’étape est non privilégiée et intégrée au binaire multi-appel pepsi : sceller pour une clé publique ne nécessite aucun matériel privé, et l’étape ne lit que les colonnes publiques de pepsi.crypto_identity, que le rôle de pipeline ordinaire pepsi peut lire.

95.1.28.1.8. État

Entrées : state.crypto.in.encrypted, state.crypto.in.decrypted et state.crypto.in.for_client, écrits par pepsi-stage-decrypt(1).

Sorties : state.crypto.store, dont la présence empêche aussi l’étape de sceller une ligne deux fois :

outcome

reencrypted, plaintext ou bounced.

protocol, fingerprint, fingerprints, container, downgraded

Pour reencrypted : pour quelles clés MUA la copie a été scellée (fingerprints, les plus récentes d’abord ; fingerprint est la première d’entre elles) et le conteneur émis.

skipped

Pour reencrypted, lorsqu’il est présent : les autres clés actives du destinataire pour lesquelles la copie n’a pas été scellée, chacune avec son fingerprint et une reason. Celle-ci vaut protocol (pas le protocole de la clé la plus récente), limit (au-delà de la huitième), ou l’erreur que le scellement pour cette clé a renvoyée.

reason

Pour plaintext/bounced : no-client-key ou not-local lorsque le message a été classé tel quel, sinon une courte phrase (aucune clé utilisable propre au destinataire, ou l’erreur qui a fait échouer le scellement pour sa clé).

La disposition de l’état est décrite dans pepsi.state(7).

Transitions : avance vers NEXT_STAGE ; réachemine vers BOUNCE_STAGE (ou échoue en son absence) sous ON_NO_CLIENT_KEY = bounce ; rend une ligne à plusieurs destinataires à la file d’attente après l’avoir scindée.

95.1.28.1.9. Commandes

worker

Exécuté comme un worker persistant de pepsi-dispatch(1), lisant les identifiants de message sur l’entrée standard.

95.1.28.1.10. Options globales

-c FILE, –config FILE

Lit la configuration depuis FILE au lieu de parcourir les emplacements par défaut.

-L LOGLEVEL, –log LOGLEVEL

Règle la verbosité de journalisation (par défaut [pepsi] LOG, sinon info).

-v, –verbose

Affiche les messages de journal de toutes les sources.

-h, –help ; -V, –version

Affiche un résumé d’utilisation / la version et quitte.

95.1.28.1.11. Sécurité

Le mécanisme est décrit sous « Re-sealing decrypted mail for storage » dans le chapitre Sécurité du manuel de Pepsi, et ce que le manuel revendique pour lui sous « Client custody » dans son chapitre Modèle de menace (ainsi que dans la colonne Filed mail de sa matrice des garanties). La garantie porte sur les copies déjà classées : tant qu’un message est en file, chaque étape pepsi, celle-ci comprise, voit le texte en clair, et une étape compromise pourrait faire passer un message à côté de cette étape.

95.1.28.1.12. Code de sortie

0

Le worker s’est terminé proprement (entrée standard fermée).

1

Une erreur s’est produite (mauvaise configuration ou erreur de base de données). La raison est écrite dans le journal.

78

Le worker a refusé de démarrer : sa section ou la politique cryptographique de [pepsi] ne s’analyse pas. Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard. Une erreur de base de données pendant le traitement d’un message est réessayée comme toute autre défaillance de cet hôte (voir pepsi-dispatch(1)).

95.1.28.1.13. Exemples

Rechiffrer le message 42 (il doit être running)

echo 42 | pepsi-stage-reencrypt -c /etc/pepsi/pepsi.conf worker

La fin d’un pipeline entrant

[stage-dot-forward]
PROGRAM = pepsi-stage-dot-forward
NEXT_STAGE = reencrypt

[stage-reencrypt]
PROGRAM = pepsi-stage-reencrypt
NEXT_STAGE = local
BOUNCE_STAGE = bounce

Ne jamais classer de courrier lisible pour personne, et masquer aussi les objets

[stage-reencrypt]
PROGRAM = pepsi-stage-reencrypt
NEXT_STAGE = local
BOUNCE_STAGE = bounce
ON_NO_CLIENT_KEY = bounce
PROTECT_HEADERS = yes

95.1.28.1.14. Voir aussi

pepsi-stage-decrypt(1), pepsi-stage-encrypt(1), pepsi-keys(1), pepsi-settings(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)

95.1.28.1.15. Bogues

Signalez les bogues au gestionnaire de tickets de Pepsi.