95.1.58. pepsi-quota

Manage and reconcile per-account mailbox quotas

Handbuchabschnitt:

1

95.1.58.1.1. Name

pepsi-quota - Postfach-Quotas je Konto setzen und Postfächer neu vermessen.

95.1.58.1.2. Übersicht

pepsi-quota [GLOBAL-OPTIONS] set LOGIN SIZE [–messages N]
pepsi-quota [GLOBAL-OPTIONS] unset LOGIN
pepsi-quota [GLOBAL-OPTIONS] show LOGIN
pepsi-quota [GLOBAL-OPTIONS] list [–full]
pepsi-quota [GLOBAL-OPTIONS] measure LOGIN
pepsi-quota [GLOBAL-OPTIONS] reconcile [–all]
pepsi-quota [GLOBAL-OPTIONS] remove LOGIN

GLOBAL-OPTIONS sind -c FILE, -L LOGLEVEL und -v und stehen vor dem Unterbefehl (siehe Global Options).

95.1.58.1.3. Beschreibung

pepsi-quota ist die Betreiberschnittstelle zur Tabelle pepsi.mailbox_quota: den Postfachgrenzen je Konto, die pepsi-stage-relay-to-maildir(1) durchsetzt, und der Belegungsabrechnung, mit der sowohl sie als auch pepsi-ingress(1) arbeiten. Es ist keine Stage.

Eine Quota ist eine Eigenschaft eines lokalen Kontos, sodass jeder Datensatz das passwd-Login als Schlüssel hat, nicht eine E-Mail-Adresse und nicht eine uid. Bei RCPT kann pepsi-ingress(1) einen Umschlagempfänger mit einem Login vergleichen, ohne Aliase aufzulösen (was es nicht darf und auch nicht kann). Ein Login bleibt außerdem ein einziger Datensatz, wenn mehrere Adressen ein Postfach erreichen.

95.1.58.1.3.1. Richtlinie, Messung, Schätzung

Richtlinie ist [pepsi] MAILBOX_QUOTA (der standortweite Standardwert; fehlt er, bedeutet das unbegrenzt), je Konto durch pepsi-quota set überschrieben und dort, wo das Dateisystem eines durchsetzt, durch die eigene Grenze des Kernels weiter verschärft.

Eine Messung kann nur pepsi-helper-maildir-writer(1) vornehmen, der einzige Prozess, der zum Benutzer wird und ein 0700-Maildir lesen kann. measure und reconcile führen ihn aus; nichts anderes hier berührt ein Postfach.

Die Schätzung sind die Zähler used_* + since_*. Pepsis eigene Zustellungen erhöhen sie, und nichts zieht jemals ab, denn nichts sagt Pepsi, wenn ein Benutzer Mail über IMAP löscht. Die Schätzung ist daher eine obere Schranke der tatsächlichen Belegung. Genau das macht sie als Auslöser sicher („könnte dieses Konto nahe an seiner Grenze sein? dann messen“) und als Urteil unsicher.

Daher die Regel: Nichts lehnt eine Nachricht auf eine Schätzung hin ab, sondern nur auf eine Messung hin.

95.1.58.1.3.2. Warum es reconcile gibt

Ein Konto an seiner Grenze wird von pepsi-ingress(1) bei RCPT abgelehnt. Nehmen Sie an, sein Eigentümer leert danach das Postfach über IMAP. Nichts sagt es Pepsi, und da jede Nachricht abgelehnt wird, läuft nie eine Zustellung, die eine frische Messung vornähme. Das Postfach bliebe für immer geschlossen.

Zwei Dinge verhindern das. pepsi-ingress(1) lehnt nur auf eine Messung hin ab, die jünger ist als [pepsi] MAILBOX_QUOTA_MAX_AGE (standardmäßig 15 Minuten), sodass eine veraltete Zahl die Nachricht durchlässt und der Zustellpfad erneut nachsieht. Und pepsi-quota reconcile, aus cron gestartet, misst die Konten neu, die an ihrer Grenze sind. Der Durchlauf ist gerade deshalb billig, weil er nur diese Konten erfasst.

