73. pepsi-dkim

Hält die DKIM- und ARC-Signaturschlüssel, signiert für die Pipeline, rotiert die Schlüssel und sagt, welche DNS-Einträge sie brauchen.

73.1. Rolle

pepsi-dkim serve ist ein langlebiger Dienst (pepsi-dkim.service), der unter einem eigenen Konto läuft, pepsi-dkim. Er allein hält die privaten Schlüssel jeder signierenden Domain, als 0600-Dateien in seinem 0700-Zustandsverzeichnis /var/lib/pepsi-dkim. pepsi-stage-dkim-sign und pepsi-stage-arc hashen den Nachrichtentext und bauen die Signaturfelder selbst, senden den kanonisierten Header-Block über den Socket /run/pepsi-dkim/sign.sock (Gruppe pepsi) und setzen den Signaturwert, den der Daemon zurückgibt, in das Feld ein. Referenz: pepsi-dkim(1).

73.2. Warum ein Daemon

Die Stages laufen als pepsi, das Konto, das sich alle gewöhnlichen Stages teilen. Könnten diese Stages einen Schlüssel lesen, dann könnte ein Angreifer, der eine von ihnen kompromittiert, den Schlüssel mitnehmen und auch nach dem Schließen der Lücke weiter für die Domain signieren. Hinter dem Daemon kann eine kompromittierte Stage weiterhin Nachrichten signieren lassen, solange sie läuft, denn jeder pepsi-Prozess kann die Schlüssel verwenden: über den Socket oder indem er ein eingereihtes From: umschreibt, das die signierende Stage dann signiert. Einen Schlüssel kopieren kann sie aber nicht. Eine kompromittierte Komponente nennt das Restrisiko, und Der DKIM-Signier-Daemon beschreibt den Mechanismus.

73.3. Funktionen

  • Signieren. Eine JSON-Anfrage pro Zeile; der Daemon prüft den Header-Block gegen seine Richtlinie (ein bedientes d=, ein DKIM-From:, das mit d= ausgerichtet und in h= genannt ist, ARC nur für [pepsi] ARC_DOMAIN) und signiert mit dem aktuellen Schlüssel. Ein nicht erreichbarer Daemon macht den Fehler der signierenden Stage vorübergehend: Die Nachricht wird wiederholt, nie unsigniert gesendet.

  • Selektoren je Generation. <DKIM_SELECTOR>-YYYYMM (RSA, RSA_BITS 2048, 3072 oder 4096) und <DKIM_SELECTOR>-YYYYMM-ed25519, sodass jeder Schlüssel einen eigenen Eintragsnamen hat.

  • Lebenszyklus next -> current -> retiring -> retired. Eine Domain ohne Schlüssel erhält sofort eine aktuelle Generation. Die Einträge einer ausscheidenden Generation bleiben RETIRE_AFTER_DAYS (14) bestehen, länger als das x= jeder Signatur; dann werden ihre privaten Schlüssel gelöscht oder, mit PUBLISH_RETIRED_KEYS, veröffentlicht, sobald das DNS ihre Einträge nicht mehr ausliefert.

  • Optionale Rotation (ROTATION_DAYS, standardmäßig aus), wobei die nächste Generation ROTATION_LEAD_DAYS (28) im Voraus erzeugt und, mit WAIT_FOR_DNS, der Wechsel zurückgehalten wird, bis jeder autoritative Server ihre Einträge ausliefert. pepsi-dkim rotate [--hard] und der Schalter rotate now der Konsole wechseln auf Anforderung.

  • DNS-Prüfungen jedes autoritativen Servers, standardmäßig stündlich; optionale RFC-2136-Aktualisierungen mit TSIG (DNS_UPDATE = rfc2136).

  • Postmaster-Benachrichtigungen per Mail, wenn ein Eintrag hinzugefügt werden muss oder entfernt werden darf, eine Rotation auf das DNS wartet oder eine DNS-Aktualisierung abgelehnt wurde.

  • Ein öffentliches Statusdokument, /var/lib/pepsi-dkim-public/status.json, gelesen von pepsi-status, pepsi-setup (run, check), der Admin-API (GET /api/v1/keys/dkim) und der DKIM-Seite der Konsole.

73.4. Es betreiben

DKIM-Schlüssel rotieren in Pepsi betreiben ist der Leitfaden für den Betreiber: die Einträge veröffentlichen, die Rotation einschalten, Notfallrotation, RFC 2136 und warum die Schlüssel aus Backups herausgelassen werden.

73.5. Siehe auch

pepsi-stage-dkim-sign, pepsi-stage-arc, pepsi-setup, Sicherheitsmodell, pepsi-dkim(1).