# Konfigurationsreferenz

Alle Einstellungen erreichen Sie über die Schaltfläche **Optionen** oben rechts in jeder Ansicht von Mail Log. Diese Seite listet jede Option mit ihrer Voreinstellung. Einige Bereiche sind in eigenen Kapiteln ausführlicher beschrieben; hier finden Sie den vollständigen Überblick.

<div class="callout info" id="bkmrk-die-voreinstellungen">Die Voreinstellungen sind bewusst datensparsam gewählt und für die meisten Websites passend. Ändern Sie vor allem im Bereich *Body-Speicherung* und *Sensible Inhalte* nur, was Sie verstanden haben.

</div>## Logging

<table class="table" id="bkmrk-optionstandardbedeut"> <thead> <tr><th scope="col">Option</th><th scope="col">Standard</th><th scope="col">Bedeutung</th></tr> </thead> <tbody> <tr><td>Logging aktivieren</td><td>Ja</td><td>Hauptschalter. Aus = keine neuen Einträge; vorhandene bleiben zugänglich.</td></tr> <tr><td>Fehlgeschlagene Mails protokollieren</td><td>Ja</td><td>Auch Mails erfassen, die der Mailer als nicht versendet meldet.</td></tr> <tr><td>Kontexte protokollieren</td><td>Frontend, Backend, CLI, API</td><td>Wo protokolliert wird. Die vier Bereiche sind unabhängig wählbar.</td></tr> <tr><td>Quell-Erweiterung erkennen</td><td>Ja</td><td>Ermittelt die auslösende Erweiterung (Best-Effort). Abschalten spart minimal Aufwand pro Mail.</td></tr> </tbody></table>

## Body-Speicherung

<table class="table" id="bkmrk-optionstandardbedeut-1"> <thead> <tr><th scope="col">Option</th><th scope="col">Standard</th><th scope="col">Bedeutung</th></tr> </thead> <tbody> <tr><td>Speichermodus</td><td>Metadaten + erste N KB</td><td>Wie viel Text abgelegt wird (siehe Kapitel *Body-Speicherung, Verschlüsselung und sensible Inhalte*). Wirkt nur auf neue Einträge.</td></tr> <tr><td>Body-Aufbewahrung (Tage)</td><td>30</td><td>Nur bei „Vollständig, automatisches Löschen": nach dieser Frist entfernt der Task den Text.</td></tr> <tr><td>Zu behaltende Body-Größe (KB)</td><td>4</td><td>Nur bei „Metadaten + erste N KB": wie viele Kilobytes vom Anfang gespeichert werden.</td></tr> <tr><td>Maximale Body-Größe (KB)</td><td>1024</td><td>Globale Obergrenze. Größere Bodies werden gekürzt und markiert.</td></tr> <tr><td>Verschlüsselungs-Key</td><td>—</td><td>Reine Statusanzeige. Der Schlüssel wird aus dem geheimen Joomla-Schlüssel abgeleitet; nichts einzutragen.</td></tr> </tbody></table>

## Rohes MIME

<table class="table" id="bkmrk-rohes-mime-speichern"> <tbody> <tr><td>Rohes MIME speichern</td><td>**Nein**</td><td>Die exakte RFC822-Nachricht ablegen (für saubere .eml-Downloads). Aus Datenschutzgründen ab Werk aus.</td></tr> <tr><td>Rohes MIME verschlüsseln</td><td>Nein</td><td>Dieselbe Verschlüsselung wie für Bodies auf das MIME anwenden.</td></tr> </tbody></table>

## Anhänge

<table class="table" id="bkmrk-anh%C3%A4nge-erfassenjaje"> <tbody> <tr><td>Anhänge erfassen</td><td>Ja</td><td>Jeden Anhang beim Versand auf die Festplatte kopieren.</td></tr> <tr><td>Speicherpfad</td><td>leer (= sicherer Standard außerhalb des Web-Roots)</td><td>Ablageort der Anhänge.</td></tr> <tr><td>Max. pro Datei (MB)</td><td>10</td><td>Größere Anhänge werden übersprungen; Metadaten bleiben.</td></tr> <tr><td>Gesamt-Speicherbudget (MB)</td><td>500</td><td>Bei Überschreitung werden neue Anhänge bis zum nächsten Cleanup übersprungen.</td></tr> </tbody></table>

## Sensible Inhalte