Ein Standort, der Quotas durchsetzt, muss ihn regelmäßig ausführen. Bei einer Paketinstallation ist das bereits erledigt: pepsi-quota-reconcile.timer startet den Durchlauf fünf Minuten nach dem Booten und danach alle zehn Minuten (Persistent=true, ein verpasster Lauf wird also nachgeholt), und pepsi.target Wants= ihn, sodass der eine Schalter, der die Pipeline startet, auch dies startet. Legen Sie keinen cron-Auftrag daneben; das ergäbe zwei Durchläufe im selben Abstand, von denen jeder den setuid-Helper startet.

Bei einer Quellinstallation ohne systemd ist das Äquivalent:

*/10 * * * *  pepsi  pepsi-quota -c /etc/pepsi/pepsi.conf reconcile

95.1.58.1.4. Unterbefehle

set LOGIN SIZE [–messages N]

Gibt einem Konto seine eigene Grenze und überschreibt damit den standortweiten Standardwert. SIZE nimmt eine einfache Byte-Zahl oder ein K/M/G/T-Suffix in Potenzen von 1024 (2G, 500M, 1048576) oder das Literal none.

none ist nicht dasselbe wie unset: Es bedeutet ausdrücklich unbegrenzt und ist der Weg, ein einzelnes Konto von einer standortweiten Quota auszunehmen, während unset dessen Vererbung wiederherstellt.

Ohne --messages erbt die Grenze für die Nachrichtenzahl weiterhin [pepsi] MAILBOX_QUOTA_COUNT; eine Byte-Quota zu setzen hebt sie nicht stillschweigend auf. --messages 0 hebt sie ausdrücklich auf. Beachten Sie, dass dies eine Eigenschaft des gespeicherten Datensatzes ist, nicht des Befehls: set schreibt den ganzen Datensatz, --messages bei einem Konto wegzulassen, das bereits eine ausdrückliche Nachrichtengrenze trug, verwirft diese Grenze also und gibt sie an die Vererbung zurück. Wiederholen Sie --messages, wenn Sie für ein solches Konto eine Byte-Quota anheben; der ausgegebene Datensatz zeigt in beiden Fällen das Ergebnis.

Bei einem Login ohne passwd-Eintrag warnt der Befehl, nimmt das Login aber an, da das Konto danach angelegt werden kann.

unset LOGIN

Lässt die eigenen Grenzen des Kontos fallen, sodass es den standortweiten Standardwert wieder erbt. Die Belegungsabrechnung bleibt erhalten.

show LOGIN

Zeigt die Grenzen und die Belegung eines Kontos. Ein Konto ohne Datensatz ist kein Fehler: Es gibt den geerbten Standardwert und „nie vermessen“ aus.

list [–full]

Listet jedes Konto auf, über das Pepsi Buch geführt hat, die älteste Messung zuerst. Mit --full werden nur die aufgelistet, deren Schätzung ihre Grenze erreicht hat: die Konten, die reconcile neu vermessen würde und die nicht unbedingt über der Quota liegen. Eine leere Auflistung gibt dann (no accounts at or over their limit) statt (no accounts) aus; das ist der eine Fall, den zu unterscheiden sich lohnt.

measure LOGIN

Vermisst dieses Postfach jetzt neu und speichert das Ergebnis.

reconcile [–all]

Misst die Konten neu, deren Schätzung an oder über ihrer Grenze liegt. Mit --all auch die, deren Messung älter als [pepsi] MAILBOX_QUOTA_MAX_AGE ist. Ein nicht vermessbares Postfach (etwa ein seit der letzten Zustellung gelöschtes Konto) wird im Log vermerkt, und der Durchlauf geht weiter; der Exit-Status ist ungleich null, wenn eines fehlschlug.

remove LOGIN

Vergisst das Konto vollständig: seine Grenzen und seine Abrechnung. Die nächste Zustellung legt den Datensatz neu an und misst frisch, sodass dies auch der Knopf „diese Zahlen sind falsch, fang von vorn an“ ist.

95.1.58.1.5. Globale Optionen

Diese globalen Optionen stehen vor dem Unterbefehl (ein nachgestelltes Flag wird abgelehnt).

