95.1.6. pepsi-stage-encrypt¶
sign outgoing mail as its author and encrypt it to each recipient
- Section du manuel:
1
95.1.6.1.1. Nom¶
pepsi-stage-encrypt - l’étape sortante de signature et de chiffrement de bout en bout du pipeline Pepsi.
95.1.6.1.2. Synopsis¶
pepsi-stage-encrypt [GLOBAL-OPTIONS] worker
95.1.6.1.3. Description¶
pepsi-stage-encrypt 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. Pour chaque message soumis localement, il décide de la protection à appliquer, l’applique, et achemine chaque destinataire plus loin.
Le nom sous-estime l’étape : elle signe autant qu’elle chiffre, et dans cet ordre (signer dedans, chiffrer dehors). La signature emploie la clé de l’auteur du From:, jamais celle de l’expéditeur d’enveloppe — la signature porte sur l’auteur que voit le destinataire, et une signature dont l’identité ne correspond pas est ce que les vérificateurs signalent. Si l’adresse From: n’est pas une adresse que ce déploiement sert, ou ne détient aucun matériel de signature, le message est envoyé non signé plutôt que rebondi : un auteur que l’on ne sert pas reste du courrier légitime, 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 (un sous-paquet Intended Recipient Fingerprint de la RFC 9580), de sorte qu’un destinataire qui déchiffre le message et le rechiffre, toujours signé, vers un tiers ne peut pas le faire passer pour signé à l’intention de ce dernier : un vérificateur qui contrôle le sous-paquet, pepsi-stage-decrypt(1) compris, le signale comme ne lui étant pas adressé. Une signature S/MIME faite à l’intérieur du texte chiffré fait de même avec un attribut CMS signé privé qui liste le SHA-256 de chaque certificat destinataire (identifiant d’objet 1.3.6.1.4.1.32473.808069.1, provisoire jusqu’à ce que le projet détienne un numéro d’entreprise IANA) ; pepsi-stage-decrypt(1) le vérifie comme le sous-paquet OpenPGP, et les autres clients S/MIME l’ignorent, comme l’exige la RFC 5652 pour tout attribut signé qu’ils ne connaissent pas. Pour ces clients, ce sont les To: et Cc: protégés de PROTECT_HEADERS (désactivé par défaut) qui portent les destinataires à l’intérieur de la signature. Une signature en clair ne nomme personne.
Avant la signature, un corps 8 bits est converti en quoted-printable ou en base64, comme RFC 3156 section 5 l’exige du contenu signé : un prochain saut qui ne propose pas 8BITMIME ferait sinon réencoder les parties signées par le relais et la signature ne se vérifierait plus. Cela s’applique aussi à l’intérieur d’un texte chiffré, parce que la passerelle du destinataire peut déchiffrer le message et le relayer plus loin. La conversion est celle qu’applique pepsi-stage-dkim-sign(1), et elle est omise dans les mêmes cas, par exemple lorsque le propre client de l’auteur a déjà signé une partie.
Le chiffrement se fait par destinataire. Chaque destinataire qui reçoit du texte chiffré reçoit son propre texte chiffré et sa propre ligne de file d’attente : aucun texte chiffré ne nomme les autres destinataires, aucune clé de contenu n’est partagée entre destinataires, et aucun texte chiffré ne révèle un destinataire en Bcc. Regrouper les destinataires S/MIME dans un unique EnvelopedData serait moins coûteux et c’est ce à quoi le format sert, mais cela révèle l’ensemble des destinataires à chacun d’eux et laisse une seule clé compromise ouvrir le message pour tous.
L’étape ne fait aucune E/S réseau d’aucune sorte. Lorsque la clé d’un destinataire n’est pas en cache, l’étape met le message en pause et met en file une demande de découverte ; un service pepsi-keydisc(1) le libère lorsque la demande se conclut, qu’une clé ait été trouvée ou non. Un destinataire ayant une entrée de cache négatif fraîche prend immédiatement le chemin sans clé, sans pause, puisqu’il n’y a rien à attendre. Un destinataire dont la meilleure clé est une clé que personne n’a publiée — moissonnée dans son propre courrier, signé ou non, ou issue du gossip — reçoit un chiffrement vers elle sans pause, et une demande de découverte est lancée en arrière-plan, au plus une fois par [pepsi-keydiscovery] NEGATIVE_TTL et jamais tant qu’une demande est en attente ou qu’une réponse négative fraîche subsiste, afin qu’une clé publiée par le propriétaire (WKD, DANE, un serveur de clés) puisse remplacer la clé moissonnée pour le message suivant.
Un message dont ce déploiement n’est pas à l’origine (pas de state.local_origin) est avancé sans être touché. Chiffrer un message tiers relayé invaliderait la signature DKIM et la chaîne ARC de l’auteur, et le signer au nom de l’un de nos utilisateurs serait un mensonge. Ses en-têtes de demande X-Pepsi-* sont tout de même retirés, de sorte qu’un expéditeur extérieur ne puisse pas laisser le canal de contrôle propre à Pepsi sur le fil.
Avertissement
Placez cette étape avant pepsi-stage-dkim-sign(1), non après.
La chaîne sortante recommandée est
submission -> ... -> encrypt -> srs -> dkim-sign -> relay
DKIM doit signer les octets réellement transmis. Si la signature DKIM s’exécute d’abord, cette étape réécrit le corps sous la signature et le résultat est du courrier d’apparence parfaitement valide dont la signature ne vérifie pas — ce qui est pire que pas de signature du tout, car une signature cassée est un signal négatif plus fort pour un destinataire qu’une signature absente. pepsi-setup(1) avertit lorsqu’il trouve une étape de signature DKIM qui mène à celle-ci.
Deux autres étapes voisines ont besoin du texte clair et l’obtiennent : la barrière de péage à l’envoi (pepsi-stage-anti-spam(1)) et la détection de langue (pepsi-stage-detect-language(1)) lisent le corps du message, et sur le chemin sortant elles s’exécutent avant cette étape. C’est pourquoi le chiffrement vient en dernier.
95.1.6.1.3.1. Résolution de la politique¶
La protection qu’un message demande est résolue à partir de quatre entrées, la plus spécifique d’abord :
la barrière
state.local_origin— rien de ce qui suit ne s’applique à un message que nous ne faisons que rediriger ;les en-têtes de demande qu’un module complémentaire a posés (
X-Pepsi-Sign,X-Pepsi-Encrypt, chacunyes/no/required) ;un mot-clé d’objet (
SUBJECT_KEYWORDS_SIGN/_ENCRYPT/_BOTH) ;les valeurs par défaut
SIGNetENCRYPTde[stage-encrypt], qui portent déjà toute redéfinition par adresse issue de la tablepepsi.settings.
Les deux en-têtes de demande sont retirés du message sortant quoi qu’ils disent et quelle que soit la valeur de STRIP_REQUEST_HEADERS : un canal de contrôle qui survit jusque sur le fil est un canal de contrôle auquel on peut ordonner au saut suivant d’obéir. Un mot-clé d’objet reconnu est de même retiré du Subject.
De même pour les propres étiquettes d’indicateur de Pepsi, sur chaque message qu’envoie un utilisateur local et avant que l’objet ne soit signé ou copié dans les en-têtes protégés : une réponse à [verified: a@example.org] report part sous la forme Re: report. Les étiquettes sont les intégrées [decrypted], [verified] sous toutes ses formes ([verified: …], [verified (except reply-to): …]), [decrypted, unauthenticated], [unverified signer], [bad signature], [unsigned, usually signed] et [external], ainsi que tout ce que configurent les options TAG_* des étapes de déchiffrement et [pepsi-ingress] TAG_EXTERNAL. Ce sont des déclarations que ce déploiement a faites à son propre utilisateur et qui ne signifient rien pour le destinataire ; à l’intérieur des en-têtes protégés d’un message signé, une étape de déchiffrement réceptrice les lirait comme un indicateur falsifié et retiendrait valid. Elles sont reconnues comme le nettoyage entrant les reconnaît, par squelette, en tête de l’objet et derrière les préfixes Re:/Fwd: et les étiquettes de liste, mais seulement sous leur forme entre crochets ; tout le reste de l’objet est laissé tel que l’utilisateur l’a écrit.
Un mot-clé d’objet de chiffrement (SUBJECT_KEYWORDS_ENCRYPT ou _BOTH) ou un en-tête X-Pepsi-Encrypt: required élève la politique à required pour ce message, et required ne se dégrade jamais en texte clair — si l”ON_NO_KEY résolu dit cleartext, il est élevé au lien sécurisé (ou à un rebond) pour ce message. Un utilisateur qui a explicitement demandé une protection n’est pas silencieusement ignoré.
Avec ENABLE_PEP = no, du matériel de clé n’est créé que lorsqu’un message le demande : une demande explicite de quelque sorte que ce soit (X-Pepsi-Sign/X-Pepsi-Encrypt autre que no, ou n’importe quel mot-clé d’objet – y compris un mot-clé [encrypt] sous SIGN = no), ou SIGN = always sauf si X-Pepsi-Sign: no a refusé la signature. Lorsque [pepsi-crypto] AUTO_CREATE_IDENTITY est activé, qu’un KEY_WRAP_SECRET est configuré, que le domaine du From: fait partie de [pepsi-ingress] ACCEPTED_DOMAINS et que l’auteur n’a aucune identité de quelque sorte que ce soit, une identité est engendrée en ligne, dans le protocole de la clé du destinataire lorsque le message est chiffré et dans le protocole de PREFER sinon. Une adresse qui n’a fait qu’apparaître dans une enveloppe ne déclenche jamais cela : un utilisateur qui n’emploie jamais la fonctionnalité n’a donc jamais de matériel de clé et n’y est jamais exposé. Sous la valeur par défaut ENABLE_PEP = yes, une clé est au contraire créée à la première soumission de l’expéditeur, demande ou non ; voir Le préréglage pEp ci-dessous.
Quelle que soit la manière dont elle est créée, le propriétaire de l’identité est le login passwd vers lequel les LOCAL_DOMAINS, TARGETS et RECIPIENT_DELIMITER de [pepsi-crypto] résolvent l’adresse, exactement comme pour pepsi-keys(1) ; aucun lorsque l’adresse est une adresse de rôle ou un domaine hébergé.
Dans les deux cas, la création automatique est refusée pour une adresse qui a déjà une ligne crypto_identity de quelque sorte que ce soit – une clé MUA enregistrée par l’utilisateur, une clé importée uniquement publique, ou une clé révoquée. Un mot-clé [sign] d’un utilisateur qui a apporté sa propre clé ne crée donc pas de seconde clé dans son dos ; un utilisateur qui veut une clé gérée par le serveur à côté de la sienne en demande une explicitement (la commande generate ci-dessous, pepsi-keys identity generate, ou la console web).
Une clé qui devrait être créée et ne peut pas l’être – la base de données refuse l’écriture, la génération elle-même échoue – est journalisée au niveau warn, et le message poursuit comme pour une adresse sans clé : sa politique décide s’il part non signé ou s’il est refusé. L’utilisateur n’a pas demandé que la clé soit créée, et prendre son courrier en otage d’un magasin de clés cassé est pire que de l’envoyer sans. (Un déploiement sans KEY_WRAP_SECRET ne crée aucune clé et n’est pas concerné.) L’enregistrement de la clé que le client d’un utilisateur annonce relève du meilleur effort de la même façon.
Dès qu’une clé de signature existe et ne peut pas être ouverte (une clé de chiffrement de clés illisible, un droit révoqué), le message n’est pas envoyé non signé : cette erreur est réessayée jusqu’au MAX_LIFETIME de l’étape (voir pepsi-dispatch(1)), comme toute autre défaillance de cet hôte, puisque envoyer sans signature masquerait un déploiement cassé. La section de l’étape, la politique crypto [pepsi], [pepsi-keydiscovery] et, lorsqu’une clé de chiffrement de clés est configurée, le trousseau construit à partir d’elle sont vérifiés au démarrage du worker : un élément qui ne fonctionne pas fait refuser au worker de démarrer (sortie 78), et le dispatcher retient la file jusqu’à sa correction.
95.1.6.1.3.2. Le préréglage pEp¶
ENABLE_PEP (par défaut yes) fait se comporter l’étape comme le projet pretty Easy privacy (pEp) : chaque expéditeur local reçoit une clé, le courrier est chiffré chaque fois que la clé d’un destinataire est connue ou découvrable, et la clé publique de l’expéditeur part avec chaque message. C’est un préréglage de valeurs par défaut, pas un mode contraignant : il change les valeurs par défaut d’autres options, et toute option écrite explicitement dans la section (ou dans une redéfinition pepsi.settings par adresse) l’emporte toujours.
Comportement |
|
|
|---|---|---|
Valeur par défaut de |
|
|
Création de clé |
anticipée (première soumission) |
sur demande, ou |
Valeur par défaut de |
|
|
Valeur par défaut de |
|
|
|
|
|
Le préréglage ne concerne que le courrier que les utilisateurs envoient : sous celui-ci, le courrier en clair d’un utilisateur qui détient une clé n’est pas signé par Pepsi, et les expéditeurs reçoivent des clés qu’ils n’ont pas demandées. Ce que quiconque peut recevoir n’en dépend pas : le courrier entrant est traité de la même manière dans les deux cas.
Les formats standard sur le réseau sont inchangés : les messages sont du PGP/MIME et de l’Autocrypt ordinaires. Il n’y a ni en-têtes X-pEp-Version, ni enveloppement de message pEp 2.x, ni trustwords ou poignée de main, ni synchronisation de clés entre appareils, et le préréglage ne change pas PROTECT_HEADERS.
Création de clé anticipée. Sur chaque message soumis localement et validé, l’étape génère une clé MTA OpenPGP pour l’adresse From: lorsque toutes les conditions ci-dessous sont réunies. Cela vaut pour le passage en clair aussi bien que pour la route protégée, afin que le premier message porte déjà la nouvelle clé dans son en-tête Autocrypt:. Les conditions sont :
ENABLE_PEPest activé pour le message (il est redéfinissable par adresse) ;le domaine du
From:fait partie de[pepsi-ingress] ACCEPTED_DOMAINS: une clé n’est jamais créée que pour une adresse dont le courrier entrant passe par ce déploiement, ce qui permet à pepsi-stage-decrypt(1) d’ouvrir les réponses chiffrées pour elle ;[pepsi-crypto] AUTO_CREATE_IDENTITYest activé – le veto de l’opérateur, qu’aucun paramètre par adresse ne peut redéfinir ;un
[pepsi-crypto] KEY_WRAP_SECRETest configuré ;l’adresse n’a aucune ligne
crypto_identityde quelque sorte que ce soit, quels que soient son statut, son protocole ou sa garde. Une clé révoquée compte : si quelqu’un a révoqué une clé, Pepsi n’en crée pas discrètement une de remplacement.
Cela couvre toutes les routes de soumission, y compris les relais mynetworks et client-cert, de sorte qu’un Pepsi déployé comme proxy derrière un MTA qui authentifie les utilisateurs fonctionne de la même manière. Une application web qui envoie en tant que noreply@ d’un domaine pour lequel Pepsi ne reçoit pas de courrier n’obtient pas de clé. Deux workers voyant en même temps le même expéditeur nouveau stockent exactement une clé : le test et l’insertion s’exécutent sous un verrou par adresse dans la fonction SQL crypto_identity_create_if_absent, et le perdant jette ce qu’il a généré. Une clé créée automatiquement est marquée auto_created, publiée sur le WKD propre au déploiement, et jamais téléversée vers un serveur de clés à moins que son propriétaire ne le demande (vks_wanted = false ; voir pepsi-keys(1)).
SIGN = encrypted-only (la valeur par défaut du préréglage) ne signe un message que lorsque cette étape le chiffre, et alors à l’intérieur du texte chiffré. Le courrier en clair porte la clé de l’expéditeur (l’en-tête Autocrypt:, plus le fichier de clé lorsque ATTACH_KEYS_AS_FILES est activé) mais aucune signature, de sorte qu’un destinataire qui n’utilise pas la cryptographie ne voit jamais de signature.asc. Une demande explicite (X-Pepsi-Sign: yes, un mot-clé d’objet [sign]) signe toujours le texte en clair. Écrire SIGN = opportunistic conserve le comportement « tout signer » sous le préréglage.
Le premier message vers un nouveau correspondant peut encore attendre la découverte de clé jusqu’à DISCOVERY_TIMEOUT puis partir en clair ; le préréglage ne change pas la découverte.
95.1.6.1.3.3. Deux clés par utilisateur : clés MTA, clés MUA et face publique¶
Une adresse peut détenir deux sortes d’identité :
- Clé MTA
custody = local: Pepsi détient la moitié privée (enveloppée danscrypto_identity.private_wrapped). Pepsi signe, déchiffre et annonce avec elle. Générée automatiquement, sur demande, ou importée avec sa moitié privée.- Clé MUA
custody = client: la propre clé de l’utilisateur, dont la moitié privée ne réside que dans son client de messagerie. La ligne reste à jamais uniquement publique. Pepsi chiffre pour elle et reconnaît le courrier entrant chiffré pour elle, mais ne peut jamais l’ouvrir, signer avec elle ni l’annoncer.
La face publique d’une adresse est la clé qu’un correspondant devrait utiliser : la clé MUA active la plus récente lorsque l’utilisateur en a une, sinon la clé MTA active principale qui détient encore sa moitié privée. L’en-tête Autocrypt:, le fichier de clé, le WKD du déploiement et le chiffrement local la lisent tous selon le même ordre, de sorte qu’ils ne peuvent pas diverger :
WKD ne sert que des clés MUA lorsqu’il y en a une – toutes celles qui sont actives, les plus récentes d’abord, au plus huit – et jamais la clé MTA à côté d’elles ;
le courrier d’un utilisateur local vers un autre est chiffré pour la face publique et pour les autres clés MUA de l’utilisateur dans ce protocole, l’ensemble que sert WKD ;
Pepsi n’ajoute aucun en-tête
Autocrypt:et ne joint aucun fichier de clé lorsque la face publique est une clé MUA. Le client de messagerie annonce sa propre clé, et si Pepsi en annonçait une autre sur une partie des messages du même utilisateur, l’état des clés des correspondants basculerait sous la règle « le plus récent l’emporte » d’Autocrypt.
La clé MTA n’est pas retirée lorsqu’une clé MUA apparaît. Elle continue de déchiffrer le courrier des correspondants qui l’utilisent encore, et elle signe toujours, à l’intérieur du texte chiffré, le courrier en clair que Pepsi chiffre pour le compte de l’utilisateur. Le courrier entrant chiffré pour une clé MUA est transmis au client de messagerie sans être ouvert ; voir pepsi-stage-decrypt(1).
95.1.6.1.3.4. Enregistrer la propre clé de l’utilisateur¶
Un message soumis localement dont l’adresse From: est dans un domaine servi peut enregistrer comme clé MUA la clé qu’utilise son client de messagerie. L’enregistrement ne dépend pas d”ENABLE_PEP. La clé est prise dans :
l’unique en-tête
Autocrypt:valide du message, dont leaddr=doit être égal à l’adresseFrom:; ou, à défaut,une partie
application/pgp-keysjointe dont les User IDs nomment l’adresse – mais seulement pour la toute première clé de l’adresse. Une pièce jointe est un signal plus faible qu’un en-tête que gère le client de messagerie : une seconde clé n’est donc enregistrée qu’à partir d”Autocrypt:.
Cela n’a lieu que lorsque l’émetteur de la soumission peut parler au nom de l’adresse From:, ce qui est plus strict que d’être autorisé à envoyer en son nom : le message est arrivé d’un relais de confiance (state.origin.auth_method vaut mynetworks ou client-cert), ou d’un compte authentifié (sasl, peercred) pour lequel l’ingress a noté state.origin.from_bound = true – le From: est exactement une boîte aux lettres qui a correspondu à une entrée USERNAME_MAP concrète et sans joker du compte, ou à sa valeur par défaut login@HOSTNAME. Un compte à qui l’on a accordé un joker (*@example.org, *) peut envoyer au nom de ses collègues mais n’enregistre jamais de clé pour eux.
Une empreinte que l’adresse possède déjà, retirée ou non, n’est pas enregistrée de nouveau, de sorte qu’une clé que l’utilisateur a retirée ne revient pas parce qu’un ancien appareil l’envoie encore. Une nouvelle clé MUA est stockée avec vks_wanted = false et devient aussitôt la face publique. Lorsque l’adresse avait déjà une autre identité, l’utilisateur reçoit un avis à expéditeur nul (Auto-Submitted: auto-generated, le modèle key-registered.<lang>.body) à RESPONSE_STAGE, qui nomme l’empreinte et indique comment la retirer – afin qu’une clé ajoutée avec un mot de passe volé ne passe pas inaperçue. L’avis (et la réponse à register) indique aussi ce que coûte la perte de la clé : le courrier chiffré pour elle, et le courrier entrant que pepsi-stage-reencrypt(1) scelle à nouveau avant qu’il ne soit classé, ne s’ouvrent qu’avec les clés enregistrées de l’utilisateur, et la passerelle ne conserve aucune clé propre qui pourrait les ouvrir. La voie de secours qu’il nomme est une deuxième ou troisième clé enregistrée (un autre appareil, un jeton de sauvegarde), puisque le courrier est scellé pour chaque clé enregistrée. Sans RESPONSE_STAGE, la clé est quand même enregistrée mais aucun avis ne peut être envoyé. Le message lui-même poursuit son chemin inchangé, hormis l’hygiène habituelle des en-têtes.
Une adresse qui a enrôlé un second facteur (otp enroll, ci-dessous) n’enregistre rien de cette manière : un message ne peut pas porter de code, et ce chemin est exactement celui qu’emprunterait un attaquant muni d’un mot de passe volé. Son propriétaire enregistre plutôt une nouvelle clé avec register CODE.
95.1.6.1.3.5. Courrier que le client a déjà protégé¶
Seule la couche la plus externe du message soumis est consultée :
- Déjà chiffré
PGP/MIME, un
application/pkcs7-mimeS/MIME enveloppé, un-----BEGIN PGP MESSAGEen ligne, une signature enveloppant du texte chiffré, ou tout ce qu’aucun classificateur n’a pu identifier. L’étape ne chiffre, ne signe et ne joint rien, et n’ajoute aucun en-têteAutocrypt:. L’hygiène des en-têtes et l’enregistrement de clé MUA ci-dessus s’exécutent quand même.state.crypto.out.client_protected = trueest noté.- Déjà signé (
multipart/signed, PGP en ligne signé) L’étape peut encore le chiffrer, sous la forme
encrypted(signed), mais n’ajoute aucune signature propre ni aucun fichier de clé en clair.
Un message chiffré transféré, joint en message/rfc822, est la protection de quelqu’un d’autre et ne compte pas.
95.1.6.1.3.6. Joindre la clé sous forme de fichier¶
ATTACH_KEYS_AS_FILES (par défaut no, indépendant du préréglage) joint aussi la clé publique de l’expéditeur à la manière OpenPGP classique, en plus de l’en-tête Autocrypt:, pour les correspondants dont le client ne lit pas Autocrypt. La partie est un application/pgp-keys nommé OpenPGP_0x<long key ID>.asc (les 16 derniers chiffres hexadécimaux de l’empreinte, le nom qu’utilise Thunderbird), contenant le même certificat minimal que porte l’en-tête, en armure ASCII.
Sur la route de chiffrement, elle va à l’intérieur du texte chiffré, placée comme le gossip.
Sur la route en clair, le message validé est enveloppé dans un nouveau
multipart/mixedcontenant l’entité d’origine et la partie de clé, ou la clé devient une partie de plus d’unmultipart/mixedexistant. L’étape s’exécute avant pepsi-stage-dkim-sign(1), de sorte que la signature DKIM du déploiement couvre le résultat.Elle est jointe jusqu’à ce que chaque destinataire de la ligne détienne la clé de manière prouvée (l’enregistrement
pepsi.peer_has_own_keyque pepsi-stage-autocrypt-learn(1) écrit lorsqu’un correspondant envoie une réponse chiffrée et signée). L’enregistrement est indexé sur l’empreinte, de sorte qu’une nouvelle clé recommence à être jointe. Une ligne en clair à plusieurs destinataires n’est pas scindée pour cela : la clé part vers tous si l’un des destinataires n’a pas de preuve.Jamais lorsque la face publique est une clé MUA, jamais sur un message que le client a chiffré, et pas sur du texte en clair que le client a signé. Un message portant déjà le fichier de la clé n’en reçoit pas un second.
state.crypto.out.key_attached = true note que le fichier est parti.
95.1.6.1.3.7. Gérer vos clés par e-mail¶
Lorsque RESPONSE_STAGE est défini et que KEYS_CONTROL_LOCAL_PART ne vaut pas none, un message soumis localement dont le seul destinataire est <KEYS_CONTROL_LOCAL_PART>@<served domain> (par défaut pepsi-keys@) est une commande de clé. Il est consommé – supprimé, jamais relayé – et reçoit une réponse à RESPONSE_STAGE avec le modèle keys.<lang>.body, qui liste les clés de l’adresse. La commande est le Subject:, insensible à la casse. Un objet commençant par un préfixe de réponse ou de transfert – n’importe quel mot d’au plus douze lettres suivi d’un deux-points, comme Re:, Fwd:, AW:, SV: ou Re[2]: – est lu comme status ou comme la commande qui suit le préfixe, mais chaque commande sauf status est alors refusée et ne change rien : le client de l’utilisateur a composé cet objet à partir d’un message écrit par quelqu’un d’autre, et un tiers qui envoie à un utilisateur Subject: retire FPR avec un Reply-To: pointant vers cette adresse ferait sinon retirer la clé par la réponse de l’utilisateur. Une commande qui change quelque chose doit être écrite comme un nouveau message. Les commandes sont :
statusListe les clés de l’adresse : sorte (gérée par le serveur ou propre clé de l’utilisateur), statut, état sur le serveur de clés, et laquelle est donnée aux correspondants.
generateCrée une clé MTA OpenPGP gérée par le serveur. Toujours permis sur demande, même à côté de la propre clé de l’utilisateur ou d’une clé révoquée. Son téléversement vers le serveur de clés est demandé lorsque
[pepsi-keys] VKS_PUBLISHest activé.registerEnregistre comme propre clé MUA de l’utilisateur la clé de l’en-tête
Autocrypt:de ce message, ou son fichier de clé joint.publish[FPR]Demande un téléversement vers le serveur de clés (et une publication sur le WKD), par défaut de la face publique. Seule une clé OpenPGP active peut être téléversée. Le téléversement lui-même est effectué par la prochaine exécution de
pepsi-keys identity publish --retry, et ne peut pas être annulé.retireFPRRévoque une clé ; c’est aussi la façon de retirer une clé MUA enregistrée par erreur. Pour une clé OpenPGP gérée par le serveur dont la moitié privée est encore détenue, un certificat de révocation signé par la clé elle-même est d’abord produit et stocké comme sa moitié publique : le Web Key Directory sert alors la clé comme révoquée au lieu de se taire, et lorsque la clé avait été téléversée vers un serveur de clés, l’exécution suivante de
pepsi-keys identity publish --retryy téléverse la révocation. La réponse indique exactement lesquelles de ces actions ont eu lieu. La propre clé MUA d’un utilisateur ne reçoit aucun certificat ici (seul le client qui la détient peut en signer un), pas plus qu’un certificat S/MIME ; la réponse indique que les correspondants qui détiennent une telle clé ne sont pas informés.pinFPRConsigne que l’utilisateur a comparé la clé d’un correspondant hors bande : chaque clé en cache active (
pepsi.peer_key) ayant exactement cette empreinte est épinglée et élevée à la sourcemanual, de sorte qu’elle est utilisée pour ce correspondant quoi que proposent les messages ultérieurs, n’est jamais délogée ni évincée par un rafraîchissement, et que ses signatures se vérifient commevalid– pour chaque utilisateur du déploiement, puisque le cache est partagé. Refusé sauf si l’adresse a un second facteur inscrit (le code figure alors dans l’objet, comme pour toute commande) et sauf si FPR est l’empreinte entière (au moins 40 chiffres hexadécimaux ; un long identifiant de clé ne suffit pas). Une clé révoquée ne peut pas être épinglée. Audité commekey.peer.pinavec l’acteurmail:<address>et la source précédente de chaque ligne ; seul l’opérateur désépingle (pepsi-keys peer unpin). L’avis de changement de clé de pepsi-stage-autocrypt-learn(1) imprime l’objet exact à envoyer.otp enrollInscrire (ou remplacer) un second facteur pour ces commandes : un secret TOTP (RFC 6238, SHA-1, six chiffres, pas de 30 secondes). La réponse le porte une seule fois – sous forme d’URI
otpauth://, en base32, et sous forme de code QR joint (second-factor.png) pour une application d’authentification – et devrait être supprimée une fois le secret dans l’application. Remplacer un facteur existant nécessite son code actuel. Le nouveau secret est stocké comme en attente (pepsi.otp_pending) : un second facteur déjà en vigueur le reste jusqu’àotp confirm. Lorsque l’adresse a des clés actives qui lui sont propres (des clés MUA, enregistrées depuis le client de l’utilisateur), la réponse est chiffrée pour elles avant d’être mise en file, non signée (le signataire d’avis transmet tel quel un avis scellé) ; sinon elle part en clair. Elle porte un en-têteExpires:(RFC 4021) à la fin deOTP_CONFIRM_WINDOW. Étant la seule copie du secret, la réponse est validée dans une même transaction avec le secret en attente qu’elle porte, et rendue (et scellée) avant l’un comme l’autre : si elle ne peut être construite ou mise en file, rien n’est stocké, tout reste tel quel, et la commande est réessayée. Audité commekey.otp.enroll(avecpendingetsealed) ; télémétrieencrypt-otp-enroll-sealedouencrypt-otp-enroll-clear.otp confirmCODEFait du secret en attente le second facteur, avec un code courant qui en est issu, dans les limites de
OTP_CONFIRM_WINDOWaprèsotp enroll(par défaut1h). Le pas de temps du code devient le plancher anti-rejeu, de sorte qu’il ne peut pas être réutilisé. Un code manquant est refusé sans être compté ; un code erroné ne compte que contre le secret en attente (jamais contre un second facteur en vigueur), et dix erreurs l’abandonnent ; un secret échu est refusé et supprimé (pepsi-queue gcsupprime le reste). La réponse rappelle de supprimer le message d’inscription. Audité commekey.otp.confirm.verifyetactivatesont acceptés pourconfirm.otp removeSupprimer le second facteur ; nécessite son code actuel.
otpseul (ouotp status) équivaut àstatus.
Avec un second facteur inscrit, chaque commande sauf status (et otp confirm, dont le code est celui du nouveau secret) doit porter le code actuel de l’application : un mot d’exactement six chiffres n’importe où dans le Subject: (register 123456 ; otp=123456 est aussi accepté). Une commande sans code est refusée et n’est pas comptée. Un code erroné, ou un code déjà utilisé (un code n’est valable qu’une fois), compte comme un échec et un code correct remet le compteur à zéro ; après dix échecs consécutifs, le second facteur est verrouillé et chaque commande sauf status est refusée jusqu’à ce que l’opérateur le réinitialise (pepsi-keys otp reset). Le secret est enveloppé sous la clé de chiffrement de clés du magasin de clés et lisible par le seul rôle pepsi-crypto ; voir pepsi-keys(1). La réponse à status indique si l’adresse en a un et s’il est verrouillé.
Une commande reçoit une seule réponse. Un message de commande dont la réponse est déjà en file (une passe antérieure l’a exécutée et a été interrompue avant de le consommer) est seulement consommé, de sorte qu’un réessai ne répète jamais une commande – en particulier ne crée jamais un second secret derrière la réponse qui porte le premier. Une commande qui échoue pour une raison propre à ce serveur reçoit une réponse générique « réessayez plus tard » ; l’erreur elle-même est dans le journal, non dans le courrier.
FPR est l’empreinte complète, ou au moins ses 16 derniers chiffres hexadécimaux (pin : l’empreinte complète), écrite en un seul mot (un préfixe 0x est accepté) ; comptant au moins 16 chiffres, elle n’est jamais confondue avec un code. list, upload et revoke sont acceptés pour status, publish et retire, et 2fa/totp pour otp ; tout autre objet reçoit en réponse la liste des clés et les commandes valides. La commande agit sur l’adresse From:, et seulement lorsque l’auteur de la soumission peut parler en son nom (voir Enregistrer la propre clé de l’utilisateur) ; sinon, et pour une adresse d’un domaine que le déploiement ne sert pas, la réponse indique que la demande a été refusée. Sans RESPONSE_STAGE, il n’y a nulle part où répondre : cette interface est alors désactivée et un tel message est transmis comme n’importe quel autre.
95.1.6.1.3.8. Choisir la clé du destinataire¶
Normalement, la clé provient du cache pepsi.peer_key, la source la mieux classée d’abord et sous réserve de MIN_TRUST — voir pepsi.conf(5) et pepsi-keydisc(1). Le rang est comparé entre les deux protocoles : PREFER ne départage qu’une clé OpenPGP et un certificat S/MIME situés sur le même échelon de l’échelle de confiance, et une clé mieux classée de l’autre protocole l’emporte toujours. La règle de conflit du magasin ne compare que des clés d’un même protocole. Avec l’ordre inverse, un seul en-tête Autocrypt: falsifié pourrait prendre le contrôle d’un correspondant dont le certificat S/MIME provient d’un annuaire, de DANE, de l’opérateur ou d’un message signé authentifié, sans événement de rotation, alors qu’un tel en-tête sur du courrier non signé n’atteint que l’échelon inbound.
Il y a une exception, et c’est une limite de sécurité plutôt qu’une optimisation. Si ce déploiement détient une identité ``active`` pour le destinataire, cette clé est utilisée et aucune ligne ``peer_key`` pour l’adresse n’est consultée — quel que soit son rang et quelle qu’ait été son arrivée. state.crypto note la source comme own.
La raison est que peer_key est en partie alimenté par la moisson du courrier entrant, qui range les clés sous l’adresse From: qu’écrit l’expéditeur. L’authentification entrante est délibérément fail-open : un message prétendant venir de l’un des propres utilisateurs de ce déploiement peut donc semer pour cet utilisateur une clé de pair contenant la clé d’un inconnu ; sans l’exception, le courrier d’un utilisateur local vers un autre serait alors chiffré vers la clé plantée et ressemblerait exactement à un succès.
La règle tient au fait de détenir une clé, non au fait de servir l’adresse. Un utilisateur qui exploite son propre client OpenPGP et n’a jamais téléversé de clé ici n’a pas d’identité, et sa vraie clé est une clé que cet hôte ne peut apprendre que par la découverte, la moisson ou le gossip — l’exception ne s’applique donc pas à lui. Voir Les clés de nos propres utilisateurs ne sont pas découvertes dans le manuel pour le compromis complet, y compris son coût : une signature faite avec la clé personnelle distincte d’un utilisateur cesse de vérifier dès qu’une identité est détenue pour cette adresse.
La même préférence s’applique aux champs de gossip ci-dessous : un sujet qui est l’un des nôtres est présenté avec la clé que nous lui avons délivrée, jamais avec une clé plantée par quelqu’un.
Une clé en cache n’est pas utilisée lorsqu’on ne peut pas lui confier le message, quel que soit son rang : une clé RSA inférieure à [pepsi] CRYPTO_MIN_RSA_BITS, un module RSA à partir duquel la moitié privée peut être calculée (ROCA, nombres premiers assez proches pour la méthode de Fermat, un petit facteur premier), ou une clé de tout type connue comme compromise — sur la liste des clés connues comme compromises pepsi.compromised_key (la liste de blocage badkeys, tenue à jour par pepsi-keys blocklist update, et les modules que le pepsi-keys peer screen quotidien a factorisés). Un tel destinataire est traité comme un destinataire sans clé utilisable et prend la voie ON_NO_KEY. De même pour un destinataire dont le certificat S/MIME en cache a été marqué revoked par pepsi-keydisc(1) – la liste de révocation de son émetteur, vérifiée contre une ancre de confiance activée, l’a nommé – ou dont la clé OpenPGP porte la révocation de son propriétaire : une clé révoquée n’est pas une clé, l’étape ne consulte aucune donnée de révocation qui lui soit propre, et la reason du destinataire indique revoked (avec l’empreinte) plutôt que « no usable key ». Une clé expirée n’est pas non plus une clé : un certificat S/MIME passé son notAfter (ou antérieur à son notBefore) et une clé OpenPGP dont l’expiration de la clé primaire est passée sont écartés avant le choix de la clé, de sorte qu’un destinataire disposant d’une clé valide de l’autre protocole reçoit celle-ci, et qu’un destinataire qui n’en a aucune prend la voie ON_NO_KEY (après une demande de découverte là où DISCOVERY le permet, c’est ainsi qu’un certificat renouvelé remplace celui qui est échu) ; la reason indique alors expired on avec la date.
95.1.6.1.3.9. Issues par destinataire¶
Par destinataire, exactement l’une de :
encryptedUne clé utilisable a été trouvée (sous réserve de
MIN_TRUST) et le message a été chiffré vers elle. Le conteneur réellement émis est noté, avec l’indication d’une éventuelle rétrogradation depuis l’AES-256-GCM par défaut et, pour S/MIME, de l’enregistrement de capacités qui l’a choisi (smime_capability:configuredoulearnt; absent lorsqu’il n’y en avait pas).signed-onlyAucune clé de destinataire utilisable, la politique autorise du courrier ordinaire, et la signature de l’auteur a été appliquée.
cleartextNi signé ni chiffré.
secure-linkAcheminé vers
SECURE_LINK_STAGEau lieu d’être envoyé.bouncedLe chiffrement était exigé et n’a pas pu être appliqué ; acheminé vers
BOUNCE_STAGEavec un statut étendu RFC 34635.7.0. Une ligne peut contenir plusieurs destinataires sans clé : chacun y va sur sa propre ligne, afin qu’un DSN rende compte de chacun d’eux et honore leNOTIFYde chaque destinataire. Le message n’est pas réécrit auparavant. SansBOUNCE_STAGE, le message est mis en échec plutôt qu’envoyé sans protection.oversizeLe message était plus grand que
MAX_SIZEet a pris la routeON_OVERSIZE.
Lorsque les destinataires d’un message ne partagent pas tous une même issue, l’étape scinde la ligne (le state.dsn.rcpt de chaque nouvelle ligne étant découpé en phase avec son rcpt_to) et rend le message à la file d’attente : chaque destinataire ayant une clé, ou dont la recherche est encore en attente, reçoit sa propre ligne, et les destinataires sans clé partagent une même ligne, puisqu’ils partagent l’issue sans clé. Chaque ligne réentre ensuite dans cette étape. Un message dont les destinataires partagent tous une même issue — le cas courant « personne n’a de clé, envoyer comme d’habitude » — n’est jamais scindé.
Chaque issue qui met du contenu non protégé sur le fil alors que le chiffrement était souhaité est journalisée en WARN et consignée par destinataire dans state. Envoyer en clair n’est jamais une issue silencieuse dans le journal ; que l”auteur en soit informé relève de NOTIFY_CLEARTEXT.
95.1.6.1.3.11. Échecs DNS des destinataires¶
Un destinataire pour lequel la découverte n’a trouvé aucune clé parce que la recherche a échoué dans le DNS n’est pas traité comme un destinataire sans clé. pepsi-keydisc(1) classe l’échec (voir sa section « Une recherche qui échoue dans le DNS ») et la demande réglée porte le verdict :
- unreachable (rien de ce qui concerne le domaine du destinataire ne répond), ou transient (ses enregistrements de clés ont échoué alors que le domaine répondait, pas encore de façon persistante)
Le message est différé : mis en pause jusqu’à ce que la recherche réglée vieillisse (environ 15 minutes), puis garé sur une nouvelle recherche.
state.encrypt_dns_deferredetstate.last_erroren disent la raison. Une fois qu’il a attendu leMAX_LIFETIMEde l’étape — plafonné à la valeur par défaut des étapes de relais de120 h, de sorte que cette étape ne retient jamais un message au-delà du point où un relais y aurait renoncé —, il rebondit avec le statut RFC 34635.4.3. Pendant qu’il attend, un expéditeur qui a demandéNOTIFY=DELAYreçoit un DSN « delayed » aprèsDELAY_DSN_AFTER(par défaut4 h), par le même mécanisme qu’utilisent les étapes de relais.- inconsistent (les MX ou A/AAAA du domaine répondent alors que ses enregistrements de clés ont échoué lors de trois tours consécutifs à moins d’une heure d’intervalle)
C’est ce que provoquerait un attaquant qui supprime la clé du destinataire ; le message est donc acheminé vers
SECURE_LINK_STAGElorsqu’une telle étape est configurée, et rebondi (5.7.0) sinon. L’expéditeur est informé de la raison et de la manière de passer outre : dans le diagnostic du rebond ou, sur la voie du portail, dans un avis à expéditeur nul injecté àRESPONSE_STAGE. SansRESPONSE_STAGE, cet avis n’est pas envoyé, et un avertissement est journalisé.
Cela ne s’applique que là où la voie sans clé aurait sinon été le clair (ENCRYPT = opportunistic avec ON_NO_KEY = cleartext) : ENCRYPT = required, un mot-clé [secure]/[encrypt] et un ON_NO_KEY qui refuse déjà le clair ne sont pas concernés. Cela ne s’applique pas lorsque la découverte est désactivée pour le message (DISCOVERY = no, ou un domaine exclu par ALLOW_DOMAINS/DENY_DOMAINS), puisque rien ne redemanderait jamais.
La dérogation. Un expéditeur local qui accepte que le message voyage non chiffré met [clear-ok] (SUBJECT_KEYWORDS_CLEAR_OK) dans le Subject ; comme [secure], il est retiré avant l’envoi et n’est honoré que pour le courrier state.local_origin. CLEAR_ON_DNS_FAILURE = yes dit la même chose sous forme de réglage permanent, normalement donné par expéditeur via pepsi.settings. Ni l’un ni l’autre n’affaiblit ENCRYPT = required, et un destinataire qui a une clé reçoit tout de même un message chiffré.
Ce qui reste : sans DNSSEC sur la zone du destinataire, un NXDOMAIN ou une réponse vide falsifiés sont indiscernables d’un vrai « pas d’enregistrement », et se lisent encore « pas de clé ».
95.1.6.1.3.12. Annonce de clé Autocrypt¶
À moins que AUTOCRYPT ne soit désactivé, chaque message soumis localement quitte cette étape en portant un en-tête Autocrypt: annonçant la clé OpenPGP propre à l’auteur du From:
Autocrypt: addr=alice@example.org; prefer-encrypt=mutual;
keydata=xjMEZ8kAABYJKwYBBAHaRw8BAQdA…
Cela se produit sur chaque message — signé, chiffré, acheminé vers le lien sécurisé ou en clair. Le cas du passage tel quel est celui qui compte : un correspondant doit pouvoir apprendre la clé depuis du courrier ordinaire, car tant qu’il ne l’a pas, il n’y a rien avec quoi chiffrer. N’annoncer que sur du courrier déjà protégé dirait la clé exactement à ceux qui la connaissent déjà.
La clé annoncée est la clé publique transférable minimale d’Autocrypt Level 1 §2.1.1 — clé primaire, identifiant utilisateur primaire, son auto-signature, une sous-clé de chiffrement de transport et sa signature de liaison, et rien d’autre. Les identifiants utilisateur supplémentaires, la sous-clé de signature et toute certification tierce sont retirés : l’en-tête part avec chaque message, sa taille est donc payée encore et encore, et republier des certifications publierait le graphe social de l’expéditeur comme effet de bord de l’envoi de courrier.
Cinq règles le bornent :
OpenPGP uniquement. Autocrypt est défini sur une clé publique transférable OpenPGP et n’a pas de forme S/MIME : un expéditeur ne détenant qu’une identité X.509 n’annonce donc rien.
Uniquement du courrier soumis localement, comme tout le reste de ce que fait cette étape.
Jamais par-dessus un en-tête existant. Un véritable client (Thunderbird, K-9, Delta Chat) peut avoir posé son propre champ
Autocrypt:nommant la clé dont il détient la moitié secrète. Celui-là vaut mieux que le nôtre et est laissé tranquille — et un second champ serait pire qu’inutile, car Autocrypt Level 1 écarte purement et simplement un message qui en porte deux.La clé doit encore être ouvrable ici. Seule une identité qui détient encore son matériel privé est annoncée : le chiffré envoyé vers une clé annoncée est donc toujours du chiffré que pepsi-stage-decrypt(1) peut ouvrir.
Seulement la face publique. Lorsque l’utilisateur a enregistré sa propre clé de MUA, c’est elle la face publique et Pepsi n’annonce rien ; le client de messagerie annonce lui-même sa clé. Un message que le client a déjà chiffré ne reçoit pas non plus d’en-tête.
prefer-encrypt=mutual n’est émis que lorsque l”ENCRYPT effectif de l’étape vaut required — y compris lorsque cela vient d’une redéfinition pepsi.settings par adresse, de sorte qu’un utilisateur puisse l’annoncer sans que le déploiement le fasse. Selon Autocrypt Level 1 §2.4, le client d’un correspondant n’active le chiffrement par défaut que lorsque les deux extrémités disent mutual ; le revendiquer sous opportunistic, où ON_NO_KEY = cleartext dit que le texte clair est une issue acceptable, annoncerait une préférence que ce déploiement n’applique pas. L’attribut est alors omis, ce que le Level 1 lit comme nopreference : le correspondant note tout de même la clé et se voit toujours proposer le chiffrement, simplement pas par défaut. La valeur suit le mode configuré plutôt que celui résolu pour un message isolé, de sorte qu’un mot-clé d’objet [secure] ne fasse pas osciller l’état de clé d’un correspondant au gré des lignes d’objet de nos utilisateurs.
Comme cette étape s’exécute avant pepsi-stage-dkim-sign(1), l’en-tête est couvert par la signature DKIM propre au déploiement.
95.1.6.1.3.13. Gossip de clés Autocrypt¶
AUTOCRYPT_GOSSIP (NO par défaut) active l’autre moitié d’Autocrypt Level 1 : des champs Autocrypt-Gossip: annonçant les clés des autres destinataires. Ils couvrent un cas que l’en-tête ci-dessus ne peut pas couvrir. Alice écrit à Bob et Carol, qui n’ont jamais correspondu. Tous deux apprennent la clé d’Alice depuis son en-tête Autocrypt:, mais aucun n’apprend celle de l’autre — de sorte que la réponse à tous de Bob ne peut pas être chiffrée vers Carol tant qu’un message ultérieur ne les présente pas par hasard. Un message avec gossip comble cette lacune
Autocrypt-Gossip: addr=carol@example.org;
keydata=xjMEZ8kAABYJKwYBBAHaRw8BAQdA…
C’est désactivé par défaut parce que c’est un acte d’une autre nature qu”AUTOCRYPT : celui-ci publie une clé que son propriétaire a demandé à ce déploiement de détenir, tandis que celui-là redistribue le matériel de clé de tiers — mis en cache ici pour notre propre usage — à des correspondants qui ne l’ont jamais demandé. C’est la décision d’un opérateur.
Trois règles découlent de la spécification, et une de la forme propre à cette étape.
Uniquement à l’intérieur d’un chiffré. Le Level 1 §5.3 place ces champs dans la section d’en-têtes de la partie chiffrée, et pas par coquetterie : un champ
Autocrypt-Gossip:extérieur publierait l’ensemble des destinataires d’un message chiffré à chaque relais du chemin, ce qui est l’essentiel de ce pour quoi le chiffrement existait. Il n’y a donc pas de gossip sur le passage en clair, aucun sur un message seulement signé, et aucun dans un conteneur S/MIME — Autocrypt est défini sur OpenPGP et n’a pas de forme S/MIME, de sorte qu’un champ de gossip y serait une redistribution vers un endroit où aucun client ne regarde.Plusieurs sont attendus. Un champ par destinataire présenté, dans l’ordre
To:/Cc:— l’inverse d”Autocrypt:, où un second champ fait écarter le message par un analyseur Level 1.Pas de ``prefer-encrypt``. L’attribut énonce la politique de l”expéditeur, et ces champs parlent pour quelqu’un d’autre. En affirmer un au nom d’un correspondant est une affirmation que ce déploiement n’a pas qualité à faire, et le Level 1 l’exclut de la forme gossip pour la même raison.
Une clé en cache ou rien. Un destinataire visible pour lequel ce déploiement ne détient aucune clé OpenPGP utilisable est laissé hors de l’ensemble. L’étape n’effectue aucune découverte pour son compte et ne met jamais un message en pause pour aller chercher la clé d’un tiers : une présentation est une courtoisie, et retarder le courrier de l’expéditeur pour en faire une n’en serait pas une. Le plancher est le plus strict de
MIN_TRUSTet deGOSSIP_MIN_TRUST(par défautowner-confirmed) : une clé qui n’aurait pas été assez bonne pour chiffrer vers elle n’est pas assez bonne pour être transmise non plus, et par défaut une clé que ce déploiement a simplement moissonnée depuis du courrier entrant, ou qui lui a elle-même été gossipée, n’est pas republiée du tout. Présenter à un correspondant une clé dont personne ne s’est porté garant est une affirmation plus forte que de l’employer soi-même.
Avertissement
Une copie carbone invisible n’est jamais gossipée. Les adresses des sujets proviennent des champs To: et Cc: analysés du message et de nulle part ailleurs. La liste des destinataires d’enveloppe n’est consultée que pour retirer une adresse de l’ensemble (le destinataire propre de cette copie, et l’auteur du From:), bien qu’elle contienne bel et bien les destinataires en Bcc : c’est tout le sens d’une copie invisible.
Un destinataire en Bcc ne peut donc apparaître dans aucune copie du message, et la garantie ne dépend pas d’un champ Bcc: retiré en amont : le champ n’est pas lu du tout. Le Level 1 §5.3 exige la même chose d’un client récepteur, qui ignore un en-tête de gossip dont l”addr n’est pas un destinataire To:/Cc: — un tel en-tête divulguerait donc l’adresse sans rien accomplir.
L’inverse est délibéré. La copie propre d’un destinataire invisible porte bel et bien du gossip sur les destinataires To:/Cc: : il a reçu ces champs d’en-tête comme tout le monde, cela ne lui apprend donc rien qu’il ne puisse déjà lire, et le lui refuser casserait la réponse à tous précisément pour le destinataire le moins susceptible d’avoir correspondu avec les autres auparavant.
Un message comptant plus de 50 destinataires visibles ne reçoit aucun gossip. Chaque clé présentée est répétée dans le texte chiffré propre de chaque destinataire : le coût croît donc avec le carré du nombre d’adresses, et à cette taille le message est une diffusion à laquelle personne ne répondra à tous. En présenter cinquante arbitraires serait un choix silencieux sans règle défendable derrière lui : l’étape n’en présente donc aucun et le dit dans le journal.
95.1.6.1.3.14. Négociation de l’algorithme de contenu¶
Pour OpenPGP, le certificat du destinataire indique s’il sait lire le SEIPDv2/AEAD de la RFC 9580 ; la majeure partie du parc installé (GnuPG 2.4 et antérieurs) ne le sait pas. Sous [pepsi] CRYPTO_ALLOW_DOWNGRADE = negotiate (la valeur par défaut), l’étape n’émet du SEIPDv1+MDC que lorsque la clé propre du destinataire prouve qu’il ne peut pas faire mieux, le journalise en INFO et le note — une rétrogradation est un fait sur le correspondant, non un échec. Sous no, le même destinataire est refusé et tombe dans ON_NO_KEY ; voir la mise en garde sous cette option.
Un certificat X.509 n’annonce aucune capacité de chiffrement de contenu ; pour S/MIME, l’étape négocie donc plutôt en fonction de l”enregistrement des capacités S/MIME du destinataire (table pepsi.smime_capability) : appris par pepsi-stage-autocrypt-learn(1) à partir de l’attribut SMIMECapabilities RFC 8551 du propre courrier signé du correspondant, indexé sur le certificat qui l’a signé, ou configuré par l’opérateur avec pepsi-keys peer capability set ADDRESS aead|cbc (aussi *@domain ; un enregistrement configuré l’emporte sur un enregistrement appris). Sous negotiate, un destinataire dont l’enregistrement dit qu’il ne sait pas lire l’AEAD reçoit de l”EnvelopedData AES-256-CBC ; tout autre destinataire — y compris un destinataire sans enregistrement — reçoit de l”AuthEnvelopedData RFC 5083 (AES-256-GCM). Sous no, le destinataire consigné est refusé et tombe dans ON_NO_KEY ; sous yes, chaque destinataire S/MIME reçoit de l”EnvelopedData, quel que soit son enregistrement.
Dérivation de clé RFC 9709. L’identifiant d’algorithme de chiffrement de contenu d’un message CMS n’est pas authentifié, de sorte que le RecipientInfo d’un message AES-GCM peut être resoumis sous un conteneur AES-CBC synthétique qui s’ouvre avec la même clé de contenu. Un destinataire dont l’enregistrement appris dit que ses propres SMIMECapabilities signées nomment id-alg-cek-hkdf-sha256 reçoit un message dont la clé de contenu est dérivée de la clé remise avec HKDF-SHA256 sur l’identifiant d’algorithme réel, dans l’un ou l’autre conteneur, ce qui lie l’algorithme (et son nonce ou son IV) à la clé. Chaque certificat pour lequel le message est scellé doit avoir fait cette déclaration ; un enregistrement configuré ne l’active jamais, puisqu’un client qui ne connaît pas l’identifiant ne peut pas du tout lire le message. La ligne du destinataire dans state.crypto.out.recipients porte alors cek_hkdf: true (absent sinon ; télémétrie encrypt-cek-hkdf). Les propres signatures S/MIME de Pepsi annoncent AES-256-GCM, AES-256-CBC et id-alg-cek-hkdf-sha256, de sorte que le client d’un correspondant — un autre Pepsi avant tout — apprend les trois.
Thunderbird 140.12.0esr ne sait pas lire l”AuthEnvelopedData et échoue silencieusement (le destinataire voit un message vide). Un correspondant Thunderbird qui nous a envoyé un message signé est appris automatiquement, puisque NSS ne liste pas AES-GCM parmi ses capacités ; un utilisateur de Thunderbird qui n’a jamais envoyé de message signé est informé une fois, avec le premier message, de la marche à suivre (ci-dessous) — ou l’opérateur configure l’enregistrement (pepsi-keys peer capability set ADDRESS cbc). Voir pepsi.conf(5) et pepsi-keys(1).
95.1.6.1.3.15. L’avis du premier message¶
Un destinataire sans enregistrement reçoit le conteneur authentifié sur une supposition, et le client qui ne sait pas le lire échoue sans erreur. Le premier message S/MIME chiffré pour un certificat sans enregistrement de capacités porte donc un court avis en clair en dehors du texte chiffré : le message devient un multipart/mixed composé d’une partie text/plain suivie de la partie application/pkcs7-mime, sous les propres champs d’en-tête du message. L’avis indique que le message est protégé par un conteneur S/MIME authentifié, qu’un message vide ou illisible doit être signalé à l’expéditeur, et qu’une réponse signée avec le certificat du destinataire permet à ce serveur d’apprendre ce que lit son client. Il ne dit rien du message, et le texte chiffré est octet pour octet ce qu’il aurait été sans lui : un destinataire qui ouvre la partie pkcs7-mime obtient le message original, et pepsi-stage-decrypt(1) garde le texte chiffré comme message et déplace l’avis dans une pièce jointe inerte, comme il le fait de tout contenu situé à côté d’un texte chiffré.
L’avis est envoyé une fois par certificat : smime_capability reçoit une ligne pour l’empreinte du certificat avec notice_sent_at défini et aucune capacité (pepsi-keys peer capability list l’affiche comme notice), et un enregistrement appris ou configuré met définitivement fin aux avis — la déclaration apprise remplace la ligne d’avis quelle que soit la date de la signature. La ligne est écrite juste avant la validation du message, de sorte qu’un plantage entre les deux envoie le message réessayé sans l’avis plutôt que de l’envoyer deux fois. La ligne du destinataire dans state.crypto.out.recipients porte aead_notice: true lorsque l’avis est parti (absent sinon).
Le texte est le modèle smime-aead-notice.<lang>.body sous [pepsi] TEMPLATE_DIR (dix langues sont livrées), choisi comme les autres avis de cette étape d’après la langue détectée du message (state.language), l’anglais en dernier. Un déploiement dont le répertoire de modèles en est dépourvu envoie le message sans l’avis et avertit ; rien n’est consigné, de sorte que le message suivant réessaie. Qu’un client qui sait lire l”AuthEnvelopedData l’ouvre aussi lorsque la partie pkcs7-mime n’est pas l’entité de premier niveau n’a été vérifié que pour OpenSSL et pour pepsi-stage-decrypt(1) ; c’est aussi pour cette raison que l’avis accompagne un seul message par certificat.
95.1.6.1.3.16. Remplissage de longueur¶
Le chiffrement cache ce que dit un message, non sa longueur, et une longueur suffit souvent pour dire lequel de quelques documents connus a été envoyé. Sous PADDING (activé par défaut), chaque message que chiffre cette étape est rempli jusqu’à une longueur Padmé : arrondie vers le haut de sorte que seuls les bits de poids fort de son exposant binaire subsistent, ce qui laisse fuir O(log log M) bits sur une longueur inférieure à M pour un surcoût d’au plus 12 % (Nikitin et al., PETS 2019).
OpenPGP SEIPDv2 : un paquet de remplissage RFC 9580 (type 21) à l’intérieur du chiffrement, écrit après la signature, de sorte qu’il n’est ni visible ni signé.
OpenPGP SEIPDv1 et S/MIME : aucun des deux n’a de remplissage que tout lecteur ignore ; l’entité MIME chiffrée porte donc un champ d’en-tête de bourrage
Pepsi-Padding:, replié à 78 octets. Un lecteur ignore un champ d’en-tête qu’il ne connaît pas ; les propres étapes de déchiffrement de Pepsi ne conservent que les champsContent-*d’une entité, de sorte qu’il n’atteint jamais une boîte aux lettres par Pepsi.
Aucun des deux chiffrements de contenu ne compresse, de sorte que le bourrage coûte exactement sa taille. L’identifiant de clé du destinataire reste en clair dans chaque copie, ce qui ne nomme que le destinataire que nomme sa propre enveloppe : l’étape scinde un message en un destinataire par ligne avant de chiffrer. pepsi-stage-reencrypt(1) ne remplit pas la copie qu’il scelle pour la propre boîte aux lettres d’un utilisateur.
95.1.6.1.3.17. Protection des en-têtes¶
Avec PROTECT_HEADERS = yes, l’entité protégée (la partie signée, ou le texte en clair à l’intérieur du texte chiffré) porte un paramètre protected-headers="v1" et des copies verbatim de From, Sender, To, Cc, Reply-To, Subject, Date, Message-ID, In-Reply-To et References (en-têtes injectés de RFC 9788 ; Bcc n’est jamais copié), et, sur un message chiffré, le Subject extérieur est remplacé par .... Un message seulement signé garde son Subject extérieur : il ne cache rien à quiconque peut le lire, et RFC 9788 n’applique la confidentialité des en-têtes qu’aux messages chiffrés. Les champs extérieurs sont copiés, non déplacés, de sorte que DKIM, le regroupement en fils et la génération de DSN conservent ce dont ils ont besoin. Un destinataire tel que pepsi-stage-decrypt(1) peut alors comparer le From: protégé à celui de l’extérieur et refuser son verdict valid à un message signé renvoyé sous un autre auteur, et les To: et Cc: protégés placent les destinataires à l’intérieur d’une signature S/MIME pour un client qui ne lit pas l’attribut de destinataire propre à Pepsi. L’option est désactivée par défaut, parce qu’un client qui ne rend pas les en-têtes protégés affiche ... comme objet de chaque message chiffré ; PROTECT_HEADERS = yes s’adresse à une population dont les clients le font.
95.1.6.1.4. Signature des propres avis de Pepsi¶
Les messages que Pepsi compose lui-même — liens de connexion à la console, notifications et accusés du portail de lien sécurisé, défis du secrétaire, demandes de paiement, réponses aux commandes de clés, de paramètres et de wallet, avis de changement de clé et réponses d’absence — portent une signature DKIM alignée et rien d’autre, que vérifie le fournisseur d’un destinataire et que son client ne voit jamais. Avec NOTICE_SIGNER réglé sur l’adresse d’une identité du magasin de clés, une instance de ce programme les signe tous avec cette identité, en OpenPGP ou en S/MIME (le premier protocole de PREFER que possède l’identité), avec la protection des en-têtes de PROTECT_HEADERS, de sorte qu’un client qui vérifie les signatures puisse distinguer un avis authentique d’un avis falsifié. La forme habituelle est une seconde instance entre les émetteurs d’avis et la signature
[stage-notice]
PROGRAM = pepsi-stage-encrypt
NEXT_STAGE = dkim-sign
NOTICE_SIGNER = notices@example.org
avec chaque RESPONSE_STAGE, BLOCK_RESPONSE_STAGE, [pepsi-admin] ENROL_STAGE et [pepsi-secure-link] NOTIFY_STAGE pointant vers elle (--wizard de pepsi-setup(1) l’écrit avec NOTICE_SIGNER en commentaire). Créez d’abord l’identité, dans un domaine servi afin que le Web Key Directory la publie
pepsi-keys identity generate notices@example.org --protocol openpgp --name "example.org notices"
Ce qui est signé est décidé par le message, non par l’étape : seule une ligne dont la marque state.notice a été posée par le composant qui l’a composée (voir pepsi.state(7)) est signée, et elle est seulement signée, jamais chiffrée, même pour un destinataire dont la clé est en cache. Toute autre ligne prend le chemin ordinaire de l’étape, qui pour le courrier sans state.local_origin se limite à l’hygiène des en-têtes. Un avis à un tiers (demande de paiement, défi du secrétaire, réponse d’absence) n’est pas marqué tant qu’une redéfinition par adresse s’applique au message qui l’a provoqué, parce qu’une redéfinition peut en changer la formulation ; les réponses du portail, le courrier de liste, les résumés, les rebonds et les rapports TLS ne sont jamais marqués. NOTICE_SIGNER est lu dans le seul fichier de configuration, jamais via pepsi.settings, de sorte que le destinataire d’un avis de changement de clé ne peut pas nommer la clé qui le signe.
Un signataire configuré n’est jamais sauté : une identité manquante, un magasin de clés illisible ou une signature échouée est une erreur sur laquelle le message est réessayé (avec le back-off habituel de l’étape), non un avis envoyé non signé, et le worker refuse de démarrer lorsque NOTICE_SIGNER est défini sans [pepsi-crypto] KEY_WRAP_SECRET. Un avis signé est envoyé depuis le signataire : un vérificateur rattache une signature à l’adresse From: (RFC 8551 §3.1 ; pepsi-stage-decrypt(1) signale une discordance comme identity-mismatch), et les avis proviennent de nombreuses adresses qu’une seule identité ne peut pas nommer. Avant la signature, l’étape remplace donc From: par <NOTICE_SIGNER> et conserve la valeur précédente comme Reply-To: sauf si l’avis en a défini un, de sorte qu’une réponse atteint qui elle atteignait auparavant ; le From: protégé à l’intérieur de la signature est lui aussi le signataire. Clé de télémétrie encrypt-notice-sign.
95.1.6.1.5. Configuration¶
L’étape lit sa propre section [stage-<name>] (PROGRAM = pepsi-stage-encrypt, un NEXT_STAGE obligatoire — chacune des issues de cette étape est un saut vers l’avant — et BOUNCE_STAGE, que pepsi-setup(1) exige à son tour dès que ON_NO_KEY/ON_OVERSIZE se résout en bounce, 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_*, STRIP_REQUEST_HEADERS, PROTECT_HEADERS, AUTOCRYPT, AUTOCRYPT_GOSSIP, GOSSIP_MIN_TRUST, MAX_SIZE, SECURE_LINK_STAGE, DISCOVERY, DISCOVERY_TIMEOUT, CLEAR_ON_DNS_FAILURE, DELAY_DSN_AFTER, NOTICE_SIGNER, NOTIFY_CLEARTEXT), toutes documentées dans pepsi.conf(5). Ce sont des options de comportement, redéfinissables par adresse via la table pepsi.settings — sauf NOTICE_SIGNER, qui est lu dans le seul fichier de configuration.
La politique cryptographique — choix des algorithmes, permission de rétrogradation, acceptation des condensats faibles, tailles de clé minimales — réside dans les options CRYPTO_* de [pepsi] et dans [pepsi-crypto]. Elles relèvent du seul administrateur système et ne sont délibérément pas accessibles depuis pepsi.settings ni pepsi-stage-edit-settings(1).
95.1.6.1.6. Privilège¶
Le binaire est installé setuid pepsi-crypto, mode 4750 pepsi-crypto:pepsi, et n’est donc pas plié dans le binaire multi-appel pepsi unifié.
Les deux moitiés de la limite de garde des clés reposent sur cette identité. Le rôle de base de données pepsi-crypto est le seul à qui crypto_identity.private_wrapped est accordé, et l’authentification par pair de PostgreSQL se fonde sur l”uid effectif ; la clé de chiffrement de clés réside dans secrets.d/pepsi-crypto.secret, mode 0640, appartenant au même compte. Un binaire setgid gagnerait le groupe — de quoi lire le fragment — et s’authentifierait tout de même auprès de la base de données en tant que pepsi, précisément le rôle à qui la colonne est refusée.
Le groupe dans le mode restreint l’exécution au compte du dispatcher et à root ; le programme refuse en outre de s’exécuter si son uid réel n’est ni root ni l’un des comptes pepsi, pepsi-crypto et pepsi-owner. Cette vérification à l’exécution ne s’applique que lorsque le binaire porte réellement le bit setuid — un build installé sans lui (un arbre de développement, cargo test) laisse n’importe qui l’exécuter, au motif qu’un tel appelant atteint la base de données en son propre nom et que les droits de PostgreSQL font alors autorité. -c est accepté de ces appelants (la forme de lancement documentée du dispatcher est PROGRAM -c cfg worker) et l’environnement est assaini avant le chargement de la configuration, car la couche de configuration est pilotable par XDG_CONFIG_HOME, HOME, PATH et la famille PG*.
95.1.6.1.7. État¶
Entrées : state.local_origin (la barrière), state.notice (la marque d’un message que Pepsi a composé lui-même, signé sous NOTICE_SIGNER), state.dsn (honoré et découpé en parallèle de toute scission de destinataires), state.origin.auth_method et state.origin.from_bound (si l’auteur de la soumission peut parler au nom de l’adresse From:, pour l’enregistrement de clés et les commandes de clés par e-mail).
Sorties : state.crypto.out — si le message a été signé, par quelle identité, et une entrée par destinataire portant l’issue, le protocole, l’empreinte, la source de clé, le rang de confiance, l’algorithme de contenu et l’indicateur de rétrogradation (et, pour S/MIME, la source de l’enregistrement de capacités qui a choisi le conteneur). Un destinataire local qui a enregistré plusieurs clés MUA (identity import de pepsi-keys(1), la commande register, son propre en-tête Autocrypt:) reçoit un chiffrement pour toutes, dans le même protocole que la plus récente, au plus huit : l’entrée les liste alors sous fingerprints (la face publique d’abord), et sous skipped celles des autres que la politique a refusées (compromises, trop courtes), qui sont écartées seules plutôt que d’envoyer le message en clair ; key_attached = true lorsque la clé de l’expéditeur est partie sous forme de fichier, et client_protected = true lorsque le client à l’origine de la soumission avait déjà chiffré le message et que l’étape n’y a pas touché. Également state.encrypted = true lorsque le message d’un destinataire a été chiffré, que lit pepsi-stage-auto-whitelist(1). Tant qu’un message est différé pour un échec DNS d’un destinataire, state.encrypt_dns_deferred = true et state.last_error (plus state.delay_sent une fois qu’un DSN de délai est parti). Sur un rebond, state.bounce. La disposition de l’état est décrite dans pepsi.state(7).
Transitions : NEXT_STAGE pour un message envoyé (chiffré, seulement signé ou en clair) ; SECURE_LINK_STAGE ou BOUNCE_STAGE pour un destinataire qui n’a pas pu être protégé ; paused pendant l’attente de la découverte de clés ou pendant un report dû à un échec DNS d’un destinataire ; pending à cette même étape après une scission de destinataires. Une commande de clé adressée à l’adresse de contrôle est supprimée (finish) une fois sa réponse injectée à RESPONSE_STAGE ; les avis d’enregistrement de clé y sont injectés aussi, comme nouveaux messages à expéditeur nul.
95.1.6.1.8. Commandes¶
- worker
Exécuté comme worker persistant du dispatcher, lisant les identifiants de message sur l’entrée standard et écrivant une ligne de statut par message. C’est le seul mode ; il n’y a pas de forme ponctuelle. Pour traiter un seul message à la main, envoyez son identifiant dans un tube
echo 1234 | pepsi-stage-encrypt -c /etc/pepsi/pepsi.conf worker
95.1.6.1.9. Sécurité¶
Les mécanismes que met en œuvre cette étape sont décrits dans le chapitre Sécurité du manuel de Pepsi : « The private-key custody boundary » (pourquoi le binaire est setuid pepsi-crypto), « A second factor for key management » (les commandes otp), « Who a signed and encrypted message was for » (l’Intended Recipient Fingerprint), « Protected headers against the outer ones », « Which S/MIME container a correspondent gets », « A key lookup that fails in the DNS » et « Signed notices ». Le chapitre Modèle de menace énonce ce qu’ils revendiquent : « End-to-end encryption: two custody modes », « Keys of correspondents » et « Forged notices ». Un risque résiduel y est documenté plutôt que combattu : l’étape signe au nom du From: de la ligne de file, que n’importe quelle étape pepsi peut réécrire après que l’ingress a appliqué les adresses de l’expéditeur, de sorte que la séparation de garde protège contre la divulgation d’une clé, non contre son utilisation.
95.1.6.1.10. Code de sortie¶
- 0
Le worker s’est terminé proprement (entrée standard fermée).
- 1
Une erreur s’est produite (mauvaise configuration, magasin de clés illisible, ou erreur de base de données). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer : sa configuration ou son trousseau ne fonctionne pas. Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.
95.1.6.1.11. Voir aussi¶
pepsi-stage-dkim-sign(1), pepsi-stage-srs(1), pepsi-keys(1), pepsi-keydisc(1), pepsi-stage-auto-whitelist(1), pepsi-stage-bounce(1), pepsi-dispatch(1), pepsi-setup(1), pepsi.conf(5), pepsi.state(7)
95.1.6.1.12. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.