Reporting

Administration -> Reporting versendet eine periodische E-Mail-Zusammenfassung offener Funde an genau die Personen, die etwas tun können: die Jira-Projektverantwortlichen jedes Projekts im Scope.

Der ganze Sinn dahinter ist, dass sich niemand am Scanner anmelden muss, um zu erfahren, dass sein Projekt offene Funde hat. Reports enthalten ausschliesslich Projektschlüssel und Anzahlen je Schweregrad - nie einen Trefferwert und keinen Ausschnitt des Textes darum herum.

Mailserver

Feld	Hinweise
SMTP-Host	Hostname Ihres Mailservers.
SMTP-Port	Typischerweise 587 mit STARTTLS oder 25 bei einem internen Relay.
SMTP-Benutzername	Optional. Bei einem unauthentifizierten internen Relay leer lassen.
SMTP-Passwort	Optional. Verschlüsselt gespeichert mit demselben Schlüssel wie die Jira-Zugangsdaten und nach dem Speichern nie wieder angezeigt.
STARTTLS	Aktivieren, ausser Ihr Relay unterstützt es ausdrücklich nicht.
Absenderadresse	Die Absenderadresse, die Empfänger sehen und auf die sie antworten.

Kadenz

Der Zeitplan ist ein Cron-Ausdruck. Ein Dropdown bietet sinnvolle Vorgaben - Daily at 9 und Weekly at Monday 9 - und schreibt den passenden Ausdruck ins Feld; eine eigene Änderung im Feld schaltet das Dropdown auf Custom.

Ausdrücke haben sechs Felder: Sekunde Minute Stunde Tag-des-Monats Monat Wochentag. Sie werden in der Zeitzone des Servers ausgewertet, und die Seite zeigt die nächsten Auslösezeitpunkte, damit Sie prüfen können, ob Sie das gemeint haben.

• 0 0 9 * * * - täglich um 09:00 Uhr
• 0 0 9 * * MON - montags um 09:00 Uhr
• 0 0 9 1 * * - am Ersten jedes Monats um 09:00 Uhr

Eine Warnung erscheint, wenn der Ausdruck mehr als einmal täglich feuert. Das ist erlaubt, aber ein Report, der mehrmals täglich ankommt, landet in einem Ordner und wird nicht mehr gelesen.

Der Versand ist nur aktiv, solange Send reports on this schedule eingeschaltet ist.

Reporting-Scope

Hier gibt es nichts zu wählen. Das Reporting ist an eine Scan-Konfiguration gebunden, und die Seite zeigt diese Konfiguration samt ihrem Projekt-Scope rein lesend an: entweder alle zugänglichen Projekte oder die Liste der Projektschlüssel, die die Konfiguration trägt. Dieser Scope bestimmt, welche Projekte bei der Ermittlung der Empfänger berücksichtigt werden - ändern lässt er sich also nur in der Scan-Konfiguration, nicht auf dieser Seite.

Mails pro Minute (Standard 1.000) drosselt den Versand, damit ein grosser Lauf Ihr Mail-Relay nicht überfährt.

Wer einen Report erhält

Empfänger werden aus Jira ermittelt: Für jedes Projekt im Scope liest der Scanner den Projektverantwortlichen und dessen E-Mail-Adresse über die Jira-API.

• Eine E-Mail pro Person, nicht pro Projekt. Wer sechs Projekte verantwortet, erhält eine einzige Nachricht über alle sechs.
• Empfänger ohne offene Funde werden übersprungen. Eine "nichts zu tun"-Mail erzieht Menschen dazu, den Report zu ignorieren, also wird sie nicht gesendet. Die Anzahl übersprungener Empfänger steht beim letzten Lauf.
• Unterdrückte Funde bleiben aussen vor, genau wie in der Fundliste.
• Projekte, deren Verantwortlicher keine E-Mail-Adresse in Jira hat, können nicht berichtet werden. Sie werden als Projekte ohne E-Mail-Adresse gezählt, damit die Lücke sichtbar statt still ist.

Was die E-Mail enthält

Eine Betreffzeile mit der Gesamtzahl offener Funde und der Projektanzahl, dann je Projekt: Projektschlüssel, Anzahl offener Funde, Aufschlüsselung nach Schweregrad und ein Link in die Fundliste des Scanners, vorgefiltert auf dieses Projekt.

Diese Links werden aus APP_BASE_URL gebildet. Ist die Variable nicht gesetzt, erhalten Empfänger localhost-Links, die sie nicht öffnen können - siehe Produktivbetrieb.

Letzter Lauf

Die Seite zeigt den jüngsten Lauf: Status, Auslöser (geplant oder manuell), Start- und Endzeit, gesendete E-Mails, übersprungene Empfänger, Projekte ohne E-Mail-Adresse sowie eine Fehleranzahl mit bereinigter Zusammenfassung.

Ein Zustellfehler bei einem Empfänger bricht den Lauf nie ab - die übrigen Empfänger werden weiterhin bedient, und der Lauf wird als fehlgeschlagen gemeldet, damit das Problem sichtbar bleibt. Jeder Lauf wird im Audit-Log als REPORT_RUN_COMPLETED festgehalten.

Report jetzt ausführen löst einen Lauf sofort mit der gespeicherten Konfiguration aus. Nützlich, um eine Änderung zu prüfen, ohne auf den Zeitplan zu warten.

Test-E-Mail senden

Geben Sie eine beliebige Empfängeradresse ein und senden Sie. Das testet ausschliesslich die SMTP-Einstellungen - keine Funde, keine Jira-Abfrage - und trennt so Mailserver-Probleme von der Reporting-Logik. Fehler liefern eine bereinigte Meldung; SMTP-Antworten können Zugangsdaten zurückspiegeln, deshalb wird der Rohtext nie angezeigt.

Konfigurieren Sie den Mailserver, speichern Sie, und senden Sie eine Test-E-Mail, bevor Sie den Zeitplan einschalten.