Pepsi-Handbuch¶
Pepsi ist ein Mailserver für Privatpersonen sowie für kleine und mittlere Organisationen, die ihre E-Mail selbst betreiben wollen, statt sie einem großen Anbieter zu überlassen. Er empfängt Ihre Mail aus dem Internet und verschickt Ihre Mail, wobei er sie sowohl innerhalb Ihrer Organisation als auch auf dem Weg zu allen anderen sicher hält.
Sichere E-Mail ohne Aufwand. Pepsi signiert, verschlüsselt und entschlüsselt Mail mit den beiden etablierten Standards, OpenPGP und S/MIME, und findet und verwaltet die Schlüssel, die dafür nötig sind. Bei jeder Nachricht sehen Sie klar, wer sie wirklich gesendet hat. Ihre Benutzer brauchen keine spezielle Software, und ein Korrespondent, der selbst keine Verschlüsselung hat, kann Ihre geschützte Mail trotzdem auf einer sicheren Webseite lesen.
Weniger Spam. Wie andere Mailserver prüft Pepsi, woher jede Nachricht wirklich stammt. Es kann einen unbekannten Absender außerdem bitten, zu bestätigen, dass er ein Mensch ist, oder eine winzige Zahlung mit GNU Taler beizufügen, bevor seine Mail Sie erreicht. Für Ihre Korrespondenten kostet das fast nichts; für jemanden, der Millionen von Nachrichten verschickt, summiert es sich zu echtem Geld.
Einfach einzurichten. Sie beantworten einige Fragen, und das Einrichtungsprogramm erledigt den Rest: Es erzeugt alle Schlüssel, beschafft die Zertifikate und sagt Ihnen genau, welche Einträge Sie im DNS veröffentlichen müssen. Danach prüft es, ob Sie sie richtig veröffentlicht haben. Diese Einträge sind wichtig, denn andere Anbieter entscheiden anhand von ihnen, ob sie Ihre Mail annehmen. Debian- und Ubuntu-Pakete sind unter deb.taler.net erhältlich (Pepsi installieren).
Passt in Ihr System. Pepsi stellt eingehende Mail in die Postfächer Ihrer Benutzer zu, an ein eigenes Zustellprogramm oder an einen anderen Mailserver. Es lässt Mailprogramme keine Postfächer über IMAP lesen; dafür setzen die meisten Installationen zusätzlich Dovecot ein.
Auf Sicherheit ausgelegt. Pepsi ist in einer speichersicheren Sprache geschrieben und in kleine Programme aufgeteilt, von denen jedes nur die Rechte hat, die es braucht. Die Kapitel Bedrohungsmodell und Sicherheitsmodell erklären im Detail, wovor Pepsi schützt und wie.
Freie Software. Pepsi ist freie Software unter der GNU Affero General Public License: Sie dürfen es für jeden Zweck ausführen, untersuchen, wie es funktioniert, und es ändern, und es an andere weitergeben, mit oder ohne Ihre Änderungen. Niemand kann Ihnen diese Freiheiten nehmen, und niemand kann Sie an sich binden. Der Quellcode ist öffentlich unter git://git.taler.net/pepsi.git.
Beginnen Sie mit Einführung. Dort steht, was Pepsi ist und welche Funktionen es bietet; das Kapitel vergleicht es mit den etablierten Mailservern und erklärt, wie der Rest dieses Handbuchs gegliedert ist. Erste Schritte auf einem günstigen VPS führt Sie von der Einrichtung des DNS bis zur ersten E-Mail, die Sie empfangen, und Der Assistent zeigt die Pipelines, die pepsi-setup --wizard baut, und was jede seiner Fragen entscheidet.
Inhalt
- 1. Einführung
- 2. Gestaltungsprinzipien
- 2.1. 1. Freie Software, unter der Kontrolle des Betreibers
- 2.2. 2. Anderen keinen Schaden zufügen
- 2.3. 3. Den Benutzern treu bleiben: keine Sicherheitsüberraschungen
- 2.4. 4. Das Minimum erheben und aufbewahren
- 2.5. 5. Mit dem arbeiten, was die Leute schon einsetzen
- 2.6. 6. Standardmäßig sicher, einfach einzurichten und zu benutzen
- 2.7. 7. Betreibbar und weiterentwickelbar
- 2.8. 8. Einfach genug, um überprüft zu werden
- 2.9. 9. Angemessen effizient
- 3. Erste Schritte auf einem günstigen VPS
- 3.1. Was wir bauen werden
- 3.2. Voraussetzungen
- 3.3. Schritt 1 — DNS delegieren und die Basis-Einträge anlegen
- 3.4. Schritt 2 — Pepsi installieren
- 3.5. Schritt 3 — Das System vorbereiten
- 3.6. Schritt 4 — Die Konfiguration schreiben
- 3.7. Schritt 5 — Schema, Schlüssel und Zertifikat einrichten
- 3.8. Schritt 6 — Die übrigen Einträge veröffentlichen und überprüfen
- 3.9. Schritt 7 — Die Dienste starten
- 3.10. Schritt 8 — Die erste E-Mail senden
- 3.11. Schritt 9 — Die Konsole öffnen (optional)
- 3.12. Auch Mail senden: einen Submission-Port hinzufügen
- 3.13. Fehlersuche
- 3.14. Nächste Schritte
- 4. Installation
- 4.1. Voraussetzungen
- 4.2. Pepsi installieren
- 4.3. Einen Download prüfen
- 4.4. Reproduzierbare Builds
- 4.5. Migration von einem vorhandenen Mailserver
- 4.6. Datenbank, Schlüssel und DNS einrichten
- 4.7. Im Browser einrichten
- 4.8. Die Dienste betreiben
- 4.9. Upgrade
- 4.10. Benutzer, Gruppen und Privilegien
- 4.11. Von GNU Mailman migrieren
- 5. Debian-Pakete
- 6. Der Assistent
- 7. Konfiguration
- 8. Pepsi betreiben
- 9. Pepsi benutzen: ein Leitfaden für Benutzer
- 9.1. Was der Mailserver für Sie tut
- 9.2. Ihr Mailprogramm einrichten
- 9.3. Wörter im Betreff von Mail, die Sie empfangen
- 9.4. Wörter, die Sie in den Betreff von Mail setzen können, die Sie senden
- 9.5. Erweiterungen für Mailprogramme
- 9.6. Ihre Einstellungen per E-Mail ändern
- 9.7. Ein Zertifikat von der Organisation
- 9.8. Wenn die erste Nachricht von jemand Neuem spät ankommt
- 9.9. Mail von Fremden und Ihre GNU-Taler-Wallet
- 9.10. Mailinglisten
- 9.11. Ihre eigenen Webseiten
- 10. Fehlersuche
- 11. Unterstützte Funktionen
- 11.1. Eingehender SMTP-Empfang
- 11.2. Trace-Header
- 11.3. Client-Authentifizierung
- 11.4. Nachrichteneinlieferung
- 11.5. Grenz-Authentifizierung
- 11.6. Authenticated Received Chain (ARC)
- 11.7. Sender Rewriting Scheme (SRS)
- 11.8. Ende-zu-Ende-Verschlüsselung und -Signierung
- 11.9. Serverseitige Entschlüsselung und Verifikation
- 11.10. Schlüsselverwaltung, -entdeckung und -veröffentlichung
- 11.11. Der Secure-Link-Ausweg
- 11.12. Ausgehende DKIM-Signierung
- 11.13. Zustellungsstatusbenachrichtigungen
- 11.14. Wiederverwendete Adressen
- 11.15. TLS verlangen
- 11.16. Internationalisierte und 8-Bit-Inhalte
- 11.17. Ausgehendes Relay
- 11.18. Lokale Zustellung
- 11.19. Mailinglisten und Archive
- 11.20. Unerwünschte Mail
- 11.21. Betriebsfunktionen
- 11.22. Funktionsstabilität
- 12. SMTP-Protokollerweiterungen
- 13. Schlüsselverwaltung
- 13.1. Drei Arten von Material
- 13.2. Verwahrung: wie ein privater Schlüssel gespeichert wird
- 13.3. Die Privilegiengrenze
- 13.4. Wogegen die Verwahrung schützt
- 13.5. Signieren und Verschlüsseln sind getrennt
- 13.6. Identitäten erzeugen
- 13.7. Zertifikate einer kommerziellen CA: die Managed PKI
- 13.8. Automatische Schlüssel nach Art von pEp
- 13.9. Zwei Schlüssel je Benutzer
- 13.10. Die Schlüssel unserer Benutzer veröffentlichen
- 13.11. Den Schlüsselverschlüsselungsschlüssel sichern und rotieren
- 13.12. Das Forward-Secrecy-Profil
- 13.13. Peer-Schlüssel
- 13.14. Den Schlüssel eines Korrespondenten finden
- 13.15. Ein CLI-Durchgang
- 13.16. Konfigurationsübersicht
- 13.17. Siehe auch
- 14. Das Secure-Link-Ausweichportal
- 15. Interoperabilität mit Clients
- 15.1. Zusammenfassung
- 15.2. OpenPGP: gpg
- 15.3. S/MIME: OpenSSL
- 15.4. Thunderbird: die Schranke, und wie ein GUI-Client ohne GUI getestet wird
- 15.5. Outlook und Apple Mail: festgehaltene Beobachtungen, keine Schranken
- 15.6. Kodierungsregeln, die die Interoperabilität erzwungen hat
- 15.7. Die gemessenen Zeilen reproduzieren
- 15.8. Siehe auch
- 16. Bedrohungsmodell
- 16.1. Wie dieses Kapitel zu lesen ist
- 16.2. Schutzgüter
- 16.3. Beteiligte und wie weit jedem vertraut wird
- 16.4. Vertrauensgrenzen
- 16.5. Angreifer
- 16.6. Ende-zu-Ende-Verschlüsselung: zwei Verwahrungsmodi
- 16.7. Was ein Sicherheitsindikator bedeutet
- 16.8. Gefälschte Hinweise
- 16.9. Adressbezogene Einstellungen sind eine Vertrauensgrenze
- 16.10. Der Netzwerkangreifer
- 16.11. Verfügbarkeit
- 16.12. Was Pepsi nicht schützt
- 16.13. Die Garantien auf einen Blick
- 16.14. Siehe auch
- 17. Sicherheitsmodell
- 17.1. Was Pepsi voraussetzt
- 17.2. Die Privilegientrennung
- 17.3. Die Verwahrungsgrenze für private Schlüssel
- 17.4. Zertifikate einer kommerziellen CA
- 17.5. Der DKIM-Signier-Daemon
- 17.6. Ein zweiter Faktor für die Schlüsselverwaltung
- 17.7. Sicherheitsschlüssel (WebAuthn)
- 17.8. Anmeldung an der Konsole per E-Mail
- 17.9. Ein Angreifer, der die Datenbank hat
- 17.10. Ein Angreifer, der die Konfigurationsdatei hat
- 17.11. Ein Prozess desselben Kontos
- 17.12. Adressen werden in einer einzigen Form verglichen
- 17.13. Ein Login, das den Eigentümer wechselt
- 17.14. Ein Angreifer, der einen Stage-Worker kompromittiert
- 17.15. Konkrete Verteidigungen
- 17.16. Wogegen Pepsi sich nicht verteidigt
- 17.17. Eine Schwachstelle melden
- 17.18. Siehe auch
- 18. Abhängigkeiten
- 19. Microsoft Exchange als Gateway
- 19.1. Topologien
- 19.2. Die Routing-Entscheidung
- 19.3. Exchange Online: der Mandanten-Endpunkt
- 19.4. Auswahl der Adressfamilie
- 19.5. Schleifenverhinderung
- 19.6. Konfiguration der Exchange-Connectors
- 19.7. Das Outlook-Add-in
- 19.8. Der
X-Pepsi-*-Header-Vertrag - 19.9. Automatische Identitätsbereitstellung
- 19.10. Schlüsselverteilung
- 19.11. Fehlersuche
- 19.12. Was Pepsi nicht tut
- 20. Erweiterungen für Mail-Clients
- 21. Mailinglisten
- 21.1. Dieses Subsystem ist eine Neuimplementierung von GNU Mailman 3
- 21.2. Was eine Liste ist
- 21.3. Wie das Subsystem aufgebaut ist
- 21.4. Erste Schritte
- 21.5. Stile
- 21.6. Einstellungen je Liste
- 21.7. Konfiguration
- 21.8. Die Teilzeichenfolgensuche ist optional
- 21.9. Zwei Kontosysteme
- 21.10. Bounce-Verarbeitung
- 21.11. Wenn die Inhaltsfilterung nichts übrig lässt
- 21.12. Was ein Absender eine Liste tun lassen kann
- 21.13. Bekannte Einschränkungen
- 21.14. Sammelnachrichten
- 21.15. Erklärte Unterschiede zu GNU Mailman 3
- 22. Archive
- 23. Die REST-API von GNU Mailman 3
- 23.1. In diesem Baum gibt es zwei APIs
- 23.2. Wo sie angeboten wird
- 23.3. Authentifizierung
- 23.4. Die beiden Versionen unterscheiden sich in vier Punkten
- 23.5. Vorlagen-URIs
- 23.6. Drei ehrliche Entsprechungen
- 23.7. Eine eigene Ressource von Pepsi
- 23.8. Was über die Zugangsdaten hinaus konfiguriert werden muss
- 23.9. Ein durchgearbeitetes Beispiel
- 23.10. Was nicht implementiert ist
- 23.11. Sie testen
- 24. Die administrative API
- 24.1. Wo sie bedient wird
- 24.2. Authentifizierung
- 24.3. Autorisierung: Geltungsbereiche
- 24.4. Konventionen
- 24.5. Paginierung
- 24.6. Endpunkte
- 24.7. Was dieser Server nicht kann
- 24.8. Korrespondentenschlüssel
- 24.9. Vertrauensanker
- 24.10. Managed PKI
- 24.11. Greylisting
- 24.12. Quarantäne
- 24.13. DKIM-Schlüssel
- 24.14. Secure Links
- 24.15. DNS-Einträge
- 24.16. Online-Setup
- 24.17. Härtung
- 24.18. Das Prüfprotokoll
- 24.19. Das Maillog (standardmäßig aus)
- 24.20. Bootstrapping
- 24.21. Die Browser-Konsole
- 25. Die Verwaltungskonsole
- 25.1. Drei Listener-Flags, und bei zwei davon lautet der Rat entgegengesetzt
- 25.2. Sie sicher erreichen
- 25.3. Anmelden
- 25.4. Was die Konsole kann und was nicht
- 25.5. Die Seiten
- 25.6. Zwei Templating-Engines, zwei Zwecke
- 25.7. Kein Scripting, keine entfernten Ressourcen
- 25.8. Barrierefreiheit
- 25.9. Die öffentlichen Mailinglistenseiten
- 25.10. Zwei Kontosysteme, und keines gewährt dem anderen etwas
- 25.11. Die Seiten des Mitglieds
- 25.12. Die Konsole für Verwalter und Moderatoren
- 25.13. Die Sprachen der Oberflächen
- 26. Architektur
- 27. Der Nachrichten-State
- 28. Die Pipeline erweitern
- 28.1. Wann eine Stage das richtige Werkzeug ist
- 28.2. Anatomie einer Stage-Crate
- 28.3. Der Rumpf
- 28.4. Terminale Helper (wählen Sie genau einen)
- 28.5. Fehler
- 28.6. Regeln, nach denen die Stages leben
- 28.7. Es verdrahten
- 28.8. Eine Stage testen
- 28.9. Unterstützung für die Migration von einem anderen MTA hinzufügen
- 28.10. Einen externen Credential-Refresh-Dienst integrieren
- 28.11. Lebenszyklus des Datenbankschemas
- 28.12. Ein Release erstellen
- 28.13. Die Funktionsstabilitätstabelle aktuell halten
- 29. Testsuite
- 30. Benchmark-Suite
- 31. Leistung
- 32. pepsi-ingress
- 33. pepsi-dispatch
- 34. pepsi-httpd
- 35. pepsi-stage-arc
- 36. pepsi-stage-srs
- 37. pepsi-stage-encrypt
- 38. pepsi-stage-decrypt
- 39. pepsi-stage-dkim-sign
- 40. pepsi-stage-bounce
- 41. pepsi-stage-aliases
- 42. pepsi-stage-relay-to-internet
- 43. pepsi-stage-relay-to-smarthost
- 44. pepsi-stage-relay-to-maildir
- 45. pepsi-stage-dot-forward
- 46. pepsi-stage-relay-to-lmtp
- 47. pepsi-stage-discard
- 48. pepsi-stage-anti-spam
- 49. pepsi-stage-auto-pay
- 50. pepsi-stage-check-whitelist
- 51. pepsi-stage-auto-whitelist
- 52. pepsi-stage-autocrypt-learn
- 53. pepsi-stage-reencrypt
- 54. pepsi-stage-detect-language
- 55. pepsi-detect-language
- 56. pepsi-stage-block-language
- 57. pepsi-stage-vacation
- 58. pepsi-stage-secretary
- 59. pepsi-stage-edit-settings
- 60. pepsi-stage-if
- 61. pepsi-stage-milter
- 62. pepsi-stage-quarantine
- 63. pepsi-stage-route
- 64. pepsi-stage-vks-confirm
- 65. pepsi-stage-dmarc-report
- 66. pepsi-stage-defang
- 67. pepsi-stage-secure-link
- 68. pepsi-setup
- 69. pepsi-queue
- 70. pepsi-status
- 71. pepsi-reputation
- 72. pepsi-greylist
- 73. pepsi-dkim
- 74. pepsi-sendmail
- 75. pepsi-whitelist
- 76. pepsi-keys
- 77. pepsi-keydisc
- 78. pepsi-settings
- 79. pepsi-list
- 80. pepsi-archive
- 81. pepsi-stage-list
- 82. pepsi-stage-list-post
- 83. pepsi-stage-list-deliver
- 84. pepsi-stage-list-command
- 85. pepsi-stage-list-bounce
- 86. pepsi-tlsrpt
- 87. pepsi-secure-link
- 88. pepsi-failure-bouncer
- 89. pepsi-quota
- 90. pepsi-helper-token-refresh
- 91. pepsi-telemetry
- 92. pepsi-telemetry-client
- 93. pepsi-config
- 94. Funktionsstabilität
- 95. Handbuchseiten
- 96. Schwachstellen in E-Mail-Implementierungen
- 96.1. Wie dieses Kapitel aufgebaut ist
- 96.2. Zusammenfassung
- 96.3. Transport und Infrastruktur
- 96.4. Absenderauthentizität und Mailfluss
- 96.5. Nachrichtenformat und Darstellung
- 96.6. Mail-Software
- 96.7. Ende-zu-Ende-Verschlüsselung und Schlüssel
- 96.8. Kryptographische Primitive und Bibliotheken
- 96.9. Konten und Menschen
- 96.10. Wer beim Verbleibenden handeln muss
- 97. RFC-Index
- 98. Literaturverzeichnis
Indizes