-c FILE, –config FILE

Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen. Anders als bei pepsi-whitelist(1) wird dies unter dem setgid-Bit nicht abgelehnt: Die unter Privileges beschriebene Prüfung des Aufrufers läuft zuerst, sodass nur root und das Dienstkonto pepsi überhaupt so weit kommen, sie zu lesen.

-L LOGLEVEL, –log LOGLEVEL

Setzt die Log-Ausführlichkeit. LOGLEVEL ist eines von error, warn, info, debug oder trace (Standardwert: [pepsi] LOG, sonst info).

-v, –verbose

Zeigt Log-Meldungen aus allen Quellen, einschließlich Drittanbieter-Bibliotheken.

-h, –help

Gibt eine Verwendungsübersicht aus und beendet sich.

-V, –version

Gibt die Version aus und beendet sich.

95.1.58.1.6. Ausgabe

list, show, set und measure geben je Konto eine Zeile aus:

alice             1200M/2G (58%)  4213 messages  measured 91s ago (maildirsize)
bob                 14M/unlimited 112 messages   measured never (-) [site default]

Die gezeigte Belegung ist die Messung plus alles seither Zugestellte, und das ist die Zahl, auf die der Zustellpfad reagiert. measured ist ein Alter statt eines Zeitstempels, weil es eine bestimmte Frage beantwortet: ob die Zahl noch glaubwürdig ist. Eine Ablehnung bei RCPT beruht darauf, dass eine Messung frisch ist.

95.1.58.1.7. Privilegien

pepsi-quota wird set-group-id auf die Gruppe pepsi-maildir installiert, aus demselben Grund wie pepsi-stage-relay-to-maildir(1): measure und reconcile führen den messenden Helper 4750 root:pepsi-maildir aus, und das Dienstkonto pepsi ist bewusst kein Mitglied dieser Gruppe. Das setgid-Bit auf den wenigen Programmen, die durchgelassen werden, ist die Schranke. Deshalb kann ein unbeaufsichtigtes reconcile aus cron Postfächer vermessen, ohne root zu sein. Der Modus ist 2550 mit Eigentümer pepsi:pepsi-maildir: Der Eigentümer darf das Programm ausführen, alle anderen nicht, weil das setgid-Bit die Schranke vor dem setuid-root-Helper ist. Das Ausführungsrecht kann auch nicht aus den Gruppenbits kommen, weil pepsi bewusst kein Mitglied der Gruppe ist.

Als root ausgeführt, wechselt es vor dem Verbinden mit der Datenbank zum Dienstkonto pepsi, der Rolle, der diese Datensätze gehören, und behält dabei die Gruppe pepsi-maildir. Läuft es aus seinem Timer als pepsi, liefert das setgid-Bit diese Gruppe, und es findet überhaupt kein Wechsel statt. Weil die Gruppe über den Wechsel hinweg erhalten bleibt, funktioniert measure für einen Betreiber, der es als root eintippt, ebenso wie aus cron. Der Lauf als root gewinnt dadurch nichts, was der Lauf aus dem Timer nicht ohnehin schon hat.

make install richtet das Bit ein (sein Schritt install-quota-tool), sofern es als root läuft und die Gruppe existiert; andernfalls gibt es die genauen Befehle aus.

Da das setgid-Bit diese Schranke ist, setzt das Programm dieselbe Regel selbst durch: Sofern der reale Benutzer nicht root oder das Dienstkonto pepsi ist, beendet es sich mit einem Fehler, bevor irgendeine Konfiguration gelesen wird. Wie die setuid-Krypto-Stages entfernt es außerdem die Umgebungsvariablen, die das Laden der Konfiguration steuern (HOME, XDG_CONFIG_HOME, PG*, TALER_*, PEPSI_*), und legt PATH auf einen sicheren Standardwert fest.

Kein unprivilegierter Aufrufer verliert durch diese Ablehnung etwas: jeder Unterbefehl liest oder schreibt pepsi.mailbox_quota, und die Peer-Authentifizierung von PostgreSQL richtet sich nach der effektiven uid, ein Aufrufer, der nicht pepsi ist (oder root, das zu pepsi wird), hätte also nie eine Verbindung aufbauen können.

