37. pepsi-stage-encrypt¶
Signer le courrier sortant au nom de son auteur, et le chiffrer pour chaque destinataire.
37.1. Rôle¶
pepsi-stage-encrypt est la moitié sortante de la cryptographie de bout en bout de Pepsi. Pour chaque message soumis localement, elle résout quelle protection a été demandée et l’applique : elle signe avec la clé de l’auteur du From:, puis chiffre vers la clé du destinataire. Elle achemine ensuite chaque destinataire plus loin. Elle ne fait aucune E/S réseau : un destinataire dont la clé n’est pas en cache met le message en pause, et un service pepsi-keydisc le libère. Référence : pepsi-stage-encrypt(1).
Elle écrit les deux mêmes normes que pepsi-stage-decrypt lit : la RFC 9580 avec les conteneurs PGP/MIME de la RFC 3156 pour OpenPGP, et le CMS de la RFC 5652 avec le profil de la RFC 8551 pour S/MIME. Le côté écriture a cependant deux choix que le côté lecture n’a pas, et tous deux sont visibles dans la configuration :
Vers quel conteneur chiffrer. Pour OpenPGP c’est négociable : un certificat déclare quelles versions de SEIPD son propriétaire sait lire, de sorte que
CRYPTO_ALLOW_DOWNGRADE = negotiateémet du SEIPDv2 RFC 9580 (AEAD) vers un correspondant dont la clé dit qu’il sait le lire, et du SEIPDv1+MDC vers un correspondant dont la clé dit le contraire. Un certificat X.509 n’annonce aucune capacité de chiffrement de contenu ; pour S/MIME, l’étape lit donc l”enregistrement des capacités du destinataire (L’enregistrement de capacités S/MIME par pair). Cet enregistrement est appris desSMIMECapabilitiesdu courrier signé du correspondant, ou configuré avecpepsi-keys peer capability set. L’étape émet de l”AuthEnvelopedDataRFC 5083/5084 (AES-256-GCM) sauf si cet enregistrement dit que le destinataire ne sait pas le lire ; dans ce cas, elle émet de l”EnvelopedDataAES-256-CBC RFC 3565. Un destinataire sans enregistrement reçoit de l’AEAD, de sorte qu’un utilisateur de Thunderbird qui n’a jamais envoyé de message signé a besoin d’un enregistrement configuré. Interopérabilité des clients consigne quels clients sont connus pour lire quoi.Quelle recipient info construire, ce qui n’est pas un choix : cela découle du type de clé dans le certificat du destinataire. RSA reçoit un
KeyTransRecipientInfode la RFC 5652 §6.2.1 (RSAES-OAEP de la RFC 4055, ou PKCS#1 v1.5 là où c’est exigé), et un certificat EC reçoit unKeyAgreeRecipientInfode la RFC 5753 avec la clé de contenu enveloppée selon la RFC 3394.
L’OpenPGP en ligne (non MIME) n’est jamais écrit ; tout ce qui est émis est du PGP/MIME.
Avertissement
Placez cette étape avant l’étape de signature DKIM. La chaîne sortante recommandée est submission → … → encrypt → srs → dkim-sign → relay. DKIM doit signer les octets réellement transmis ; dans l’autre sens on produit du courrier d’apparence valide dont la signature ne se vérifie pas, ce qui est pire que pas de signature du tout. pepsi-setup avertit lorsqu’il trouve les deux dans le mauvais ordre.
37.2. Fonctionnalités¶
Le signataire est l’auteur. La signature emploie la clé de l’adresse
From:, jamais celle de l’expéditeur d’enveloppe : la signature porte sur l’auteur que voit le destinataire. Un message dont l’auteur n’est pas servi par ce déploiement, ou pour lequel il ne détient aucun matériel, part non signé au lieu de rebondir : c’est du courrier légitime malgré tout, et DKIM porte déjà la revendication au niveau du domaine. Une signature OpenPGP faite à l’intérieur du texte chiffré nomme le certificat du destinataire (Intended Recipient Fingerprint de la RFC 9580), de sorte qu’un destinataire ne peut pas la rechiffrer vers un tiers comme si elle avait été faite pour lui.Le contenu signé est en 7 bits. Avant la signature, un corps 8 bits est converti en quoted-printable ou en base64 (RFC 3156 section 5), de sorte qu’un prochain saut sans
8BITMIMEn’invalide pas la signature ; la conversion est omise là où pepsi-stage-dkim-sign l’omet, par exemple lorsque le client de l’auteur a déjà signé une partie.Un texte chiffré par destinataire. Chaque destinataire chiffré obtient son propre texte chiffré sur sa propre ligne de file d’attente. Ainsi, aucun texte chiffré ne nomme les autres destinataires, aucune clé de contenu n’est partagée, et aucun texte chiffré ne révèle un destinataire en
Bcc. Lorsque les destinataires d’un message divergent, l’étape les scinde à raison d’un par ligne, en découpantstate.dsn.rcpten parallèle, et chaque ligne réintègre seule cette étape. Les destinataires qui partagent tous une même issue ne sont jamais scindés.Protocole par destinataire. L’étape utilise OpenPGP (PGP/MIME, RFC 3156) ou S/MIME (CMS, RFC 8551), selon le protocole qui offre la clé la mieux classée.
PREFERne départage que les clés situées sur le même échelon de l’échelle de confiance, de sorte qu’un en-têteAutocrypt:falsifié ne peut pas surclasser un certificat S/MIME de meilleure provenance. Un auteur qui signe avec un protocole et chiffre vers l’autre signe tout de même à l’intérieur du texte chiffré.Négociation de conteneur par destinataire. Sous la valeur par défaut
CRYPTO_ALLOW_DOWNGRADE = negotiate, OpenPGP ne retombe sur SEIPDv1+MDC que lorsque le certificat propre du destinataire prouve qu’il ne sait pas lire l’AEAD, et S/MIME sur l”EnvelopedDataAES-256-CBC que lorsque l’enregistrement des capacités du destinataire le dit. Un tel repli découle d’un fait concernant le correspondant ; il est journalisé et noté, jamais silencieux.Une politique explicite pour « pas de clé ».
ON_NO_KEYdécoule deENCRYPT:opportunisticenvoie du courrier ordinaire,requiredemploie le portail de lien sécurisé lorsqu’un tel portail est configuré, et fait rebondir le message sinon.requiredne se dégrade jamais en clair. Une clé révoquée ou expirée n’est pas une clé : un certificat S/MIME hors de sa période de validité ou une clé OpenPGP passée son expiration est écarté avant le choix, et lareasondu destinataire l’indique avec la date.L’auteur est informé du clair lorsqu’il le demande.
NOTIFY_CLEARTEXT = author(désactivé par défaut, redéfinissable par adresse) envoie à l’auteur d’un message local un avis par copie partie non chiffrée, nommant les destinataires et la raison ; les destinataires sans clé d’un message partagent une même copie. Un objet qui commence par une quasi-correspondance d’un mot-clé de demande ([encyrpt],[encrypted], une lettre sosie) reçoit toujours une réponse d’avertissement nommant le mot-clé.Les en-têtes de demande n’atteignent jamais le fil.
X-Pepsi-SignetX-Pepsi-Encrypt(posés par le module complémentaire Outlook) sont retirés de chaque message sortant quoi qu’ils aient dit, et sont entièrement ignorés à moins que le message ne soit d’origine locale. Un mot-clé d’objet reconnu est retiré duSubjectégalement, de même que les propres étiquettes d’indicateur de Pepsi ([verified: …],[decrypted],[external]et les autres, selon la configuration) avant que l’objet ne soit signé ou protégé : une réponse ne transporte pas un indicateur local jusqu’à son destinataire, où la copie protégée se lirait comme une copie falsifiée. Voir Les étiquettes d’indicateur ne quittent pas le déploiement.Un plafond de taille visible.
MAX_SIZE(25 Mo par défaut) borne ce qui est chiffré : ni le constructeur CMS ni les chemins OpenPGP ne travaillent en flux, de sorte que le message entier est résident une fois par destinataire. Au-delà du plafond,ON_OVERSIZEdécide.Remplissage de longueur.
PADDING(activé par défaut) remplit chaque message chiffré jusqu’à une longueur Padmé, au plus 12 % plus longue : un paquet de remplissage RFC 9580 à l’intérieur d’un conteneur SEIPDv2, un champ d’en-tête de bourragePepsi-Padding:sur l’entité chiffrée pour SEIPDv1 et S/MIME. Voir La longueur d’un message chiffré.Le préréglage pEp.
ENABLE_PEP(activé par défaut) est un préréglage de valeurs par défaut, et non un mode contraignant : il fait valoirSIGNpar défautencrypted-only(ne signer que ce qui est chiffré, à l’intérieur du texte chiffré) et crée une clé OpenPGP pour un expéditeur local d’un domaine servi à sa première soumission, lorsque l’adresse n’a aucune identité d’aucune sorte et que[pepsi-crypto] AUTO_CREATE_IDENTITYle permet. AvecENABLE_PEP = no, une clé n’est créée que lorsqu’un auteur demande explicitement une protection (une signature ou un chiffrement seul) ou sousSIGN = always. Le login propriétaire de la clé est résolu au moyen des options de localité de[pepsi-crypto], comme pourpepsi-keys. Toute option écrite explicitement l’emporte toujours.La propre clé de l’utilisateur. Un expéditeur local habilité à parler pour l’adresse
From:peut enregistrer la clé que détient son client de messagerie (à partir de son en-têteAutocrypt:, ou d’une clé jointe pour la première clé de l’adresse) comme clé MUA (custody = client). Elle devient la face publique de l’adresse : le courrier local est chiffré vers elle, WKD la sert, et Pepsi n’ajoute alors ni en-têteAutocrypt:ni fichier de clé qui lui soit propre.Le courrier que le client a déjà protégé est laissé tel quel. Une soumission dont la couche la plus externe est du texte chiffré n’est pas chiffrée, signée ni dotée d’une clé une seconde fois (
state.crypto.out.client_protected). Une soumission que le client a signée peut encore être chiffrée, mais ne reçoit aucune signature de Pepsi.La clé sous forme de fichier.
ATTACH_KEYS_AS_FILES(désactivé par défaut) joint aussiOpenPGP_0x<long key ID>.ascjusqu’à ce que chaque destinataire ait prouvé qu’il détient la clé ; dans un message chiffré, le fichier se trouve à l’intérieur du texte chiffré.Les clés par e-mail. Avec
RESPONSE_STAGEdéfini, un message adressé àKEYS_CONTROL_LOCAL_PART@<served domain>(par défautpepsi-keys@) est une commande de clé (status,generate,register,publish,retire,pin,otp enroll,otp confirm,otp remove) et reçoit une réponse au lieu d’être relayé. Une commande autre questatussous un préfixe de réponse ou de transfert (Re:,Fwd:, …) est refusée, puisqu’un tiers a pu l’écrire et que l’utilisateur s’est peut-être contenté d’y répondre. Une adresse dotée d’un second facteur TOTP inscrit (Un second facteur pour la gestion des clés) doit mettre le code courant dans l’objet de chaque commande saufstatus, et n’enregistre aucune clé depuis son en-têteAutocrypt:.otp enrollmet en place un secret qui ne prend effet qu’une fois queotp confirm CODEl’a confirmé dans les limites deOTP_CONFIRM_WINDOW(une heure par défaut) ; la réponse portant le secret est chiffrée vers les propres clés (MUA) de l’utilisateur lorsqu’il en a, et porte un en-têteExpires:.Elle annonce la clé de l’auteur.
AUTOCRYPT(par défaut activé) ajoute un en-têteAutocrypt:d’Autocrypt Level 1 à chaque message soumis localement que l’étape valide, y compris le passage en clair sans traitement, puisqu’un correspondant doit apprendre la clé avant qu’il n’y ait quoi que ce soit à chiffrer. L’en-tête porte la clé publique transférable minimale d’une identité OpenPGP dont ce déploiement détient encore la moitié privée. Il n’est jamais ajouté par-dessus un en-tête posé par le MUA de l’auteur, ni lorsque la face publique est une clé MUA, etprefer-encrypt=mutualn’est revendiqué que lorsque leENCRYPTconfiguré vautrequired. Sur le chemin chiffrant, le champ va sur le bloc d’en-têtes extérieur.Le gossip est sur consentement explicite.
AUTOCRYPT_GOSSIP(par défaut désactivé) rend en outre un champAutocrypt-Gossip:par autre destinataire à l’intérieur de la partie protégée, car cela redistribue le matériel de clé de tiers à des correspondants qui ne l’ont jamais demandé. Le gossip ne couvre que les adresses desTo:/Cc:analysés, de sorte qu’un destinataire enBccne peut jamais être gossipé. Il ne concerne qu’OpenPGP et ne déclenche aucune découverte (une adresse non mise en cache est abandonnée, jamais mise en attente), et au-delà de 50 destinataires visibles il n’y a aucun gossip.GOSSIP_MIN_TRUST(par défautowner-confirmed) est un plancher à part entière, puisque republier une clé n’est pas le même acte que d’en utiliser une ; le plancher appliqué est le plus strict de lui et deMIN_TRUST.Les clés faibles et compromises ne sont pas utilisées. Trois sortes de clés de destinataire comptent comme une absence de clé : une clé inférieure à
CRYPTO_MIN_RSA_BITS, un module RSA dont les facteurs peuvent être calculés (ROCA, Fermat, un petit facteur), et une clé de la liste des clés connues comme compromises (pepsi.compromised_key: la liste de blocage badkeys que tient à jourpepsi-keys blocklist update, et le PGCD par lots quotidien depepsi-keys peer screen).Un échec DNS n’est pas « pas de clé ». Là où la voie sans clé serait le clair, le traitement d’un destinataire dont la recherche de clé a échoué dans le DNS (Une recherche de clé qui échoue dans le DNS) dépend du comportement du domaine. Tant que le domaine ne répond pas, le destinataire est différé, puis rebondi avec
5.4.3aprèsMAX_LIFETIME(au plus 120 h), avec un DSN de délai aprèsDELAY_DSN_AFTER(4 h par défaut) si l’expéditeur en a demandé un. Lorsque le domaine répond mais que ses enregistrements de clés continuent d’échouer, le destinataire est acheminé versSECURE_LINK_STAGE(ou rebondi). Un expéditeur local accepte le clair avec le mot-clé d’objet[clear-ok](SUBJECT_KEYWORDS_CLEAR_OK) ouCLEAR_ON_DNS_FAILURE = yes.La protection des en-têtes est sur consentement explicite.
PROTECT_HEADERS(désactivé par défaut) copie les champs RFC 5322 dans l’entité protégée (en-têtes injectés de la RFC 9788) et remplace leSubjectextérieur par...; pepsi-stage-decrypt compare un telFrom:protégé à celui de l’extérieur (Les en-têtes protégés face aux en-têtes extérieurs), et lesTo:/Cc:protégés placent les destinataires à l’intérieur de la signature. Elle est désactivée parce qu’un client incapable de rendre les en-têtes protégés affiche...comme objet ; une population dont les clients savent les rendre l’active.Une signature dit pour qui elle a été faite. L’OpenPGP signé et chiffré nomme les certificats des destinataires dans des sous-paquets Intended Recipient Fingerprint, et S/MIME les nomme dans un attribut signé privé (À qui était destiné un message signé et chiffré), de sorte qu’un destinataire ne peut pas rechiffrer le message signé vers un tiers comme s’il avait été signé pour lui.
La RFC 9709 pour ceux qui la demandent. Un destinataire S/MIME dont les propres
SMIMECapabilitiessignées nommentid-alg-cek-hkdf-sha256reçoit une clé de contenu dérivée sur l’identifiant d’algorithme, ce qui empêche un message AES-GCM capturé d’être resoumis en AES-CBC sous la même clé ; les propres signatures de Pepsi l’annoncent.Les propres avis de Pepsi peuvent être signés. Avec
NOTICE_SIGNERdéfini, une instance de cette étape signe chaque message que Pepsi a composé lui-même avec une seule identité du déploiement, publiée dans son Web Key Directory, et ne chiffre jamais ces messages (Les avis signés, Avis falsifiés). Ce sont les liens de connexion et de portail, les défis du secrétaire, les demandes de paiement, les réponses aux commandes, ainsi que les avis de changement de clé et d’absence ; l’étape les reconnaît à la marquestate.noticeque pose leur émetteur. L’assistant écrit un tel[stage-notice]avec l’option en commentaire et y fait pointer les émetteurs d’avis.
37.3. Où elle se situe¶
submission → aliases → anti-spam → detect-language → encrypt → srs → dkim-sign → relay
Les deux voisines qui lisent le corps du message, la barrière de péage à l’envoi et la détection de langue, ont besoin de texte clair ; elles l’obtiennent parce que le chiffrement vient en dernier. ARC ne s’applique pas : il vise le courrier relayé pour le compte d’autrui, et cette étape ne signe et ne chiffre que du courrier émis par Pepsi.
Un message qui n’est pas d’origine locale est avancé sans être touché (ses en-têtes X-Pepsi-* retirés) : chiffrer un message tiers relayé invaliderait la signature DKIM et la chaîne ARC de l’auteur.
37.4. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-encrypt, NEXT_STAGE (requis) et BOUNCE_STAGE, plus ENABLE_PEP, SIGN, ENCRYPT, ATTACH_KEYS_AS_FILES, KEYS_CONTROL_LOCAL_PART, OTP_CONFIRM_WINDOW, RESPONSE_STAGE, PREFER, ON_NO_KEY, ON_OVERSIZE, PADDING, MIN_TRUST, SUBJECT_KEYWORDS_SIGN / _ENCRYPT / _BOTH, STRIP_REQUEST_HEADERS, PROTECT_HEADERS, MAX_SIZE, AUTOCRYPT, AUTOCRYPT_GOSSIP, GOSSIP_MIN_TRUST, SECURE_LINK_STAGE, DISCOVERY, DISCOVERY_TIMEOUT, SUBJECT_KEYWORDS_CLEAR_OK, CLEAR_ON_DNS_FAILURE, DELAY_DSN_AFTER, NOTICE_SIGNER et NOTIFY_CLEARTEXT. pepsi-setup exige un BOUNCE_STAGE dès que ON_NO_KEY/ON_OVERSIZE se résolvent en bounce, et vérifie que SECURE_LINK_STAGE et RESPONSE_STAGE nomment des étapes réelles. Toutes sont documentées dans pepsi.conf(5).
Ce sont des options de comportement, redéfinissables par adresse via la table pepsi.settings (indexée, pour le courrier sortant, sur l’expéditeur d’enveloppe), sauf NOTICE_SIGNER, que l’étape lit dans le seul fichier de configuration. La politique cryptographique réside dans les options CRYPTO_* de [pepsi] et dans [pepsi-crypto] : quels algorithmes, si un conteneur rétrogradé peut être émis, les tailles de clé minimales. Seul l’administrateur système la fixe, et elle est délibérément inatteignable depuis pepsi.settings ou depuis pepsi-stage-edit-settings.
37.5. Privilège¶
Installée setuid pepsi-crypto, mode 4750 pepsi-crypto:pepsi, et donc autonome plutôt que pliée dans le binaire pepsi unifié.
Les deux moitiés de la frontière de garde des clés reposent sur cette identité : le rôle de base de données pepsi-crypto est le seul à détenir le droit sur crypto_identity.private_wrapped, et l’authentification par pair de PostgreSQL se fonde sur l”uid effectif ; la clé de chiffrement de clés est un fragment 0640 appartenant au même compte. Un binaire setgid atteindrait le fragment et s’authentifierait tout de même auprès de la base en tant que pepsi, le rôle à qui la colonne est refusée. Voir Gestion des clés pour le modèle de garde, La frontière de garde des clés privées pour le mécanisme et Chiffrement de bout en bout : deux modes de garde pour ce qu’il revendique. La séparation de garde protège contre la divulgation d’une clé, non contre son utilisation : l’étape signe au nom du From: de la ligne de file, que n’importe quelle étape pepsi peut réécrire après la vérification de l’ingress ; le modèle de menace documente ce risque résiduel.
37.6. État¶
Lit state.local_origin et state.notice. Écrit state.crypto.out : si le message a été signé, par quelle identité, et une entrée par destinataire portant outcome, protocol, fingerprint, key_source, trust, content_algorithm et downgraded, plus key_attached et client_protected lorsqu’ils s’appliquent. Positionne state.encrypted = true lorsque quelque chose a été chiffré : la clé que pepsi-stage-auto-whitelist lit pour sa colonne signature_required. Sur un rebond de politique, elle écrit state.bounce avec un code d’état étendu 5.7.0 (5.4.3 pour un destinataire dont le DNS a continué d’échouer) ; tant qu’un message est différé pour un échec DNS d’un destinataire, state.encrypt_dns_deferred, state.last_error et, une fois un DSN de délai parti, state.delay_sent.
Chaque issue en clair atteinte alors que le chiffrement était souhaité est journalisée en WARN : envoyer du courrier non protégé n’est jamais un événement silencieux.
37.7. Voir aussi¶
pepsi-stage-decrypt (la moitié entrante), pepsi-stage-secure-link (où mène la route secure-link en l’absence de clé), pepsi-stage-dkim-sign, pepsi-keys, pepsi-keydisc, Gestion des clés (identités, garde et échelle de confiance sur laquelle le MIN_TRUST de cette étape sélectionne), Le portail de repli par lien sécurisé, À qui était destiné un message signé et chiffré, Quel conteneur S/MIME reçoit un correspondant, Clés des correspondants, Interopérabilité des clients (quels clients ont été mesurés face à ce qu’émet cette étape), Index des RFC, pepsi.conf(5), pepsi.state(7)