5. Debian-Pakete¶
Ein Quellpaket baut vier Binärpakete: den Mailserver und drei Abspaltungen davon. Zwei dieser Abspaltungen sind eine Frage gewöhnlichen Paketierungsurteils: eine Stage, die niemand herunterladen müssen sollte, der sie nicht nutzt, und ein Collector, der auf die Maschine eines anderen gehört. Die dritte ist eine Sicherheitskontrolle: Sie enthält den einen Mechanismus, mit dem eine HTTP-Anfrage eine privilegierte Änderung auf dem Host bewirken kann, und sonst nichts. Wer sie entfernt, nimmt also den Mechanismus fort und nicht nur den Knopf, der ihn erreicht.
Installation behandelt das Installieren und Bootstrappen einer Installation; dieses Kapitel behandelt, was jedes Paket enthält und wie man die Aufteilung nutzt.
5.1. Die Paketmenge¶
Paket |
Arch |
Was es enthält |
|---|---|---|
|
|
Der Mailserver: jedes Programm außer den beiden unten abgetrennten, das SQL-Schema, die Vorlagen, die paketierten Konfigurations-Standardwerte, die Handbuchseiten, das Info-Handbuch, der bei der Erstinstallation nach |
|
|
|
|
|
|
|
|
|
5.1.1. pepsi¶
Das Basispaket, und auf einem vom Terminal aus verwalteten Host das einzige, das Sie brauchen. Es installiert das Release-Layout, das unter Installieren in Installation beschrieben ist: das Multi-Call-Binärprogramm unter /usr/libexec/pepsi/pepsi mit einem /usr/bin-Symlink je eingefaltetem Programm, und die eigenständigen Programme als eigene, echte ausführbare Dateien. Eigenständig sind die Programme mit setuid- oder setgid-Bit sowie die getrennt aufgerufenen wie pepsi-setup. Daneben gehen die SQL-Patchdateien, die pepsi-setup liest, die Liste öffentlicher Hoster, die Nachrichtenvorlagen, die config.d-Standardwerte, die vor pepsi.conf geparst werden, sämtliche Handbuchseiten und das GNU-Info-Handbuch.
Es beansprucht außerdem Debians mail-transport-agent-Schnittstelle (Provides/Conflicts/Replaces: mail-transport-agent), sodass /usr/sbin/sendmail, mailq und newaliases zu Pepsis werden und kein zweiter MTA daneben installiert werden kann. Es Depends auf postgresql, adduser und acl, und sein postinst legt die Dienstkonten, die absichernden Gruppen, die Laufzeitverzeichnisse, die dpkg-statoverride-Einträge für die privilegierten Binärprogramme und (nach Möglichkeit) die Datenbankrollen an. Siehe Benutzer, Gruppen und Privilegien in Installation dafür, was diese Identitäten sind und warum es jede gibt.
Es führt rsync nur unter Suggests; damit werden die IP-Sperrlisten abgerufen, die auf keinem anderen Weg verteilt werden (pepsi-reputation). Keine davon ist standardmäßig aktiviert; auf einem Host ohne rsync werden sie nicht verwendet, und pepsi-setup warnt vor jeder, die aktiviert ist.
Alles, was es ausliefert, wird deaktiviert installiert. Um die Pipeline hochzufahren, führen Sie systemctl enable --now pepsi.target aus, nachdem eine Konfigurationsdatei existiert und pepsi-setup gelaufen ist. Diese Aussage betrifft nur die Installation; siehe Aktualisierungen, Entfernung und Dienstzustand dazu, was ein späteres apt upgrade oder apt remove mit einer schon laufenden Pipeline tut.
Wichtig
pepsi-setup selbst ist in diesem Paket, nicht in pepsi-httpd-admin: Ein Host ohne installiertes administratives Paket muss weiterhin vollständig vom Terminal aus konfigurierbar sein.
5.1.2. pepsi-httpd-admin¶
Das Paket enthält zwei systemd-Unit-Dateien und sonst nichts. Deshalb ist es auch Architecture: all und braucht kein ${shlibs:Depends}.
Diese beiden Dateien sind die privilegierte Hälfte der Browser-Konsole, und der Rest dieses Kapitels handelt von ihnen. Die Abhängigkeitsrichtung ist der Punkt: pepsi-httpd-admin Depends auf pepsi (allein ist es nutzlos), während pepsi pepsi-httpd-admin bloß Recommends. Eine Standardinstallation hat es daher, sodass das Setup-Interview der Konsole von Haus aus funktioniert, und apt remove pepsi-httpd-admin gelingt, ohne auch den Mailserver zu entfernen. Mit einem Depends ließe sich das Paket nicht für sich allein entfernen; mit einem Suggests könnte die Konsole jeder Standardinstallation stillschweigend nichts anwenden.
Die Units werden wie alle anderen deaktiviert ausgeliefert, und das postinst des Pakets gibt das zur Installationszeit aus, statt einen Betreiber aus einem Paketnamen erraten zu lassen, was gerade möglich geworden ist. Es leert außerdem die Warteschlange der Einrichtungsaufgaben, während es sie installiert. Das Installieren leert zuerst die Warteschlange erklärt, warum ein neu installierter Applier nicht alles ausführen darf, was während seiner Abwesenheit angefordert wurde.
5.1.3. pepsi-stage-detect-language¶
Die Spracherkennungs-Stage, abgetrennt, weil sie umfangreiche statistische Modelle zum Erkennen von Sprachen einbettet und die meisten Pipelines sie nie laden. pepsi Suggests sie; die Stage Enhances pepsi und Depends auf genau dieselbe Binärversion. Die Validierung enthält eine Prüfung, die genau für diese Aufteilung geschrieben wurde: Wenn die konfigurierte Pipeline die Stage nutzt und das Binärprogramm nicht auf $PATH liegt, warnt pepsi-setup und nennt die apt install-Zeile. So fällt das fehlende Paket schon vor dem Start auf und nicht erst, wenn der Dispatcher keinen Worker starten kann.
Das Paket trägt außerdem pepsi-detect-language, das Offline-Werkzeug für Diagnose und Feinabstimmung. Es ist ein Symlink auf $PATH zu genau derselben ausführbaren Datei; es klassifiziert eine aus einer Datei gelesene Nachricht und gibt nur aus, was die Stage festgehalten hätte. Es ist hier statt in pepsi, weil es dieses Binärprogramm ist: Es teilt sich den gesamten Klassifikationspfad und die Sprachmodelle. Es getrennt auszuliefern verdoppelte also genau den Umfang, den diese Aufteilung vermeiden soll. Siehe pepsi-stage-detect-language und pepsi-detect-language.
5.1.4. pepsi-telemetry¶
Der zentrale Collector für Pepsis anonyme Funktionstelemetrie auf Opt-in-Basis. Er ist ein kleiner HTTP-Server, gedacht für den Betrieb auf einem Host hinter einem bestehenden nginx oder Apache. Das Paket liefert deshalb für beide je eine vollständige Site-Datei mit, deaktiviert und unter ihrem kanonischen Namen in sites-available/ installiert. Jede Datei zeigt bereits auf den Socket, den die mitgelieferten Units binden, sodass zum Aktivieren nur der Symlink nötig ist (a2ensite oder ln -s nach sites-enabled/). Das Paket Recommends einen Front-Server und certbot. Beide Site-Dateien sind conffiles: Ändern Sie den server_name für einen privaten Collector, und die Änderung übersteht Upgrades.
Gewöhnliche Pepsi-Knoten brauchen dieses Paket nie. Was sie betreiben, ist der Telemetrie-Client, der Teil des pepsi-Pakets ist und von [pepsi] SHARE_TELEMETRY gesteuert wird. Dieser Schalter ist Opt-in und standardmäßig no. Bis ein Betreiber ihn auf yes setzt, bleibt der Daemon (falls überhaupt gestartet) ruhend, ohne Socket und ohne etwas zu übermitteln, und die In-Process-Aufrufe sind No-Ops. Dass die Unit des Clients im Hauptpaket liegt, kostet eine Installation daher nichts, worum sie nicht gebeten hat. Beachten Sie, dass das Collector-Paket dennoch Depends auf pepsi in derselben Binärversion: „läuft auf einem eigenen Host“ ist eine Aussage darüber, wo Sie es installieren, nicht die Behauptung, es sei eigenständig. Siehe pepsi-telemetry.
5.2. Woher die Pakete kommen und wie man sie prüft¶
Die Pakete werden auf deb.taler.net veröffentlicht und sind wie jedes Paket dort mit dem Release-Schlüssel von taler-systems signiert. apt prüft jeden Download gegen den Schlüsselbund, den signed-by= im Quelleneintrag nennt; diesen Schlüsselbund installieren Sie einmalig (Einen Download prüfen). Ein mit make deb aus dem Quellbaum gebautes Paket ist unsigniert, sofern DEB_SIGN_KEYID keinen Schlüssel nennt. Die Binärprogramme in einem Paket sind aus dem Quellcode und der Toolchain, die die .buildinfo-Datei nennt, reproduzierbar (Reproduzierbare Builds).
5.3. Aktualisierungen, Entfernung und Dienstzustand¶
Alles wird deaktiviert ausgeliefert, und dieses Versprechen gilt der Installation. Eine Aktualisierung darf nicht ändern, was läuft: Eine Installation, deren Pipeline lief, behält sie laufend, und eine, deren Pipeline stand, lässt sie stehen. Keiner der beiden Zustände wird irgendwo festgehalten: systemctl try-restart liest ihn Unit für Unit vom laufenden System ab, startet eine aktive Unit neu und tut mit einer inaktiven nichts. Ein socket-aktivierter Dienst, der untätig wartet, bleibt also untätig, und eine erste Installation startet weiterhin nichts, weil der Neustart nur läuft, wenn dpkg eine zuvor konfigurierte Version übergeben hat.
Bemerkung
Dieses Verhalten hängt an einem dh_installsystemd-Flag, und dieses Flag hat eine Falle. --restart-after-upgrade ist die Voreinstellung des Werkzeugs, aber nur, solange --no-start fehlt. Pepsi übergibt --no-start gerade deshalb, weil eine frische Installation nichts starten darf, und das hebt die Voreinstellung stillschweigend auf. Ohne beide Flags stoppt eine Aktualisierung jede Unit vor dem Entpacken, nichts startet sie wieder, und systemd wird nicht einmal neu geladen. make check scheitert, wenn ein Aufruf das Flag je verliert.
Die Entfernung ist die andere Hälfte. apt remove stoppt die Units, und das Stoppen übernimmt das prerm jedes Pakets. Dasselbe --no-start unterdrückt nämlich auch das Bruchstück, mit dem debhelper Units bei der Entfernung stoppt. Ohne Ersatz würde eine Entfernung pepsi-dispatch gegen gelöschte Binärdateien weiterlaufen lassen. Sie würde außerdem pepsi-setup-apply.socket lauschen lassen, nachdem sein Paket verschwunden ist, obwohl gerade die Abwesenheit dieses Pakets die Sicherheitsgrenze sein soll. Das prerm hält außerdem fest, welche seiner Units liefen.
Dieser Vermerk ist das, was eine Pipeline nach Entfernen und dann Neuinstallieren zurückbringt. Neuinstallieren stellt von sich aus nichts wieder her: die Aktivierung übersteht eine Entfernung unangetastet (die Symlinks in /etc/systemd/system/*.wants gehören keinem Paket, und nur purge räumt sie ab), ohne den Vermerk bleibt ein Betreiber also mit einer Pipeline zurück, die aktiviert ist, beim nächsten Systemstart hochkommt und bis dahin ohne sichtbaren Grund unten ist. Die Markierung liegt unter /var/lib/pepsi/<package>.was-active, bewusst nicht unter /tmp: die Zeitspanne zwischen Entfernung und Neuinstallation kann einen Systemstart, einen Stromausfall oder vierzehn Tage enthalten. Sie wird unter einem temporären Namen im selben Verzeichnis geschrieben und an ihren Platz umbenannt, eine Unterbrechung hinterlässt also eine ganze Markierung oder keine. purge löscht sie.
Die Aktivierung selbst wird nie festgehalten und nie wiederhergestellt. Es gibt nichts zu erinnern, denn dpkg rührt diese Symlinks nicht an. Ein Mechanismus, der ein Target deaktivierte, um es später wieder zu aktivieren, würde genau das Fenster öffnen, das er zu schließen scheint: Eine mitten darin unterbrochene Aktualisierung würde die Installation deaktiviert hinterlassen, mit ihrer einzigen Spur in einer Datei.
5.4. Die Aufteilung als Härtungshebel¶
5.4.1. Warum es überhaupt eine entfernbare Hälfte gibt¶
Das Setup ist privilegierte Arbeit: /etc/pepsi/pepsi.conf schreiben, jedes secrets.d-Fragment dem einzigen Konto übergeben, das es liest, certbot ausführen, Datenbankrollen anlegen, Schlüsselmaterial erzeugen. pepsi-httpd, das die Browser-Konsole bedient, tut nichts davon. Es wechselt auf das Konto pepsi-httpd, bevor es eine Verbindung annimmt, und darf nie zurückerlangen können, was es abgegeben hat.
Es handelt also nicht. Es hält einen Absichtsdatensatz in pepsi.setup_task fest, der beschreibt, was wahr sein soll, und verbindet sich dann mit einem UNIX-Socket und schließt ihn. Diese Verbindung ist die gesamte Botschaft: Nichts wird hineingeschrieben und nie etwas daraus gelesen, sodass sie kein Befehlskanal werden kann (siehe Mail-Appliances speichern Geheimnisse für alle lesbar oder ungeschützt). Die Verbindung bewirkt nur, dass systemds Socket-Aktivierung pepsi-setup apply als root startet. Der Applier nimmt seine Arbeit aus der Datenbank, wo jeder Datensatz gegen eine geschlossene Aufgabenliste geprüft und protokolliert wird, und beendet sich wieder, wenn keine Arbeit mehr da ist. Root wird über eine Datenbanktabelle erreicht, nie über einen Socket, der ein Protokoll spricht. Das vollständige Vertrauensmodell, einschließlich der Dinge, die der Applier bewusst nicht kann, ist Das Vertrauensmodell des Appliers in pepsi-setup; lesen Sie es, bevor Sie irgendetwas davon aktivieren.
Dieser Aufbau macht die Fähigkeit abtrennbar. Die Socket-Unit (die Türklingel) und die Service-Unit des Appliers sind der gesamte Mechanismus. Sie sind zwei Dateien, und es sind die zwei Dateien, die pepsi-httpd-admin enthält.
5.4.2. Was das Entfernen tatsächlich entfernt¶
apt remove pepsi-httpd-admin stoppt beide Units und löscht ihre Dateien. Von diesem Moment an leert nichts pepsi.setup_task von selbst. Ein INSERT in diese Tabelle ist inaktiv: Er liegt dort, und nichts wird darauf reagieren, sofern nicht ein Mensch mit einer root-Shell es beschließt (pepsi-setup apply --once funktioniert weiterhin, denn das Paket trägt die Units, nicht das Programm).
Die Schleife wird am Mechanismus gebrochen, nicht an der Benutzeroberfläche. Es spielt keine Rolle, was danach mit der Web-Schicht geschieht, denn nichts von Folgendem verleiht jemandem die Fähigkeit, einen root-Prozess zu starten: ein feindlicher Administrator mit gültiger Sitzung, ein gestohlenes Bearer-Token oder ein Fehler in pepsi-httpd selbst, der das Ausführen fremden Codes erlaubt. Die Web-Schicht hatte diese Fähigkeit nie; sie hatte immer nur eine Türklingel, und die Türklingel ist fort (siehe Befehlsinjektion und XXE in Verwaltungsoberflächen von Mail-Gateways).
Zwei Dinge werden ausdrücklich nicht entfernt, und sie mit dem Applier zu verwechseln ist hier der naheliegendste Fehler:
Konfigurations-Überschreibungen funktionieren weiterhin.
/api/v1/configund die Konfigurationsseiten der Konsole schreibenpepsi.config_override, die Datenbank-Überlagerung, die jede Komponente zur Laufzeit liest, und keine Datei in/etc. Sie behalten ihre eigene Schranke,[pepsi-admin] CONFIG_DB, und sind unberührt. Der Applier hat mit ihnen nichts zu tun, und die Nur-lesen-Regel darauf auszuweiten entfernte eine Fähigkeit, um die es bei dieser Aufteilung nie ging. Siehe Konfiguration in der Datenbank in Konfiguration. Beachten Sie, dass die Überlagerung die Pipeline neu verdrahten und wählen kann, welchespepsi-stage-*-Programm eine Stage ausführt; eine andere ausführbare Datei kann sie nicht benennen. Ein Prinzipal, der sie schreiben darf, kann daher weiterhin ändern, wie Nachrichten verarbeitet werden, und diese Aufteilung schränkt das nicht ein (siehe Befehlsinjektion und XXE in Verwaltungsoberflächen von Mail-Gateways).Am Mailfluss ändert sich nichts.
pepsi-ingress,pepsi-dispatch, jede Stage und die MTA-STS- und Metriken-Oberflächen vonpepsi-httpdbleiben unangetastet. Dies ist kein Build des Mailservers mit reduziertem Funktionsumfang.
Zwei Konsolenfunktionen hängen daran: die Anmeldung von Endbenutzern per E-Mail (Anmelden per E-Mail) und die Passwortanmeldung bei einem Konsolenkonto mit zweitem Faktor. Die Web-Schicht kann die Geheimnisse des zweiten Faktors nicht lesen. Jede Bestätigung einer Registrierung ist daher eine confirm-enrolment-Aufgabe und jede solche Anmeldung eine confirm-login-Aufgabe, die der Applier prüft (Ein zweiter Faktor für die Schlüsselverwaltung). Ohne den Applier wird die Registrierung schon im ersten Schritt abgelehnt, statt einen Link zu verschicken, der nie abgeschlossen werden könnte, und ein solches Konto kann sich nicht per Passwort anmelden (der lokale Socket funktioniert weiterhin).
5.4.3. Wie pepsi-httpd es bemerkt¶
Eine Konsole, die auf einem Host ohne Applier Formulare anbietet, ist das schlechteste Ergebnis der Aufteilung: Ein Betreiber füllt ein Interview aus, drückt „anwenden“, sieht einen pending-Datensatz und wartet auf eine Änderung, die nie kommen wird. Der Server fragt daher vor jeder Änderung, ob von hier aus überhaupt eine privilegierte Änderung geschehen kann.
Er hat bereits Privilegien abgegeben, kann also dpkg nicht fragen und nicht mit systemds privatem Bus sprechen, und er darf keinen Weg dazu bekommen. Was er kann, ist zwei Dateien betrachten, die zusammen die Fragen installiert? und scharfgestellt? beantworten:
pepsi-setup-apply.socketexistiert als Unit-Datei in einem der Verzeichnisse, die systemd durchsucht (/etc/systemd/system,/run/systemd/system,/usr/local/lib/systemd/system,/usr/lib/systemd/system,/lib/systemd/system); und[pepsi-admin] APPLY_SOCKETexistiert, ist ein Socket und ist für dieses Konto beschreibbar — sich mit einem UNIX-Socket zu verbinden braucht Schreibrecht, und eine Türklingel, die nicht betätigt werden kann, ist keine Fähigkeit.
Das kostet zwei stats und ein access und braucht kein Privileg. Die Probe verbindet sich bewusst nicht: Sich zu verbinden ist das Betätigen der Türklingel und startete bei jedem Seitenaufbau einen root-Prozess.
Keine der beiden Prüfungen ist überflüssig, und keine sollte später wegoptimiert werden:
Ohne die Unit-Datei-Prüfung liest sich ein veralteter Socket-Knoten als lebendige Türklingel. Veraltete Knoten kommen in der Praxis vor: systemds
RemoveOnStop=ist standardmäßig aus (die ausgelieferte Unit setzt es; eine von Hand bearbeitete vielleicht nicht), und ein Paket, dessen Dateien gelöscht statt gestoppt werden, lässt den Knoten schlicht zurück. Das ist genau das Szenario, für das es diese Funktion gibt, und es falsch zu behandeln würde offen scheitern.Ohne die Socket-Prüfung läse sich ein frisch installiertes Paket, dessen Socket nie aktiviert wurde, als bereit, und jede Aufgabe bliebe für immer
pending.
Die Prüfung scheitert geschlossen. Ein Pfad, der nicht untersucht werden kann, ein Pfad, der kein Socket ist, ein Rechtefehler, ein nicht lesbares Elternverzeichnis — jede Unsicherheit liest sich als „kein Applier“, und die Konsole wird nur lesend. Der so entstehende Fehlschlag besteht darin, dass einem Betreiber gesagt wird, er solle etwas installieren, das bereits installiert ist. Ein Fehlschlag in der anderen Richtung ließe einen Betreiber glauben, eine Änderung sei vorgenommen worden. Nur der erste lässt sich durch das Lesen der Meldung beheben, und die Meldungen sind zum Lesen geschrieben: Sie unterscheiden nicht installiert, installiert, aber nicht gestartet und hier liegt ein veralteter Knoten, und jede nennt ihre eigene Abhilfe.
5.4.4. Wie „nur lesend“ aussieht¶
Alles wird weiterhin gerendert. Jede Einstellung, nach der das Setup-Interview fragt, wird gezeigt, mit ihrer vorbereiteten Antwort oder ihrem Standardwert; jedes Bedienelement, das eine ändern würde, ist deaktiviert, unter einem Banner, das das fehlende Paket benennt. Die Seiten zu verbergen wäre die einfache Lesart von „nur lesend“, und die falsche: Ein Betreiber, der den Applier bewusst entfernt hat, muss weiterhin sehen können, wozu die Installation konfiguriert ist.
Die API weist die entsprechenden Änderungen mit einem eigenen Status und Code zurück statt mit einem generischen Fehlschlag:
HTTP/1.1 503 Service Unavailable
{"code": "setup_applier_unavailable",
"hint": "the administrative package 'pepsi-httpd-admin' is not installed …",
"detail": {"package": "pepsi-httpd-admin", "unit": "pepsi-setup-apply.socket"}}
Es gilt für POST /api/v1/setup/tasks, /setup/preflight, /setup/dns-check, /setup/certificates, PUT /api/v1/setup/answers und die Selbstbedienungs-Schlüsselanfragen POST /api/v1/identities, /api/v1/identities/client und ein widerrufendes PATCH /api/v1/identities/{id} sowie für die eigenen Formular-Posts der Konsole — POST /ui/setup/{step}, /ui/setup/tasks, /ui/domains/check, /ui/identities/request/{generate,register} und /ui/identities/{id}/revoke. Sie alle erreichen die Warteschlange über eine Einreihungsfunktion, die zuerst nachfragt, sodass die Ablehnung eine einzige Entscheidung ist statt einer je Oberfläche. Das deaktivierte Bedienelement auf der Seite ergänzt diese Prüfung, es ersetzt sie nicht. Das Vorbereiten von Antworten ist mit Absicht eingeschlossen: Der einzige Zweck einer Entwurfsantwort ist, angewandt zu werden, und ein Assistent, der sechs Schritte voller Antworten auf einem Host sammelt, auf dem nichts sie anwenden kann, ist genau die stillschweigende Wirkungslosigkeit, die der Entwurf vermeidet. DELETE /api/v1/setup/answers ist nicht gesperrt: Entwürfe zu verwerfen kann keine privilegierte Änderung bewirken, und eine nur lesende Konsole muss ein halbfertiges Interview weiterhin leeren können.
Der Code unterscheidet sich von setup_write_unavailable (was bedeutet, dass es keine CONFIG_DB-Verbindung gibt), weil die beiden verschiedene Abhilfen haben, und der Applier wird zuerst gemeldet, wenn beides zutrifft: Eine Datenbankrolle zu konfigurieren hätte nicht geholfen.
5.4.5. Was mit entferntem Paket weiterhin funktioniert¶
Alles, von einem Terminal aus. pepsi-setup liegt im pepsi-Paket, sodass:
pepsi-setup -c /etc/pepsi/pepsi.conf run
pepsi-setup -c /etc/pepsi/pepsi.conf --wizard
pepsi-setup -c /etc/pepsi/pepsi.conf check
sich genau so verhalten wie mit installiertem Paket, ebenso wie pepsi.conf von Hand zu bearbeiten, Schlüssel zu erzeugen, certbot selbst auszuführen und jede andere administrative Aufgabe. Der Applier-Unterbefehl ist ebenfalls noch da: Was das Paket trägt, sind die Units, nicht das Programm.
Entfernt wird nur eines: die Fähigkeit der Web-Schicht, ihn zu starten.
5.4.6. Es scharfzustellen ist ein eigener, bewusster Schritt¶
pepsi-httpd-admin zu installieren macht die Fähigkeit verfügbar. Es schaltet sie nicht ein. Wie jede andere Pepsi-Unit werden die beiden deaktiviert ausgeliefert, sodass ein Host, der das Paket hat, aber nie
# systemctl enable --now pepsi-setup-apply.socket
ausgeführt hat, keine Türklingel besitzt, und die Konsole bleibt nur lesend und sagt, welcher Befehl das ändern würde. Ein Paket zu installieren und ein Privileg scharfzustellen bleiben zwei getrennte Entscheidungen.
5.4.7. Das Installieren leert zuerst die Warteschlange¶
Den Applier zu entfernen bricht die Schleife am Mechanismus, und Datensätze können pepsi.setup_task weiterhin erreichen, solange er fort ist: Ein Betreiber mit einer root-Shell kann einen von Hand einreihen, und eine Konsole, der nur gesagt wird, dass sie nur lesend ist, ist ein Release von einem Pfad entfernt, der zu fragen vergisst. Nichts lässt einen solchen Datensatz verfallen. Eine Anfrage ist dauerhaft, und die Warteschlange wird in der Reihenfolge geleert, in der sie geschrieben wurde.
Zusammengenommen heißt das: Ein Applier, der Monate später installiert wird, würde jeden dieser Datensätze beim ersten Betätigen der Türklingel ausführen, gegen eine Installation, die sich inzwischen verändert hat. Er könnte eine Konfiguration aus Antworten schreiben, an die sich niemand erinnert, oder ein Zertifikat für einen Host beschaffen, der umbenannt wurde.
Daher löscht das Installieren von pepsi-httpd-admin die Warteschlange, bevor seine Units scharfgestellt werden. Das postinst führt
# pepsi-setup -c /etc/pepsi/pepsi.conf apply --clear
aus, was jeden Datensatz entfernt, ohne einen davon auszuführen, und das unter Nennung des Grundes sagt, sodass ein Betreiber, der etwas legitim eingereiht hatte, weiß, was daraus geworden ist, und erneut fragen kann. Was angefordert wurde, geht so oder so nicht verloren: Jede Anfrage, Ablehnung, jeder Erfolg und Fehlschlag ist ein eigener dauerhafter Eintrag im Prüfprotokoll, das das Zurücksetzen nicht anfasst. Derselbe Befehl steht jederzeit von Hand zur Verfügung — siehe pepsi-setup.
Es geschieht nach Möglichkeit, wie ein Maintainer-Skript es muss. Zur Installationszeit gibt es womöglich keine Konfigurationsdatei, kein Schema, keine Datenbank und kein laufendes PostgreSQL; jedes davon wird gemeldet und übersprungen, und keines lässt die Installation scheitern. (Eine Datenbank ohne Pepsi-Schema ist nicht einmal ein Überspringen: Sie hat nie eine Aufgabe gehalten, also ist sie eine leere Warteschlange.) Das Zurücksetzen läuft bei jedem configure, nicht nur bei einer Erstinstallation, denn dpkg meldet eine Neuinstallation nach apt remove als Upgrade, und Entfernen-dann-Neuinstallieren ist genau der Fall, für den es dieses Zurücksetzen gibt.
5.4.8. Derselbe Hebel aus dem Quelltext¶
Eine make install-Installation bekommt die identische Kontrolle:
make install INSTALL_ADMIN_UNITS=no
was alles außer pepsi-setup-apply.service und pepsi-setup-apply.socket installiert und ausgibt, was es weggelassen hat. make uninstall entfernt stets beide Mengen, unabhängig vom Wert der Variablen bei diesem Aufruf. Würde eine privilegierte Unit eine Deinstallation überleben, weil sich eine make-Variable geändert hat, wäre das genau der Fehlschlag, um den es bei dieser Aufteilung geht.
5.4.9. Eine Haltung wählen¶
Die Probe, die Konfigurationsoption und die Paketmenge wirken zusammen, sodass die Frage „kann diese Konsole diese Maschine ändern?“ mehr als zwei Antworten hat. [pepsi-admin] APPLIER ist die Überschreibung, vollständig dokumentiert in pepsi.conf(5):
Haltung |
Wie |
Ergebnis |
|---|---|---|
Vom Browser aus verwaltet |
Paket installiert, Socket aktiviert, |
Die Konsole kann Einrichtungsaufgaben anwenden. |
Installiert, aber nicht scharfgestellt |
Paket installiert, Socket nie aktiviert |
Nur lesend; die Ablehnung nennt |
Vom Terminal aus verwaltet |
|
Nur lesend; die Ablehnung nennt das Paket, und nichts leert die Aufgabenwarteschlange unbeaufsichtigt. |
Nur lesend per Richtlinie |
|
Nur lesend durch Konfiguration statt durch die installierten Pakete, und die Ablehnung sagt das. Umkehrbar durch das Bearbeiten einer Option — eine Richtlinie, keine Grenze. |
Anders angewandt |
|
Die Konsole bietet die Formulare an. |
Bei zwei dieser Zeilen lohnt es, den Unterschied auszubuchstabieren. APPLIER = no und das Entfernen des Pakets erzeugen beide eine nur lesende Konsole, und sie sind nicht dieselbe Verteidigung. APPLIER = no ist eine Zeile in einer Konfigurationsdatei, die pepsi-httpd heranzieht; jeder, der diese Datei ändern kann oder pepsi-httpd dazu bringen kann, eine andere zu lesen, macht es rückgängig. Das Paket zu entfernen löscht die Units, die den root-Prozess ausgeführt hätten, und kein Maß an Einfluss auf pepsi-httpd bringt sie zurück. Verwenden Sie die Option, um eine Absicht zu erklären; entfernen Sie das Paket, um sie durchzusetzen.
Die letzte Zeile ist ein Versprechen, keine Prüfung: Mit APPLIER = yes reiht die Konsole bereitwillig Aufgaben ein, ob sie etwas leert oder nicht. Sie existiert für die Installationen, die die Probe wirklich nicht sehen kann: ein cron-Job, der die Warteschlange leert, ein Host ohne systemd oder Unit-Dateien, die irgendwo installiert sind, wo systemd nicht sucht. Sie ist die eine Stelle in diesem Mechanismus, an der der Code einem Betreiber aufs Wort glaubt.
Es gibt einen von Hand hergestellten Zustand, den die Paketierung nicht erzeugen kann: der Socket vorhanden und beschreibbar, während die Service-Unit maskiert oder kaputt ist. Die Probe liest das als verfügbar, die Aufgabe wird eingereiht und bleibt pending. Die Aufgabenseite zeigt diesen Status, statt etwas anderes vorzugeben. Beide Units werden in einem Paket ausgeliefert, sodass es bewusster Anstrengung bedarf, diesen Zustand zu erreichen.
5.5. Siehe auch¶
Installation — die Installation auf beiden Wegen sowie die Konten, Gruppen und privilegierten Bits, die das postinst des Pakets pepsi anlegt. Aktualisierungen, Entfernung und Dienstzustand — was Aktualisieren, Entfernen und Neuinstallieren mit den laufenden Diensten tut. Bedrohungsmodell (Eine kompromittierte Komponente) und Sicherheitsmodell — das Bedrohungsmodell, in dem diese Aufteilung eine Abmilderung ist, insbesondere was ein Angreifer, der pepsi-httpd übernimmt, erhält und was nicht. Die Verwaltungskonsole und Die administrative API — die Konsolen- und API-Oberflächen, die nur lesend werden. pepsi-setup — das Vertrauensmodell des Appliers, seine geschlossene Aufgabenliste und seine Zulassungsprüfungen. pepsi-httpd — die Erkennung, die freigeschalteten Endpunkte und [pepsi-admin] in Referenzform.