<table class="table" id="bkmrk-behandlung-sensibler"> <tbody> <tr><td>Behandlung sensibler Mails</td><td>Nur Metadaten</td><td>Wie Mails behandelt werden, die auf die Betreff-Muster passen: nur Metadaten, normal oder gar nicht protokollieren.</td></tr> <tr><td>Betreff-Muster</td><td>`/password/i`, `/passwort/i`, `/reset/i`, `/token/i`, `/2fa/i`, `/verify/i`, `/verifizier/i`</td><td>Ein regulärer Ausdruck pro Zeile. Passt der Betreff, gilt die Mail als sensibel.</td></tr> <tr><td>Body-Masking-Muster</td><td>`/token=…/`, `/key=…/`</td><td>Treffer werden im gespeicherten Body durch `***` ersetzt.</td></tr> </tbody></table>

## Aufbewahrung

<table class="table" id="bkmrk-eintrag-aufbewahrung"> <tbody> <tr><td>Eintrag-Aufbewahrung (Tage)</td><td>180</td><td>Ältere Einträge entfernt der Task „Logs bereinigen". 0 = keine altersbasierte Bereinigung.</td></tr> <tr><td>Maximale Eintragszahl</td><td>0 (aus)</td><td>FIFO-Obergrenze: älteste Einträge werden entfernt, sobald die Grenze überschritten ist.</td></tr> <tr><td>Anhang-Aufbewahrung (Tage)</td><td>30</td><td>Ältere Anhang-Dateien entfernt der Anhang-Cleanup-Task.</td></tr> </tbody></table>

## Anzeigeregeln

<table class="table" id="bkmrk-matchalle-%28und%29ob-ei"> <tbody> <tr><td>Match</td><td>Alle (UND)</td><td>Ob eine Zeile alle oder beliebige Regeln erfüllen muss, um ausgeblendet zu werden.</td></tr> <tr><td>Regeln</td><td>leer</td><td>Blenden passende Einträge aus Liste und Statistik aus, ohne sie zu löschen. Siehe Kapitel *Log-Regeln und Anzeigeregeln*.</td></tr> </tbody></table>

## Log-Regeln

<table class="table" id="bkmrk-matchbeliebige-%28oder"> <tbody> <tr><td>Match</td><td>Beliebige (ODER)</td><td>Ob eine Mail alle oder beliebige Regeln treffen muss.</td></tr> <tr><td>Modus</td><td>Passende ausschließen</td><td>Passende ausschließen oder nur passende einschließen.</td></tr> <tr><td>Regeln</td><td>leer</td><td>Entscheiden vor dem Speichern, welche Mails überhaupt protokolliert werden.</td></tr> </tbody></table>

## Benachrichtigungen

<table class="table" id="bkmrk-benachrichtigungen-a"> <tbody> <tr><td>Benachrichtigungen aktivieren</td><td>Nein</td><td>Warnen, wenn eine Zustellung fehlschlägt.</td></tr> <tr><td>Super Admins benachrichtigen</td><td>Ja</td><td>An Super Users mit aktivierten System-E-Mails.</td></tr> <tr><td>Zusätzliche Empfänger</td><td>leer</td><td>Weitere Adressen.</td></tr> <tr><td>Throttle-Fenster (Minuten)</td><td>30</td><td>Mindestabstand zwischen zwei Alerts.</td></tr> <tr><td>Zusätzlich als Joomla-Privatnachricht</td><td>Nein</td><td>Alert auch intern (com\_messages) ablegen.</td></tr> </tbody></table>

## Dashboard

<table class="table" id="bkmrk-statistik-moduslivel"> <tbody> <tr><td>Statistik-Modus</td><td>Live</td><td>*Live* rechnet bei jedem Aufruf aus den Einträgen. *Task* nutzt vor-aggregierte Tageswerte, die der Statistik-Task pflegt — schneller bei sehr vielen Einträgen.</td></tr> <tr><td>Standard-Zeitraum</td><td>Letzte 30 Tage</td><td>Voreingestellter Zeitraum des Diagramms.</td></tr> <tr><td>Letzte Mails anzeigen</td><td>10</td><td>Wie viele Einträge die Dashboard-Listen zeigen.</td></tr> </tbody></table>

## Rechte

Der Standard-Reiter von Joomla. Welche Aktion welches Recht braucht, steht im Kapitel [Rechte, Export und Datenschutz](https://docs.graup-it.de/books/mail-log/page/rechte-export-und-datenschutz).

<small>Gilt für Version 1.0.4.</small>