> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.autophish.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Google Workspace verbinden, um Gmail-Phishing-Meldungen zu erfassen (Beta)

**Beta:** Die Google-Workspace-Integration ist in der Beta-Phase. Führe nach der Einrichtung den Verbindungstest durch und prüfe die ersten Meldungen unter **Phishing → Gemeldete E-Mails**.

Wenn Mitarbeitende in Gmail bei einer AutoPhish-Simulation die integrierte Option **Phishing melden** anklicken, erfasst AutoPhish das als Meldung – genau wie beim Outlook-Add-in oder beim Weiterleiten an die Meldeadresse. Deine Mitarbeitenden installieren nichts und nutzen Gmail wie gewohnt.

Die Meldung geht weiterhin auch an Google. Sie erscheint also weiterhin in deinem Google-Benachrichtigungscenter und hilft weiterhin, die Filter von Gmail zu trainieren. AutoPhish liest die Benachrichtigungen vom Typ **Von Nutzer gemeldetes Phishing** aus deinem Benachrichtigungscenter. Es ändert oder löscht sie nie.

## Bevor du beginnst

Du brauchst:

* die Rolle **Admin** für dein Unternehmen in AutoPhish
* einen **Super Admin** von Google Workspace oder einen anderen Admin, der die domainweite Delegierung verwalten darf, für Schritt 2 unten
* ein Workspace-Admin-Konto mit Zugriff auf das **Benachrichtigungscenter**. AutoPhish liest die Benachrichtigungen im Namen dieses Admins.
* die Domain der E-Mail-Adresse dieses Admins als verifizierte Domain deines Unternehmens in AutoPhish – siehe „Schritt 2 – Domain bestätigen“ in [Erste Schritte: AutoPhish für dein Unternehmen einrichten](https://help.autophish.io/de/article/erste-schritte-autophish-fur-dein-unternehmen-einrichten-1t4ntqq/)
* eine Google-Workspace-Edition mit Benachrichtigungscenter. Welche Editionen unterstützt werden, prüfen wir während der Beta-Phase noch. Wenn der Verbindungstest aus einem Grund fehlschlägt, der unten unter Fehlerbehebung nicht aufgeführt ist, wende dich an den Support.

## Verbindung einrichten

1. Gehe in AutoPhish zu **Einstellungen → Verzeichnis-Sync** und öffne **Google Workspace Phishing-Meldungen**. Die Seite zeigt eine **Client-ID** und einen **OAuth-Bereich**, jeweils mit einer Schaltfläche **Kopieren**.
2. Gehe in der Google Admin-Konsole zu **Sicherheit → Zugriffs- und Datenkontrolle → API-Steuerung → Domainweite Delegierung verwalten** und klicke auf **Neu hinzufügen**. Füge die Client-ID und den Bereich `https://www.googleapis.com/auth/apps.alerts` ein und klicke dann auf **Autorisieren**.
3. Gib in AutoPhish unter **E-Mail des Workspace-Admins** die Adresse des Admins ein und klicke auf **Speichern**.
4. Klicke auf **Verbindung testen**.

Kopiere die Client-ID immer von der Einstellungsseite in AutoPhish, damit sie exakt stimmt.

## Der Verbindungstest

**Verbindung testen** zeigt, ob AutoPhish Google mit dieser Einrichtung erreicht. Wenn ja, siehst du jede Benachrichtigung **Von Nutzer gemeldetes Phishing** der letzten 7 Tage, mit der Anzahl ihrer Nachrichten und einem Ergebnis pro Nachricht:

| Ergebnis | Bedeutung |
|---|---|
| Über Message-ID zugeordnet | Eine Simulations-E-Mail, direkt erkannt. |
| Über Betreff zugeordnet | Eine Simulations-E-Mail, erkannt über Empfänger und Betreff. Das ist typisch, wenn dein Unternehmen Simulationen über den eigenen Mailserver versendet. |
| Keine Simulation | Eine echte E-Mail. Sie wird als externe Meldung erfasst. |
| Mehrdeutig | Aus Sicherheitsgründen keiner Kampagne zugeordnet. |
| Empfänger stimmt nicht überein | Aus Sicherheitsgründen keiner Kampagne zugeordnet. |

Der Test zeigt nur Anzahlen und Ergebnisse, nie Betreffzeilen oder E-Mail-Adressen. Der Test selbst erfasst keine Meldungen.

Der Status der Verbindung ist nach dem Speichern **Verifizierung ausstehend**, **Aktiv**, sobald AutoPhish Google erfolgreich erreicht hat, und **Fehler**, wenn eine Prüfung fehlgeschlagen ist. **Letzter Fehler** zeigt dann den Grund.

## Wann Meldungen erscheinen

Google erstellt diese Benachrichtigungen asynchron. Eine Meldung kann daher **bis zu einigen Stunden** nach dem Klick auf **Phishing melden** in AutoPhish erscheinen. Das ist so vorgesehen und kein Fehler.

## Wo Meldungen erscheinen

Die Meldungen erscheinen unter **Phishing → Gemeldete E-Mails**, zusammen mit den Meldungen aus dem Outlook-Add-in und über die Meldeadresse:

* Eine Meldung einer AutoPhish-Simulation wird der Kampagne und dem oder der Mitarbeitenden zugeordnet. Sie zählt in deinen Berichten als **Gemeldet** und senkt die Risikokennzahlen, wie jede andere Meldung einer Simulation.
* Eine Meldung einer echten E-Mail erscheint unter **Externe E-Mails**.
* Die **Quelle** dieser Meldungen ist `google-workspace`.
* Für diese Meldungen wird keine Roh-E-Mail gespeichert. Es gibt also keine Originalnachricht zum Ansehen oder Herunterladen.

Der Anonyme Modus gilt für diese Meldungen genauso wie für Meldungen aus anderen Quellen – siehe [Gemeldete E-Mails: Prüfen, was deine Mitarbeitenden melden](https://help.autophish.io/de/article/gemeldete-e-mails-prufen-was-deine-mitarbeitenden-melden-1uvgta6/).

## Verbindung trennen

Klicke auf **Trennen**, um keine neuen Meldungen mehr zu erfassen. Bereits erfasste Meldungen bleiben erhalten. Um den Zugriff von AutoPhish auch bei Google zu entfernen, lösche den Eintrag unter **Domainweite Delegierung verwalten** in der Google Admin-Konsole.

## Gut zu wissen

* Ein Google Workspace kann nur mit einem AutoPhish-Unternehmen verbunden werden.
* Deine Mitarbeitenden müssen nichts anders machen. Die Meldeadresse und das Outlook-Add-in funktionieren weiter wie bisher.

## Fehlerbehebung

Einige Fehlermeldungen erscheinen auf Englisch. Hier findest du sie im Wortlaut.

### „The admin email's domain must be a verified domain of this company“

Die Domain der Admin-Adresse ist für dein Unternehmen nicht verifiziert. Verifiziere diese Domain zuerst in AutoPhish oder gib die Adresse eines Admins auf einer bereits verifizierten Domain ein.

### Der Test schlägt fehl mit „unauthorized_client“ oder „Client is unauthorized“

Die domainweite Delegierung fehlt oder ist falsch. Prüfe Schritt 2 noch einmal: die exakte Client-ID von der Einstellungsseite, den exakten Bereich `https://www.googleapis.com/auth/apps.alerts` und ob du auf **Autorisieren** geklickt hast.

### Der Test schlägt fehl mit „The caller does not have permission“ oder einem anderen Berechtigungsfehler

Der Admin, den du in AutoPhish eingetragen hast, hat keinen Zugriff auf das Benachrichtigungscenter, oder das Konto wurde gesperrt oder gelöscht. Trage einen Admin mit Zugriff auf das Benachrichtigungscenter ein.

### „This Google Workspace is already connected to another AutoPhish company“

Ein Google Workspace kann nur ein AutoPhish-Unternehmen beliefern. Wende dich an den AutoPhish-Support.

### „The admin belongs to a different Google Workspace than this connection“

Klicke auf **Trennen** und verbinde dich dann erneut mit einem Admin des richtigen Google Workspace.

### „Die Google-Workspace-Integration ist auf dieser AutoPhish-Instanz nicht aktiviert.“

Wende dich an den AutoPhish-Support.

### Der Test ist erfolgreich, zeigt aber 0 Benachrichtigungen

In den letzten 7 Tagen hat niemand etwas gemeldet, oder Google hat die Benachrichtigungen noch nicht erstellt. Bitte eine Testperson, eine Simulation mit **Phishing melden** zu melden, und führe den Test einige Stunden später erneut aus.

### Der Status zeigt „Fehler“ mit einem Text unter „Letzter Fehler“

Behebe die Ursache anhand der Abschnitte oben. AutoPhish versucht es alle paar Minuten automatisch erneut.

Wenn der Test aus einem anderen Grund fehlschlägt, wende dich an den AutoPhish-Support.