> ## Documentation Index > Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt > Use this file to discover all available pages before exploring further. # Google Workspace > Integration mit Google Workspace > [!NOTE] > > Wir nutzen die [OAuth](https://developers.google.com/identity/protocols/oauth2)-Unterstützung von Google Workspace für die Integration in Ihr Workspace-Konto. Die Workspace-Integration benötigt Leseberechtigungen für das Verzeichnis, um alle Benutzer Ihrer Organisation abfragen zu können. Fügen Sie zunächst [eine neue Integration hinzu](https://app.wirespeed.co/settings/integrations?tab=browse) und wählen Sie Google Workspace. Sie werden zur OAuth-Zustimmungsseite weitergeleitet. ### Wirespeed-E-Mails in der Google Admin Console auf die Zulassungsliste setzen Sie können in Ihrem gesamten Google Workspace bestimmte Domains und E-Mail-Adressen auf eine Zulassungsliste setzen. So stellen Sie sicher, dass E-Mails von Wirespeed Ihr Team erreichen: 1. Melden Sie sich mit einem Administratorkonto bei der Google Admin Console unter [https://admin.google.com](https://admin.google.com) an. 2. Klicken Sie im linken Menü auf **Apps** > **Google Workspace** > **Gmail**. 3. Stellen Sie sicher, dass im Bereich **Organizational Units** Ihre Domain ausgewählt ist. 4. Suchen Sie auf der Registerkarte **Spam, Phishing, and Malware** den Abschnitt **Spam**. 5. Klicken Sie auf **Configure** (wenn noch keine Regeln vorhanden sind) oder auf **Add another rule**. 6. Benennen Sie Ihre Regel und stellen Sie sicher, dass das Kontrollkästchen **Bypass spam filters and hide warnings for messages from senders or domains in selected lists** aktiviert ist. > [!WARNING] > > Das Kontrollkästchen **Bypass spam filters for internal senders** ist möglicherweise standardmäßig aktiviert. Für unsere Zwecke ist es NICHT erforderlich und kann ein unerwünschtes Risiko darstellen. Berücksichtigen Sie dies, bevor Sie es aktiviert lassen. 7. Klicken Sie auf **Create or edit list**, um die Seite Manage Address list zu öffnen. * ***Wenn Sie eine neue Liste erstellen***, klicken Sie auf **ADD ADDRESS LIST**, benennen Sie die Liste entsprechend und wählen Sie **Add Address**. * ***Wenn Sie eine vorhandene Liste bearbeiten***, wählen Sie die Liste aus und klicken Sie auf **Add Address**. 8. Geben Sie in das vorgesehene Feld die Domain ein: [wirespeed.co](https://wirespeed.co). 9. Klicken Sie auf **SAVE**. 10. Kehren Sie zur Konfigurationsseite der Spam-Regel zurück, klicken Sie auf **Use existing list** und wählen Sie die bearbeitete Liste aus. 11. Klicken Sie auf **Save**, um die Änderungen zu übernehmen. ## Welche Ereignisse werden erfasst? Wirespeed liest Google-Workspace-Aktivität über die Reports API des Admin SDK mit der schreibgeschützten Audit-Berechtigung, die Sie beim Verbinden erteilen, und synchronisiert Ihr Benutzerverzeichnis. In Wirespeed ist keine zusätzliche Einrichtung erforderlich. Gemini- und NotebookLM-Ereignisse erscheinen nur, wenn diese Dienste in Ihrem Workspace aktiviert sind. | Quelle | Ereignisse | | - | - | | Anmeldung | Erfolgreiche und fehlgeschlagene Anmeldungen sowie Anmeldeprüfungen | | Admin-Konsole | Änderungen, die Administratoren an Benutzern, Rollen, Sicherheits- und Domaineinstellungen vornehmen | | OAuth-Token | Autorisierungen von Drittanbieter-Apps und Token-Aktivität | | SAML | Anmeldungen bei SAML-Apps, die Google als Identitätsanbieter verwenden | | Drive, Kalender und Meet | Datei-, Kalender- und Besprechungsaktivität | | Konten und Geräte | Kontoänderungen wie Passwort- und Bestätigung-in-zwei-Schritten-Änderungen, Registrierung mobiler Geräte und Aktivität in der Google Cloud Console | | Gmail | Nachrichtenzustellungsaktivität, wenn der autorisierende Administrator Audit-Protokolle lesen darf | | Gemini | Nutzung von Gemini-Funktionen in Workspace-Apps, wenn Google Gemini-Audit-Protokolle für Ihre Organisation bereitstellt | | NotebookLM | Aktivität zu Notebooks, Quellen und generierten Artefakten sowie Änderungen an Freigabe, Sichtbarkeit und Export, wenn Google NotebookLM-Audit-Protokolle für Ihre Organisation bereitstellt | Die Erfassung von Gemini und NotebookLM wird automatisch aktiviert, sobald Google diese Audit-Protokolle bereitstellt, und Wirespeed prüft die Verfügbarkeit alle paar Stunden erneut. Sie müssen die Integration nicht erneut verbinden. Ist eine dieser Quellen nicht verfügbar, zeigt die Integration eine Warnung an, und die übrigen Quellen funktionieren weiter. Die Erfassung beginnt, sobald eine Quelle verfügbar ist; ältere Daten werden nicht importiert. ## Verwaltete Detektionen Wirespeed wertet die erfassten Ereignisse auf Folgendes aus: | Detektion | Bedingung | | - | - | | Domainweite Delegierung erteilt | Ein Administrator berechtigt einen API-Client, im Namen jedes Benutzers der Domain zu handeln | | SSO-Einstellungen geändert | Ein Administrator ändert die Einmalanmeldung oder schaltet sie ein oder aus | | Benutzer gelöscht | Ein Administrator löscht einen Benutzer | | Administratorrolle zugewiesen | Ein Benutzer erhält Super-Admin-Rechte oder eine Administratorrolle | | Kontextsensitiver Zugriff geändert | Ein Administrator aktiviert oder deaktiviert den kontextsensitiven Zugriff oder ändert, welche Zugriffsebenen für eine App gelten | | Gmail-OAuth-Autorisierung für Apps Script | Ein Apps Script wird mit vollem Gmail-Zugriff und der Berechtigung zum Senden von E-Mails autorisiert | | Anmeldung nur mit Passwort nach einer Prüfung | Auf eine Anmeldung, die eine Prüfung bestanden hat, folgt eine Anmeldung ohne Bestätigung in zwei Schritten aus einem Rechenzentrumsnetz, das für den Benutzer neu ist | Erfolgreiche und fehlgeschlagene Anmeldungen werden zudem als Authentifizierungsereignisse für SIEM-Suchen und plattformübergreifende Anmeldedetektionen normalisiert. Wirespeed erstellt nicht für jede einzelne Anmeldung eine Detektion. ## Fehler ### access\_not\_configured > [!WARNING] > > Access blocked: Your institution's admin needs to review Wirespeed. Error 400: access\_not\_configured Dieser Fehler tritt auf, wenn Ihre Google-Workspace-Organisation OAuth-Anwendungen von Drittanbietern standardmäßig einschränkt. Dabei handelt es sich um eine Sicherheitsfunktion der Google Admin Console, bei der ein Administrator Anwendungen ausdrücklich genehmigen muss, bevor Benutzer ihnen Zugriff gewähren können. Um das Problem zu beheben, muss ein Super Admin von Google Workspace die Wirespeed-Anwendung vorab genehmigen: 1. Melden Sie sich als Super Admin bei der [Google Admin Console](https://admin.google.com) an. 2. Gehen Sie zu **Security** > **Access and data control** > **API controls**. 3. Klicken Sie auf **Manage Third-Party App Access** (oder öffnen Sie direkt [App Access Control](https://admin.google.com/ac/owl/list?tab=apps)). 4. Klicken Sie auf **Add app** > **OAuth App Name Or Client ID**. 5. Suchen Sie nach **Wirespeed** oder fügen Sie die OAuth-Client-ID ein, die Ihnen Ihr Wirespeed-Administrator mitgeteilt hat. 6. Wählen Sie die Wirespeed-App aus und klicken Sie auf **Select**. 7. Legen Sie die Zugriffsebene auf **Trusted** (empfohlen) oder **Limited** fest. 8. Klicken Sie zum Speichern auf **Configure**. Sobald die App genehmigt wurde, kehren Sie zu Wirespeed zurück und versuchen Sie die [Google-Workspace-Integration](https://app.wirespeed.co/settings/integrations?tab=browse) erneut. > [!TIP] > > Wenn Sie die OAuth-Client-ID nicht kennen, wenden Sie sich an Ihren Wirespeed-Kundenbetreuer oder schreiben Sie an [support@wirespeed.co](mailto:support@wirespeed.co). ### Integration schlägt mit Limited-Zugriff fehl, funktioniert aber mit Trusted Wenn der Zugriff von Wirespeed in App Access Control auf **Limited** (oder **Specific Google data**) gesetzt ist, meldet Google, dass Ihr Administrator zusätzliche Berechtigungen erteilen muss, und die Verbindung schlägt fehl, obwohl alle angeforderten Scopes zugelassen sind. Wird Wirespeed auf **Trusted** gesetzt, gelingt die Verbindung. Eine bekannte Ursache ist, dass das Konto, mit dem Wirespeed verbunden wird, am [Erweiterten Sicherheitsprogramm](https://support.google.com/a/answer/9378686) (Advanced Protection Program) von Google teilnimmt. Das Erweiterte Sicherheitsprogramm schränkt ein, welche Drittanbieter-Apps registrierte Benutzer autorisieren können. Daher kann eine App mit **Limited**- oder **Specific Google data**-Zugriff trotzdem blockiert werden. Wird die App als **Trusted** markiert, entfällt diese Einschränkung. So beheben Sie das Problem, ohne Wirespeed auf Trusted zu setzen: 1. Erstellen oder wählen Sie ein dediziertes Super-Admin-Konto, das **nicht** am Erweiterten Sicherheitsprogramm teilnimmt, und verwenden Sie es ausschließlich zum Erteilen der Zustimmung. Ohne das Erweiterte Sicherheitsprogramm wird für dieses Konto keine Anmeldung per Sicherheitsschlüssel erzwungen. Ordnen Sie es daher einer Organisationseinheit zu, deren Richtlinie für die Bestätigung in zwei Schritten erzwungen wird und **Only security key** als zulässige Methode vorgibt. 2. Setzen Sie Wirespeed in App Access Control auf die Zugriffsebene, die Ihre Richtlinie zulässt, zum Beispiel **Limited** oder **Specific Google data**. 3. Versuchen Sie die [Google-Workspace-Integration](https://app.wirespeed.co/settings/integrations?tab=browse) erneut. Melden Sie sich auf der Google-Zustimmungsseite mit dem dedizierten Super-Admin-Konto an. Wenn alle Konten, die die Zustimmung erteilen können, am Erweiterten Sicherheitsprogramm teilnehmen müssen, muss Wirespeed in App Access Control auf **Trusted** bleiben. > [!NOTE] > > Die Nutzung von Roh- oder abgeleiteten Benutzerdaten, die über Workspace-APIs empfangen werden, erfolgt gemäß der Google User Data Policy, einschließlich der Anforderungen zur eingeschränkten Nutzung (Limited Use). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.