Hilfe PhishTrainer: Einrichtung
Outlook-Add-In für Windows: Administratorhandbuch
Das Symbol der PhishTrainer-Schaltfläche in Ihrem Postfach
Auf dieser Seite
Übersicht
Das Add-In PhishTrainer Report für Outlook für Windows fügt in Outlook eine Gruppe «PhishTrainer by Bexxo» hinzu. Ihre Mitarbeitenden verwenden sie, um eine verdächtige E-Mail (Phishing oder Spam) über PhishTrainer an die Sicherheitsabteilung Ihrer Organisation zu übermitteln.
Es handelt sich um ein VSTO-Add-In, das auf jedem Arbeitsplatz mit einem MSI-Installationsprogramm installiert wird. Als Herausgeber wird «Bexxo by tesweb SA» angezeigt. PhishTrainer ist eine Software von Bexxo, dem Cybersecurity-Bereich der Tesweb SA. Dieses Handbuch beschreibt die Version 2.2.2 des Add-Ins.
Unterstützte Versionen
- Outlook 2016, Outlook 2019 und Outlook 2021;
- Outlook für Microsoft 365, klassische Desktop-App;
- unter Windows 64 Bit. Outlook kann in der 32- oder 64-Bit-Version vorliegen: Das Add-In ist für beide registriert.
Outlook für Windows (VSTO) oder Add-In für Microsoft 365?
PhishTrainer bietet zwei Outlook-Add-Ins an, die je nach Outlook-Client Ihrer Mitarbeitenden zu wählen sind:
| Outlook-Client | Zu verwendendes Add-In |
|---|---|
| Klassisches, auf Windows-Arbeitsplätzen installiertes Outlook, insbesondere die Versionen ohne Abonnement (2016, 2019, 2021) | Dieses Add-In: Outlook für Windows (VSTO) |
| Outlook im Web, neues Outlook für Windows, Outlook mobil | Das Add-In Outlook Microsoft 365, beschrieben in einem separaten Handbuch |
Beide lassen sich kombinieren: Jedes ist in PhishTrainer eine eigene Meldequelle.
Voraussetzungen für den Arbeitsplatz
- Windows 64 Bit;
- .NET Framework 4.7.2 oder neuer;
- Visual Studio 2010 Tools for Office Runtime;
- Administratorrechte auf dem Arbeitsplatz für die Installation: Das MSI installiert das Add-In für alle Benutzer des Computers in
C:\Program Files\PhishTrainer\Report; - ausgehender HTTPS-Zugriff auf
app.phishtrainer.com. Das Add-In verwendet den System-Proxy von Windows mit den Windows-Anmeldedaten des Benutzers.
Ohne .NET Framework 4.7.2 oder ohne Visual Studio 2010 Tools for Office Runtime verweigert das MSI die Installation und zeigt die fehlende Komponente an (Meldung auf Englisch).
Verarbeitete Daten
Bei einer Meldung
- die gemeldete E-Mail vollständig (Format .msg, einschliesslich Anhängen, ausser der Mitarbeitende entscheidet sich, sie ohne Anhänge zu senden);
- der gewählte Typ (Phishing oder Spam) und die vom Mitarbeitenden angekreuzten Kästchen (Link angeklickt, Anhang geöffnet, Passwort oder Daten eingegeben, Antwort oder Anruf);
- die Sprache des Add-Ins;
- die Adresse des Postfachs, das die E-Mail enthält.
Gibt der Mitarbeitende an, ein Passwort eingegeben oder einen Anhang geöffnet zu haben, und ist die E-Mail keine PhishTrainer-Simulation, wird eine Warnung per E-Mail an die PhishTrainer-Administratoren gesendet. Die Warnung blockiert die Meldung nie.
Bei der Aktivierung eines Arbeitsplatzes
- der Name des Arbeitsplatzes, der Windows-Benutzer und die Version des Add-Ins;
- die Adressen der verbundenen Postfächer (siehe weiter unten): Der Server speichert davon nur Hashwerte.
Der Arbeitsplatz wird danach über ein Geräte-Token identifiziert, das lokal für den Windows-Benutzer verschlüsselt ist. Der Mitarbeitende hat weder ein PhishTrainer-Konto noch ein PhishTrainer-Passwort.
Auf dem Arbeitsplatz
Das Add-In führt ein lokales Protokoll, ohne Token, ohne E-Mail-Adresse und ohne Nachrichteninhalt, in %LOCALAPPDATA%\PhishTrainer\Report\logs (eine Datei pro Tag, 7 Tage aufbewahrt).
Die Daten werden ausschliesslich in der Schweiz gehostet. Die Aufbewahrungsdauer der gemeldeten E-Mails ist im Vertrag zwischen Ihrer Organisation und Bexxo festgelegt.
1Die Quelle in PhishTrainer erstellen
- Öffnen Sie in PhishTrainer Eingang der Meldungen und klicken Sie auf Quelle hinzufügen.
- Wählen Sie in der Gruppe «Eine Schaltfläche «Melden» im E-Mail-Programm» Outlook für Windows (VSTO).
- Auf der Registerkarte Einstellungen:
- Name der Quelle: Frei wählbarer Name, der in PhishTrainer angezeigt wird.
- Empfang aktiviert: Angekreuzt lassen, um Meldungen anzunehmen.
- E-Mail nach der Meldung löschen: «Sobald die Meldung vom Server akzeptiert wurde, verschiebt das Add-In die gemeldete E-Mail in die gelöschten Elemente der Mitarbeitenden, wo sie wiederherstellbar bleibt.»
- Speichern Sie. Der Aktivierungscode wird auf der Registerkarte Einstellungen angezeigt, und die Registerkarten Installation, Nachricht an Mitarbeitende und Registrierte Geräte erscheinen.
- Laden Sie auf der Registerkarte Installation das MSI herunter (MSI herunterladen) oder kopieren Sie seinen direkten Link (Link kopieren). Die Datei heisst
PhishTrainer-Report-<version>.msi.
Aktivierungscode: Er verbindet einen Arbeitsplatz mit Ihrer Organisation. Behandeln Sie ihn als interne Information: Veröffentlichen Sie ihn nicht. Falls er weitergegeben wurde, erzeugen Sie einen neuen (siehe «Arbeitsplätze verwalten»). Der Download-Link des MSI ist dagegen öffentlich.
2Das Add-In installieren und aktivieren
Der Aktivierungscode kann auf drei Arten bereitgestellt werden. Die ersten beiden aktivieren die Arbeitsplätze ohne Zutun der Mitarbeitenden.
| Methode | Verwendung |
|---|---|
| Gruppenrichtlinie (GPO) | Registrierungswert, der auf den Arbeitsplätzen gesetzt wird. Er hat Vorrang vor den anderen Methoden. |
| Unbeaufsichtigte Installation mit Code | Intune, SCCM, Skript. |
| Eingabe durch den Mitarbeitenden | Installation Arbeitsplatz für Arbeitsplatz, kleine Umgebungen. |
Arbeitsplatz für Arbeitsplatz
- Starten Sie das MSI auf dem Arbeitsplatz mit einem lokalen Administratorkonto. Der Assistent ist auf Englisch und verlangt keine Eingabe: Welcome (Willkommen), Install (Installieren), Finish (Fertigstellen).
- Starten Sie Outlook neu. Die Gruppe «PhishTrainer by Bexxo» erscheint auf der Registerkarte Start. Office fragt möglicherweise einmalig, ob Sie dem Herausgeber vertrauen: Bestätigen Sie.
- Klicken Sie in dieser Gruppe auf Einstellungen, fügen Sie den Aktivierungscode ein (Schaltfläche Einfügen) und klicken Sie auf Aktivieren.
Die Installation verlangt keinen Code: Sie können das Add-In installieren und später aktivieren. Solange es nicht aktiviert ist, öffnet ein Klick auf eine Melde-Schaltfläche das Fenster «PhishTrainer entdecken», das die Einrichtung anbietet.
Wenn die Mitarbeitenden das Add-In selbst installieren und aktivieren, liefert die Registerkarte Nachricht an Mitarbeitende der Quelle einen versandfertigen Text mit dem Download-Link und dem Aktivierungscode. Die Mitarbeitenden benötigen dann Administratorrechte auf ihrem Arbeitsplatz.
Massenverteilung, Option 1: unbeaufsichtigte Installation
Befehl, der mit Administratorrechten auszuführen ist (zum Beispiel über Intune, SCCM oder ein Startskript):
- Die Registerkarte Installation der Quelle zeigt diesen Befehl mit bereits eingetragenem Dateinamen und Ihrem Code an.
- Der Code wird nicht in das Installationsprotokoll von msiexec geschrieben.
- Bei einer Aktualisierung oder Reparatur ohne Code wird der bereits installierte Code übernommen.
Massenverteilung, Option 2: Gruppenrichtlinie (GPO)
Installieren Sie das MSI ohne Code und legen Sie dann diesen Registrierungswert auf den Arbeitsplätzen an, zum Beispiel mit einer Gruppenrichtlinien-Einstellung:
| Element | Wert |
|---|---|
| Schlüssel | HKEY_LOCAL_MACHINE\Software\Policies\PhishTrainer\Report |
| Wertname | EnrollmentToken (REG_SZ) |
| Daten | der Aktivierungscode aus der Registerkarte Einstellungen |
- Der Aktivierungscode, der MSI-Parameter
ENROLLMENTTOKENund der WertEnrollmentTokenbezeichnen denselben Wert. Erhält ein Arbeitsplatz beide, hat der Richtlinienwert Vorrang vor dem MSI-Wert. - Mit einem per Richtlinie gesetzten Code zeigt das Fenster Einstellungen keine Code-Eingabe mehr an, sondern: «Die Verbindung wird von Ihrer IT-Abteilung verwaltet: Sie müssen nichts tun.»
- Wenn Sie den Richtlinienwert ändern (zum Beispiel nach dem Erzeugen eines neuen Codes), aktiviert sich der Arbeitsplatz beim nächsten Start von Outlook oder bei der nächsten Synchronisierung mit dem neuen Code erneut.
Synchronisierung: Das Add-In aktiviert sich bzw. synchronisiert seine Konfiguration beim Start von Outlook und danach alle 12 Stunden. Die Schaltfläche Jetzt synchronisieren in den Einstellungen löst sie bei Bedarf aus. Die Aktivierung gilt pro Windows-Benutzer: Auf einem gemeinsam genutzten Arbeitsplatz wird jede Windows-Sitzung separat aktiviert (automatisch mit der GPO oder dem Code des MSI).
3Überprüfen, ob alles funktioniert
- In Outlook zeigt die Gruppe «PhishTrainer by Bexxo» auf der Registerkarte Start die Schaltflächen Als Phishing melden, Als Spam melden, Einstellungen und Info an.
- In den Einstellungen zeigt der Abschnitt «Verbindungsstatus» Verbunden und den Namen Ihrer Organisation an.
- Wählen Sie eine empfangene E-Mail aus und klicken Sie auf Als Spam melden: Das Fenster «Diese E-Mail melden» öffnet sich. Senden Sie die Meldung und prüfen Sie, ob sie in PhishTrainer eintrifft.
- Auf der Registerkarte Registrierte Geräte der Quelle (Schaltfläche Aktualisieren) erscheint der Arbeitsplatz mit den Spalten Computer, Windows-Benutzer, Version und Letzte Aktivität.
Ist die Option E-Mail nach der Meldung löschen aktiviert, wird die Test-E-Mail in den Ordner Gelöschte Elemente verschoben.
Verbundene Postfächer
Bei der Aktivierung verbindet der Arbeitsplatz bis zu 5 Adressen von Postfächern aus dem Outlook-Profil mit PhishTrainer. Ein Mitarbeitender kann nur E-Mails aus einem verbundenen Postfach melden.
- Nach der Aktivierung zum Profil hinzugefügtes Postfach: Outlook zeigt «Neues Postfach in Outlook» an. Mit einem per GPO oder MSI gesetzten Code verbindet die Schaltfläche Jetzt verbinden das Postfach ohne Eingabe (und das Add-In versucht, es beim Start von Outlook selbst zu verbinden). Andernfalls öffnet der Mitarbeitende erneut die Einstellungen und fügt den Aktivierungscode noch einmal ein.
- Freigegebenes Postfach, das ohne Konto im Profil geöffnet ist: Seine E-Mails werden im Namen des Benutzers des Arbeitsplatzes gemeldet.
- Bei mehr als fünf Konten im Profil kann das sechste nicht verbunden werden.
Arbeitsplätze verwalten
| Aktion | Wirkung |
|---|---|
| Sperren (Registerkarte Registrierte Geräte) | Nur dieser Arbeitsplatz verliert den Zugriff und kann sich nicht mehr mit dem Code reaktivieren. Andere Arbeitsplätze sind nicht betroffen. Der Mitarbeitende sieht «Ihr Zugriff wurde entzogen. Wenden Sie sich an Ihre IT-Abteilung.» |
| Wiederherstellen | Gibt dem Arbeitsplatz den Zugriff zurück. Dies wird bei der nächsten Synchronisierung wirksam (Start von Outlook, alle 12 Stunden oder Jetzt synchronisieren). |
| Code neu erzeugen (Registerkarte Einstellungen) | Bereits aktivierte Arbeitsplätze funktionieren weiter. Nur neue Aktivierungen benötigen den neuen Code: Passen Sie die Gruppenrichtlinie, Ihre Installationsskripte und die Nachricht an die Mitarbeitenden an. Zu tun, wenn der Code weitergegeben wurde. |
| Empfang deaktivieren (Schalter Empfang aktiviert) | Die Meldungen werden abgelehnt, und der Mitarbeitende sieht «Der Meldedienst ist für Ihre Organisation deaktiviert. Ihr Computer bleibt verbunden: Meldungen funktionieren wieder, sobald der Dienst reaktiviert ist. Wenden Sie sich an Ihre IT-Abteilung.» Die Arbeitsplätze bleiben aktiviert. |
Aktualisieren
Das Add-In aktualisiert sich nicht selbst. Es prüft höchstens einmal pro Tag, ob eine neuere Version vorhanden ist: In diesem Fall erscheint ein orangefarbener Punkt auf der Schaltfläche Info, deren Fenster Herunterladen anbietet. Die Installation erfordert Administratorrechte auf dem Arbeitsplatz.
Im Unternehmen verteilen Sie das neue MSI erneut (gleicher Befehl oder gleiche Methode wie bei der Installation). Eine neue Version ersetzt die alte; eine ältere Version als die installierte wird abgelehnt. Die Registerkarte Installation der Quelle zeigt die zuletzt veröffentlichte Version an.
Deinstallieren
Das Add-In ist als Programm «PhishTrainer Report» installiert (Herausgeber «Bexxo by tesweb SA»): Deinstallieren Sie es wie jedes Windows-Programm. Denken Sie auch daran, den Arbeitsplatz auf der Registerkarte Registrierte Geräte zu sperren.
Fehlerbehebung
| Was man sieht | Wahrscheinliche Ursache | Was tun |
|---|---|---|
| Gruppe «PhishTrainer by Bexxo» fehlt | Add-In nicht installiert, von Outlook deaktiviert oder Vertrauen in den Herausgeber abgelehnt | Prüfen, ob «PhishTrainer Report» installiert ist, dann den Status des Add-Ins «PhishTrainer» in den COM-Add-Ins von Outlook prüfen |
| Fenster «PhishTrainer entdecken» beim Klick auf eine Melde-Schaltfläche | Arbeitsplatz nicht aktiviert | Den Code in den Einstellungen einfügen oder per GPO oder MSI bereitstellen |
| «Wählen Sie die zu meldende E-Mail aus.» / «Nur E-Mails können gemeldet werden.» | Nichts ausgewählt oder Element, das keine E-Mail ist | Eine E-Mail auswählen |
| «Diese E-Mail wurde nicht empfangen (Entwurf oder nicht gesendete E-Mail) und kann daher nicht gemeldet werden.» | Entwurf | Eine empfangene E-Mail melden |
| «Diese E-Mail ist verschlüsselt oder geschützt und kann daher nicht analysiert werden…» | S/MIME-E-Mail oder durch Rechte geschützt (IRM) | Der Mitarbeitende leitet die E-Mail an die IT-Abteilung weiter |
| «Diese E-Mail liegt in einem Postfach, das auf diesem Gerät noch nicht mit PhishTrainer verbunden ist…» | Postfach nach der Aktivierung zu Outlook hinzugefügt | Das Postfach verbinden (siehe «Verbundene Postfächer») |
| «Diese E-Mail ist zu gross (über 10 MB)…» | E-Mail mit mehr als 10 MB | Der Mitarbeitende leitet die E-Mail an die IT-Abteilung weiter |
| «Wählen Sie höchstens 20 E-Mails gleichzeitig aus.» | Sammelmeldung zu gross | Die Auswahl verkleinern |
| «Ihr Zugriff wurde entzogen. Wenden Sie sich an Ihre IT-Abteilung.» | Arbeitsplatz gesperrt | Falls die Sperrung nicht beabsichtigt war: Wiederherstellen |
| «Der Meldedienst ist für Ihre Organisation deaktiviert…» | Empfang in PhishTrainer deaktiviert | Den Empfang wieder aktivieren |
| «Der Server hat diesen Aktivierungscode abgelehnt. Wenden Sie sich an Ihre IT-Abteilung.» | Falscher Code oder alter Code nach dem Neuerzeugen | Den aktuellen Code aus der Registerkarte Einstellungen bereitstellen |
| «Die Aktivierung des Add-ins ist nicht mehr gültig…» | Geräte-Token abgelehnt, ohne von der IT gesetzten Code | Der Mitarbeitende fügt den Code erneut in den Einstellungen ein |
| «Der PhishTrainer-Server ist nicht erreichbar. Versuchen Sie es später erneut.» oder Status Eingerichtet, Server nicht erreichbar | Netzwerk, Proxy oder Firewall | Erneut versuchen; den HTTPS-Zugriff auf app.phishtrainer.com prüfen |
| «Zu viele Anfragen in kurzer Zeit. Versuchen Sie es in einigen Minuten erneut.» | Limit erreicht (60 Meldungen in 10 Minuten pro Arbeitsplatz) | Warten |
| Fenster «Serveradresse nicht sicher» | Per Richtlinie konfigurierte Serveradresse, die kein HTTPS verwendet | Die Richtlinie korrigieren: Solange sie nicht korrigiert ist, wird keine Meldung gesendet |
Ohne Verbindung zum Server wird die Meldung nicht zwischengespeichert: Sie schlägt fehl, und der Mitarbeitende muss sie wiederholen.
Informationen für den Support
Im Fenster Info kopiert die Schaltfläche Diagnoseinformationen kopieren folgende Angaben in die Zwischenablage: die Version des Add-Ins, von Outlook und von Windows, den Verbindungsstatus, die Organisation, das Datum der letzten Synchronisierung, die Kennung des Arbeitsplatzes und den Speicherort der Protokolle. Diese Informationen enthalten weder Token noch Aktivierungscode. Fügen Sie bei Bedarf die Protokolle des Arbeitsplatzes bei, die sich in dem im Abschnitt «Verarbeitete Daten» angegebenen Ordner befinden.
Support: Bei Fragen zur Installation schreiben Sie an info@bexxo.ch.
Keine Antwort gefunden? Kontakt aufnehmen