64. pepsi-stage-vks-confirm

Dem Link zur Adressverifikation eines Keyservers folgen, und sonst nichts.

64.1. Rolle

Ein auf einen verifizierenden Keyserver hochgeladener Schlüssel wird gespeichert, ist aber nicht über die Adresse auffindbar, bis jemand einem Link in einer Mail folgt, die der Server an diese Adresse sendet. pepsi-stage-vks-confirm tut das auf dem eingehenden Pfad, sodass die Schlüsselveröffentlichung abgeschlossen wird, ohne dass ein Mensch das Postfach jedes Benutzers liest.

Es ist ein eigenes Programm, weil es in eingehender Mail gefundene URLs abruft. Das ist ein gefährliches Primitiv; in einer eigenen kleinen, unprivilegierten Stage bleibt es den Programmen fern, die Schlüsselmaterial halten oder feindliches Chiffrat parsen, und seine Position in der Pipeline bleibt in der Konfiguration sichtbar. Referenz: pepsi-stage-vks-confirm(1).

Alles, worauf es nicht reagiert — nahezu die gesamte Mail —, wird unberührt zu NEXT_STAGE weitergeschaltet, sodass die Platzierung nachsichtig ist.

64.2. Was es verweigert

Jede einzelne dieser Bedingungen muss gelten, bevor ein Byte abgerufen wird. Schlägt eine davon fehl, wird die Nachricht stattdessen zugestellt, und der Benutzer kann den Link selbst anklicken; deshalb dürfen die Bedingungen derart streng sein.

  • Die Domain des Umschlagabsenders ist genau VKS_HOST, keine Subdomain, kein Suffix-Treffer und nicht der From:-Header.

  • SPF oder DMARC bestanden (sofern nicht REQUIRE_AUTHENTICATION = no). Ein MAIL FROM ist eine Behauptung; erst dies macht daraus einen Beleg. dkim=pass zählt bewusst nicht: Es sagt, dass eine Signatur verifiziert wurde, aber nicht, wessen Signatur es war.

  • Jeder Link ist https auf genau diesen Host, am Standardport. Nennt eine Nachricht irgendeinen anderen Host, verweigert die Stage die ganze Nachricht, statt nur den fremden Link zu überspringen: Eine echte Verifikationsmail verlinkt auf den Keyserver und sonst nirgendwohin. Der Host wird nach etwaigen Userinfo-Angaben gelesen, denn https://keys.example.org@evil.test/ ist eine Anfrage an evil.test.

  • Ein Empfänger ist eine Adresse, auf die wir tatsächlich warten — veröffentlicht, hochgeladen, noch nicht verifiziert. Eine unaufgeforderte Verifikationsmail wird zugestellt, nicht angeklickt, und das ist zugleich das, was einen Fremden davon abhält, Pepsi durch Mail an eine bediente Adresse Anfragen ausführen zu lassen.

  • Die Mail nennt den Schlüssel-Fingerabdruck dieser Identität, geprüft, bevor irgendetwas abgerufen wird. Eine Bestätigung für einen Schlüssel, den jemand anderes unter der Adresse unseres Benutzers hochgeladen hat, wird zugestellt, nicht angeklickt.

  • Höchstens MAX_LINKS je Nachricht, abgerufen über denselben gehärteten Client, den die Schlüsselentdeckung verwendet: nur HTTPS, verifizierte Zertifikate (gegen [pepsi-keydiscovery] TLS_CA_BUNDLE statt der System-Wurzeln, wenn es gesetzt ist), die aufgelöste Adresse gegen den SSRF-Schutz geprüft, der Nachrichtentext während des Streamens gedeckelt, höchstens eine Weiterleitung zum selben Host. Siehe SSRF bei der Schlüsselentdeckung und Zertifizierungsstellen für die Schlüsselentdeckung.

64.3. Die Bestätigung wird verifiziert, nicht angenommen

Ein 200 auf den Link ist die Antwort des Servers auf eine Anfrage, keine Aussage, dass die Adresse jetzt veröffentlicht ist. Die Stage fragt daher den Keyserver, ob er unseren Schlüssel für die Adresse ausliefert, und nur eine Fingerabdruck-Übereinstimmung hält die Identität als verifiziert fest. Sie schon beim 200 zu markieren würde die Wiederholungsaufgabe von pepsi-keys daran hindern, es je wieder zu versuchen. Dieselbe Prüfung entscheidet über das Schicksal der Mail: Sie wird nur verworfen (DISCARD_CONFIRMED), wenn mindestens eine Identität verifiziert wurde, und andernfalls zugestellt, sodass eine Bestätigung, die nicht gewirkt hat, noch von Hand abgeschlossen werden kann. Liefert der Keyserver für die Adresse einen anderen Schlüssel aus (den hochgeladenen und bestätigten Schlüssel eines anderen), protokolliert die Stage das auf warn, mit der Adresse, dem Server, dem dort ausgelieferten Fingerabdruck und dem von dieser Site veröffentlichten. Dieser Schlüssel muss dann beim Keyserver entfernt werden, und es muss ermittelt werden, wer die Bestätigungsmail lesen konnte.

Jede Entscheidung und jeder Abruf wird auf info im Ziel vks-confirm protokolliert (der Fund eines anderen Schlüssels auf warn), und das ist der Prüfpfad.

64.4. Konfiguration

[stage-<name>]: PROGRAM = pepsi-stage-vks-confirm, NEXT_STAGE (erforderlich — siehe oben), VKS_HOST (Standardwert ist der Host von [pepsi-keys] VKS_SERVER; pepsi-setup weist einen Wert ab, der einen anderen Host benennt, da die Stage dann jede Bestätigung ignorieren würde), MAX_LINKS (3), DISCARD_CONFIRMED (yes: Eine Bestätigungsmail, die eine Identität verifiziert hat, ist maschinelle Mail über eine Aktion, die Pepsi vorgenommen hat) und REQUIRE_AUTHENTICATION (yes). Siehe pepsi-stage-vks-confirm(1).

64.5. State

  • Eingaben: state.auth.spf / state.auth.dmarc, der Umschlagabsender und der Nachrichtentext.

  • Ausgaben: keine. Die Stage schreibt nie in state und schreibt die Nachricht nie um; was sie ändert, ist die Veröffentlichungsbuchführung des Schlüsselspeichers. Eine Bestätigungsmail, die eine Identität verifiziert hat, wird unter DISCARD_CONFIRMED gelöscht; jede andere Nachricht schaltet zu NEXT_STAGE weiter.

64.6. Siehe auch

Schlüsselverwaltung, pepsi-keys, pepsi-httpd, pepsi-keydisc, Sicherheitsmodell, pepsi-stage-vks-confirm(1).