95.1.58.1.8. Exit-Status

0

Erfolgreicher Abschluss.

1

Ein Fehler ist aufgetreten: Der Aufrufer ist weder root noch das Dienstkonto pepsi (unter dem setgid-Bit), eine fehlerhafte Konfiguration oder SIZE, eine fehlgeschlagene Datenbankverbindung oder -abfrage oder eine fehlgeschlagene Messung (bei reconcile, nachdem die übrigen Konten vermessen wurden). Der Grund wird in das Log geschrieben.

2

Die Befehlszeile selbst war falsch (ein unbekannter Unterbefehl oder eine unbekannte Option, oder eine globale Option nach dem Unterbefehl).

78

Das Datenbankschema gehört zu einem anderen Pepsi-Release (nicht installiert, älter, neuer oder verändert); führen Sie pepsi-setup schema aus (siehe pepsi-setup(1)).

95.1.58.1.9. Konfiguration

Die Richtlinienoptionen, die dieses Werkzeug liest, liegen alle im Abschnitt [pepsi] und sind in pepsi.conf(5) dokumentiert: MAILBOX_QUOTA, MAILBOX_QUOTA_COUNT, MAILBOX_OVER_QUOTA, MAILBOX_QUOTA_MAX_AGE, MAILBOX_QUOTA_RCPT_CHECK und MAILBOX_FS_QUOTA. Sie werden aus der effektiven Konfiguration gelesen (die Datei plus die Datenbank-Überlagerung), derselben Sicht, die die Zustell-Stage hat. Eine weitere Option, ebenfalls in [pepsi], gehört im Besonderen zu diesem Werkzeug:

MAILBOX_HELPER

(Pfad, optional) Der privilegierte Helper, den dieses Werkzeug für eine Messung ausführt. Standardwert pepsi-helper-maildir-writer, gesucht auf dem PATH des pepsi-quota-Prozesses, sofern nicht als absoluter Pfad angegeben (unter dem setgid-Bit ist das der feste System-PATH, den das Programm setzt). Die Datenbank-Konfigurationsüberlagerung darf ihn nicht setzen: Er benennt ein Programm, das mit der Gruppe pepsi-maildir läuft. Es ist dasselbe Binärprogramm, das die Zustell-Stage verwendet, in seinem measure-Modus: Ein Maildir ist 0700, es ist also der eine Prozess, der zum Benutzer werden und eines lesen kann.

Setzen Sie sie nur dort, wo der Helper unter diesem Namen nicht erreichbar ist, vor allem bei einer Quellinstallation mit --prefix, deren $PREFIX/bin nicht auf dem PATH des Timers liegt. Halten Sie sie mit der Option HELPER im eigenen [stage-<name>]-Abschnitt der Zustell-Stage im Gleichschritt (pepsi-stage-relay-to-maildir(1)): Die beiden benennen dasselbe Programm für zwei verschiedene Aufrufer, nichts gleicht sie gegeneinander ab, und Zustellung und Abgleich stimmen nur überein, wenn beide richtig sind.

95.1.58.1.10. Dateien

pepsi.mailbox_quota

Die Tabelle, die dieses Werkzeug verwaltet: ein Datensatz je Konto, der seine Grenzen, die letzte Messung und das seither Zugestellte trägt. pepsi-setup(1) legt sie mit dem übrigen Schema an; Datensätze erscheinen von selbst bei der ersten lokalen Zustellung an ein Konto, sodass niemand vorab registriert werden muss.

~/Maildir/maildirsize

Die Maildir++-Größendatei, die der Helper pflegt, in dem Format, das auch Dovecot, Courier und Exim lesen und schreiben.

95.1.58.1.11. Siehe auch

pepsi-stage-relay-to-maildir(1), pepsi-helper-maildir-writer(1), pepsi-ingress(1), pepsi-status(1), pepsi.conf(5), maildir(5), quotactl(2); das setgid-Modell und die Quota-Verfügbarkeitsregeln werden in den Kapiteln zu Sicherheit und Bedrohungsmodell des Pepsi-Handbuchs beschrieben.

95.1.58.1.12. Fehler

Melden Sie Fehler an den Pepsi-Issue-Tracker.