Hilfe PhishTrainer: Meldungen
Meldungen einrichten, sichten und Webhooks anbinden
Auf dieser Seite
Wozu Meldungen dienen
Ihre Mitarbeitenden erhalten zweifelhafte E-Mails: echtes Phishing, Spam oder PhishTrainer-Simulationen. Mit einer Meldung leiten sie diese E-Mails an Ihr Sicherheitsteam weiter, das sie in PhishTrainer wiederfindet.
- Eingang: Eine oder mehrere Quellen bringen die gemeldeten E-Mails in PhishTrainer (Menü Einstellungen, Seite Eingang der Meldungen).
- Sichtung: Die Seite Verdächtige E-Mails fasst die gemeldeten E-Mails zusammen; Sie klassifizieren jede (Phishing, Spam, harmlos …). PhishTrainer-Simulationen werden erkannt und ihrer Kampagne zugeordnet.
- Integration: Webhooks (Menü Einstellungen, Seite Webhooks) senden PhishTrainer-Daten an eine andere Anwendung, zum Beispiel ein SIEM oder ein Ticketsystem.
Meldequellen
Eine Quelle beschreibt den Weg einer gemeldeten E-Mail zu PhishTrainer. Es gibt zwei Arten, die im Fenster Meldequelle hinzufügen angezeigt werden:
- PhishTrainer ruft ein Postfach ab: Ihre Mitarbeitenden leiten die verdächtige E-Mail an eine eigene Adresse weiter (zum Beispiel meldung@ihre-domain.ch), die PhishTrainer in regelmässigen Abständen liest;
- Eine Schaltfläche „Melden“ im E-Mail-Programm: Ein Add-In fügt eine Schaltfläche im E-Mail-Programm hinzu; die E-Mail geht direkt an PhishTrainer, ohne Zwischenpostfach.
| Quelle | Für | Was Sie brauchen |
|---|---|---|
| Postfach (IMAP) | Ein Meldepostfach bei einem beliebigen Anbieter | Die Adresse des IMAP-Servers, einen Benutzernamen und ein Passwort |
| Microsoft-365-Postfach | Ein Microsoft-365-Meldepostfach, gelesen über Microsoft Graph ohne Postfachpasswort; funktioniert mit der in Outlook integrierten Schaltfläche „Melden“ | Einen Microsoft-365-Administrator, der das Postfach einmalig vorbereitet |
| Outlook für Windows (VSTO) | Klassisches Outlook auf Windows-Arbeitsplätzen | Eine MSI-Datei auf jedem Arbeitsplatz installieren, von Hand oder per Verteilung |
| Outlook Microsoft 365 | Outlook im Web, neues Outlook, Outlook mobil | Einen Microsoft-365-Administrator, der das Add-In verteilt |
| Gmail (Google Workspace) | Die Gmail-Postfächer Ihrer Organisation | Einen Google-Workspace-Administrator, der das Add-on installiert |
Sie können mehrere Quellen einrichten und kombinieren, zum Beispiel ein Meldepostfach und ein Outlook-Add-In. Jede wird unabhängig aktiviert.
Quelle hinzufügen
- Öffnen Sie im Extranet das Menü Einstellungen und dann die Seite Eingang der Meldungen.
- Klicken Sie in der Karte Meine Empfangsquellen auf Quelle hinzufügen.
- Wählen Sie den Quellentyp. Das passende Formular öffnet sich, mit einem Hinweis darauf, was Sie brauchen.
- Füllen Sie das Formular aus (siehe folgende Abschnitte) und klicken Sie auf Speichern.
Quelle: Postfach (IMAP)
Richten Sie zuerst bei Ihrem E-Mail-Anbieter ein Postfach für Meldungen ein. Wählen Sie dann Postfach (IMAP) und füllen Sie die Felder aus. Mit Sternchen markierte Felder sind Pflichtfelder.
| Feld | Einzugebender Wert |
|---|---|
| Name der Quelle: | Frei wählbarer Name, um die Quelle in der Liste zu erkennen. |
| IMAP-Server: | Adresse des IMAP-Servers Ihres Anbieters, zum Beispiel imap.beispiel.ch. |
| IMAP-Port: | Zahl zwischen 1 und 65535: in der Regel 993 für direktes TLS, 143 für STARTTLS. |
| Verschlüsselung: | Direktes TLS (in der Regel Port 993) oder STARTTLS (in der Regel Port 143). Die Verbindung ist immer verschlüsselt, bevor Benutzername und Passwort gesendet werden; unterstützt der Server STARTTLS nicht, schlägt der Abruf fehl. Einen unverschlüsselten Modus gibt es nicht. |
| Benutzer: und Passwort: | Zugangsdaten des Meldepostfachs. Beim Bearbeiten lassen Sie das Passwort leer, um das aktuelle zu behalten. |
| Ordner: | Zu lesender Ordner. Vorgeschlagener Wert: INBOX (Posteingang). |
| Abrufhäufigkeit (Minuten): | Abstand zwischen zwei Abrufen, in ganzen Minuten: mindestens 60 (vorgeschlagener Wert). |
| Nach dem Abruf: | Was PhishTrainer nach dem Abruf mit der Nachricht im Postfach tut: Unverändert lassen (Standard), Als gelesen markieren, Als ungelesen markieren oder Nachricht löschen. |
| Abruf aktiviert | Schalter: Das Postfach wird nur abgerufen, wenn er eingeschaltet ist. |
| Zertifikatsfehler ignorieren | Ausgeschaltet lassen, ausser bei einem internen Server mit einem Zertifikat, von dem Sie wissen, dass es nicht anerkannt ist. |
Testen, dann speichern
- Klicken Sie unten im Fenster auf Verbindung testen. Bei Erfolg zeigt PhishTrainer die Anzahl ungelesener E-Mails im Ordner an.
- Klicken Sie auf Speichern. Die Quelle erscheint unter Meine Empfangsquellen.
Was Sie Ihren Mitarbeitenden sagen
Teilen Sie ihnen die Adresse des Meldepostfachs mit. Bitten Sie sie, die verdächtige E-Mail als Anhang weiterzuleiten, wenn das E-Mail-Programm dies erlaubt: PhishTrainer analysiert dann die ursprüngliche E-Mail unverändert. Eine normale Weiterleitung (im Nachrichtentext) wird ebenfalls angenommen, der ursprüngliche Absender wird dann aber nur gefunden, wenn er im weitergeleiteten Block lesbar bleibt.
Quelle: Microsoft-365-Postfach (Graph)
PhishTrainer liest ein Exchange-Online-Postfach über Microsoft Graph, mit einer in Ihrem Microsoft Entra registrierten Anwendung, ohne Postfachpasswort. Die Anwendung hat nur Lesezugriff auf dieses eine Postfach. Zusammen mit der in Outlook integrierten Schaltfläche „Melden“ empfängt diese Quelle die E-Mails, die Ihre Mitarbeitenden mit dieser Schaltfläche melden.
Zwei Vorgehensweisen
Wählen Sie Microsoft-365-Postfach. Das Fenster zeigt links die Anleitung (Microsoft 365 vorbereiten) und rechts die auszufüllenden Felder. Zwei Methoden stehen zur Wahl: Manuell (empfohlen), wobei Sie jede Einstellung in den Microsoft-Portalen vornehmen, oder Mit dem Skript, ein PowerShell-Skript, das die Einstellungen für Sie vornimmt. Das Fenster beschreibt jeden Schritt im Detail; hier der Ablauf.
Methode „Manuell“
- Outlook-Schaltfläche „Melden“: Deklarieren Sie im Microsoft-Defender-Portal das Meldepostfach als SecOps-Postfach (erweiterte Zustellung) und leiten Sie die gemeldeten Nachrichten dorthin (vom Benutzer gemeldete Einstellungen).
- Anwendung in Entra erstellen: Erstellen Sie unter App-Registrierungen eine Anwendung namens „PhishTrainer - Reporting“ (nur Konten in diesem Verzeichnis, keine API-Berechtigung) und danach einen geheimen Clientschlüssel. Übertragen Sie Mandanten-ID, Anwendungs-ID, Geheimnis und Ablaufdatum in die Felder rechts.
- Der Anwendung das Lesen dieses einen Postfachs erlauben: Kopieren Sie die Objekt-ID der Anwendung aus Unternehmensanwendungen (nicht die aus den App-Registrierungen) in das Feld Objekt-ID (Unternehmensanwendung), klicken Sie auf Befehle vorbereiten und führen Sie die angezeigten Befehle in PowerShell 7 mit einem Exchange-Administratorkonto aus. Der letzte Befehl muss „InScope : True“ anzeigen.
- Klicken Sie auf Speichern und dann auf Verbindung testen.
Methode „Mit dem Skript“
- Geben Sie die Adresse des Meldepostfachs im Feld Meldepostfach ein.
- Laden Sie das Skript herunter und entsperren Sie es mit dem angezeigten Befehl. Es läuft in PowerShell 7.2 oder neuer, auf einem mit dem Internet verbundenen Arbeitsplatz, nicht auf einem Active-Directory-Server.
- Klicken Sie auf Befehl erzeugen, kopieren Sie ihn und führen Sie ihn aus. Mit
-Simulationsehen Sie, was das Skript tun würde, ohne etwas zu ändern. - Melden Sie sich mit einem Microsoft-365-Administratorkonto an (Exchange-Administrator und Anwendungsadministrator, oder globaler Administrator). Das Skript zeigt an, was es tun wird, und wartet auf Ihre Bestätigung: Antworten Sie mit
yes. - Übertragen Sie die fünf am Ende angezeigten Werte in die Felder rechts. Das Geheimnis wird nur einmal angezeigt. Klicken Sie dann auf Speichern und auf Verbindung testen.
Felder der Quelle
| Feld | Wert |
|---|---|
| Name der Quelle: | Frei wählbarer Name, um die Quelle in der Liste zu erkennen. |
| Meldepostfach | Adresse des Exchange-Online-Postfachs, das die Meldungen empfängt (seine Hauptadresse, falls es mehrere hat). Wert aus dem Skript: Reporting mailbox. |
| Mandanten-ID | GUID, in Entra auf der Seite der Anwendung angezeigt, „Verzeichnis-ID (Mandant)“. Wert aus dem Skript: Tenant ID. |
| Anwendungs-ID (Client) | GUID auf derselben Seite. Wert aus dem Skript: Application (client) ID. |
| Geheimer Schlüssel und Ablauf des Geheimnisses | Der „Wert“ des geheimen Clientschlüssels (nicht seine ID) und sein Ablaufdatum, in der Zukunft. Beim Bearbeiten lassen Sie das Feld leer, um das aktuelle Geheimnis zu behalten. Werte aus dem Skript: Secret und Secret expiry. |
| Zu lesender Ordner: | Unter Leseeinstellungen: Posteingang (Standard) oder Anderer Ordner (Name):. Gelesene E-Mails bleiben im Postfach. |
| Abrufhäufigkeit (Minuten): und Abruf aktiviert | Wie bei einer IMAP-Quelle: mindestens 60 Minuten. |
Nach dem Speichern
Exchange-Berechtigungen brauchen 30 Minuten bis 2 Stunden, bis sie gelten: Ein abgelehnter Test direkt nach dem Speichern ist normal, versuchen Sie es später erneut. Der Test liest keine Nachricht; er zeigt an, ob das Postfach leer ist oder abzurufende Nachrichten enthält.
-RenewSecret erneut ausführen) und geben Sie das neue Geheimnis und sein Datum in der Quelle ein. Sonst stoppt der Abruf. Um alles aus Ihrem Microsoft 365 zu entfernen, führen Sie das Skript mit -Remove -ReportingMailbox und der Adresse des Postfachs aus.Quellen: Meldeschaltflächen im E-Mail-Programm
Die drei Add-Ins (Outlook für Windows (VSTO), Outlook Microsoft 365, Gmail (Google Workspace)) werden gleich hinzugefügt: Typ wählen, Name der Quelle: ausfüllen, prüfen, dass Empfang aktiviert eingeschaltet ist, und speichern. Die Quelle zeigt dann einen Aktivierungscode und die Registerkarten Einstellungen, Installation, Nachricht an Mitarbeitende sowie Registrierte Geräte (VSTO) oder Verknüpfungen und Benutzer (Microsoft 365, Gmail). Die Option E-Mail nach der Meldung löschen verschiebt die gemeldete E-Mail in die gelöschten Elemente der Mitarbeitenden, wo sie wiederherstellbar bleibt.
Für die Verteilung jedes Add-Ins gibt es einen eigenen Leitfaden:
Quellen überwachen und verwalten
Jede Quelle in der Liste Meine Empfangsquellen trägt ein Abzeichen Aktiviert oder Deaktiviert. Quellen, die ein Postfach abrufen, zeigen Letzter Abruf: und den letzten Fehler, falls vorhanden; Add-Ins zeigen Letzte empfangene Meldung:. Verfügbare Aktionen:
| Aktion | Wirkung |
|---|---|
| Bearbeiten | Öffnet das Formular erneut. Gespeicherte Passwörter und Geheimnisse werden nie wieder angezeigt: Lassen Sie das Feld leer, um sie zu behalten. |
| Deaktivieren | Stoppt den Abruf, bei einem Add-In den Empfang, ohne die Konfiguration zu löschen. |
| Aktivieren | Nimmt den Abruf oder Empfang wieder auf. |
| Löschen | Stoppt die Quelle und löscht ihre Konfiguration. Diese Aktion ist endgültig. |
Meldungen sichten
Öffnen Sie Verdächtige E-Mails im PhishTrainer-Menü oder klicken Sie auf der Seite der Quellen auf Verdächtige E-Mails anzeigen. Eine von mehreren Mitarbeitenden gemeldete E-Mail erscheint nur einmal: Ihre Klassifizierung gilt für alle.
Überblick
Die Karte Überblick zeigt für den gewählten Zeitraum der Statistiken (7 Tage bis 12 Monate): die Anzahl Gemeldete E-Mails, die Zu analysieren, den Anteil der PhishTrainer-Simulationen, die Verteilung nach Analyseergebnis und nach gemeldetem Typ (Gemeldet als) sowie die Zu analysierende Domänen und die Als Phishing oder Spam klassifizierte Domänen. Ein Klick auf eine Domäne filtert die Liste auf ihre E-Mails.
Liste der E-Mails
Die Registerkarten filtern nach Ergebnis: Alle, Zu analysieren, Phishing, Spam, Harmlos, Unbestimmt, PhishTrainer-Simulationen. Weitere Filter: Absenderdomäne, Gemeldet als (Phishing oder Spam, wie von der meldenden Person angegeben), Gemeldete Interaktionen und Zeitraum. Sortieren nach bietet Neueste zuerst, Am längsten zu analysieren und Am häufigsten gemeldet. Zu analysierende E-Mails sind hervorgehoben.
Details einer E-Mail
Klicken Sie auf eine Zeile, um Details der E-Mail zu öffnen: Absender, Betreff, Datum der ersten und letzten Meldung, Typ, Ergebnis, Letzte Klassifizierung (wer und wann), dann Mitarbeitende, die sie erhalten haben, Nachrichteninhalt, Indikatoren (URLs, Domänen, Absender, IP-Adressen, Prüfsummen von Anhängen) und Anhänge (Name, Typ, Grösse, SHA-256). Der Inhalt wird in einem abgeschotteten Rahmen angezeigt; Anhänge lassen sich nicht herunterladen.
Eine E-Mail klassifizieren
- Klicken Sie in der Liste am Ende der Zeile auf das Symbol des gewünschten Ergebnisses, oder öffnen Sie die Details.
- Wählen Sie in den Details das Ergebnis nach Diese E-Mail klassifizieren als:.
- Die Klassifizierung gilt für alle Meldungen dieser E-Mail. Sie können sie später ändern: Die letzte Klassifizierung gilt.
| Ergebnis | Wann verwenden |
|---|---|
| Phishing | Ein echter Phishing-Versuch. |
| Spam | Unerwünschte Nachricht ohne nachgewiesene Betrugsabsicht. |
| Harmlos | Eine legitime E-Mail, aus Vorsicht gemeldet. |
| Unbestimmt | Mit den vorliegenden Angaben nicht zu entscheiden. |
| PhishTrainer-Simulation | Nur in den Details angeboten: um eine Simulation zu korrigieren, die PhishTrainer nicht erkannt hat. |
Jede Meldung hat einen Status: Zu analysieren, In Analyse oder Klassifiziert. Eine E-Mail ohne Klassifizierung wird als Zu analysieren angezeigt.
PhishTrainer-Simulationen
Meldet eine mitarbeitende Person eine Simulations-E-Mail, erkennt PhishTrainer sie und klassifiziert sie automatisch (Letzte Klassifizierung: Automatisch). Der Link Kampagnenergebnisse anzeigen öffnet die betreffende Kampagne. Nicht zugeordnete PhishTrainer-Simulation kennzeichnet eine erkannte Simulation, zu der keine Kampagne gefunden wurde.
Gemeldete Interaktionen
Bei einigen Add-Ins gibt die meldende Person an, was sie mit der E-Mail getan hat: Link geklickt, Anhang geöffnet, Zugangsdaten eingegeben, geantwortet oder angerufen. Das Abzeichen Hat interagiert steht für eingegebene Zugangsdaten oder einen geöffneten Anhang; Interaktion gemeldet für einen geklickten Link, eine Antwort oder einen Anruf. Beim Abruf eines Postfachs wird die Frage nicht gestellt (Nicht abgefragt). Der Filter Mit riskanter Interaktion zeigt nur diese E-Mails.
Webhooks
Ein Webhook ist eine Webadresse (URL) Ihrer Anwendung, an die PhishTrainer im Verlauf Ihrer Kampagnen Daten sendet. Damit versorgen Sie ein SIEM, ein Ticketsystem oder einen Team-Chat, ohne das Extranet von Hand zu prüfen.
Webhook anlegen
- Öffnen Sie das Menü Einstellungen und dann Webhooks.
- Klicken Sie auf Neuen Webhook hinzufügen.
- Name: frei wählbar, mindestens 5 Zeichen.
- URL: vollständige Adresse der Anwendung, welche die Daten empfängt, zum Beispiel
https://siem.ihre-domain.ch/phishtrainer. Verwenden Sie eine Adresse mithttps://. - Secret: freiwillig, aber empfohlen. Geben Sie eine lange Zufallszeichenfolge ein, die nur PhishTrainer und Ihre Anwendung kennen: Sie dient zum Signieren der Sendungen.
- Schalten Sie Ist aktiv? ein (Daten werden nur an aktive Webhooks gesendet) und klicken Sie auf Webhook speichern.
Format der Sendungen
Jede Sendung ist eine HTTP-Anfrage POST, deren Inhalt ein JSON-Dokument ist. Ihre Anwendung muss mit einem HTTP-Code unter 400 antworten: Ein Code ab 400 oder keine Antwort innert 10 Sekunden gilt als Fehlschlag. Weiterleitungen werden nicht verfolgt. Gesendete Kopfzeilen:
Signatur prüfen
Ist ein Secret hinterlegt, fügt PhishTrainer die Kopfzeile X-Gophish-Signature hinzu, in der Form sha256= gefolgt von einer hexadezimalen Signatur. Diese Signatur ist der HMAC-SHA256 des unveränderten Anfrageinhalts, berechnet mit dem Secret als Schlüssel. Zur Prüfung berechnet Ihre Anwendung diesen HMAC über den empfangenen Inhalt, vor jeder JSON-Dekodierung, und vergleicht ihn mit dem Wert der Kopfzeile. Weisen Sie jede Anfrage ohne diese Kopfzeile oder mit abweichender Signatur zurück.
hash_equals in PHP, hmac.compare_digest in Python) und schreiben Sie das Secret nie in ein Protokoll.Ändern oder löschen
Die Liste zeigt Titel, URL und Status jedes Webhooks. Die Schaltflächen Diesen Webhook bearbeiten und Diesen Webhook löschen wirken auf die Zeile. Das Löschen ist endgültig. Um Sendungen auszusetzen, ohne die Konfiguration zu verlieren, schalten Sie Ist aktiv? aus.
Fehlerbehebung
| Meldung oder Symptom | Was tun |
|---|---|
| „Verbindung zum Postfach nicht möglich“ (IMAP) | Prüfen Sie Server, Port, Verschlüsselung und Zugangsdaten. Der Port muss zum Modus passen: in der Regel 993 für direktes TLS, 143 für STARTTLS. |
| „Das Postfach kann nicht gelesen werden“ oder „Der zu lesende Ordner wurde im Meldepostfach nicht gefunden“ | Prüfen Sie den genauen Namen des zu lesenden Ordners. Bei Microsoft 365: Tragen mehrere Ordner diesen Namen, benennen Sie einen um. |
| Hinweis „ohne Verschlüsselung gespeichert“ bei einer IMAP-Quelle | Die Quelle wird nicht mehr abgerufen. Öffnen Sie sie, wählen Sie einen Verschlüsselungsmodus, testen Sie die Verbindung und speichern Sie. |
| Microsoft-365-Test direkt nach dem Speichern abgelehnt, oder „Die Berechtigungen werden bei Microsoft noch verteilt“ | Normal: Exchange-Berechtigungen brauchen bis zu 2 Stunden. Versuchen Sie es später erneut. |
| „Microsoft verweigert den Zugriff auf das Meldepostfach“ | Führen Sie das Skript erneut aus, es prüft und korrigiert die Berechtigungen, oder prüfen Sie die Exchange-Befehle aus Schritt 3 der manuellen Methode. |
| „Das Geheimnis der Anwendung ist abgelaufen“ oder „Microsoft hat die Anmeldung der Anwendung abgelehnt“ | Prüfen Sie Mandant, Anwendung und Geheimnis. Erstellen Sie bei Bedarf ein neues Geheimnis (Skript mit -RenewSecret) und geben Sie es mit seinem Ablaufdatum in der Quelle ein. |
| Warnung: Die Anwendung verfügt über Microsoft-Berechtigungen | Die Anwendung darf keine API-Berechtigung haben. Entfernen Sie diese in Entra und führen Sie das Skript erneut aus. |
| „Kein Agent hat rechtzeitig geantwortet“ (verschlüsselte Organisation) | Prüfen Sie, ob der Bexxo-Protected-Agent Ihrer Organisation gestartet und verbunden ist, und starten Sie den Test erneut. |
| Eine gemeldete E-Mail erscheint nicht unter Verdächtige E-Mails | Prüfen Sie, ob die Quelle Aktiviert ist, und sehen Sie sich Letzter Abruf: und den letzten Fehler an. Ein Postfach wird nur in der gewählten Häufigkeit abgerufen (mindestens 60 Minuten). |
| Meldende Person als „Meldende Person nicht erkannt“ angezeigt | Die Adresse, welche die E-Mail weitergeleitet hat, entspricht keinem PhishTrainer-Ziel Ihrer Organisation. Prüfen Sie Ihre Zielliste. |
| Webhook: keine Daten empfangen | Prüfen Sie, dass Ist aktiv? eingeschaltet ist, dass die URL aus dem Internet erreichbar ist und dass Ihre Anwendung innert 10 Sekunden mit einem Code unter 400 antwortet, ohne Weiterleitung. |
Keine Antwort gefunden? Kontakt aufnehmen