> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Einrichtung der Google-Workspace-Integration

> Verbinden Sie Google Workspace mit Living Security, um Aktivitäten zu Benutzerlebenszyklus, Anmeldung, MFA, Administration und Datenschutz zu erfassen.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Weiterführende Ressourcen</h2>
    <ul>
      <li>
        <a href="/de/signals/data-sources">Erfahren Sie, wie Daten aus Integrationen zu Signalen für das Human Risk Management werden</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security Integrationen entdecken</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform öffnen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security Demo anfordern</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Zugangsdaten in der Living Security Platform eingeben">
    <p>
      Wird von der Person durchgeführt, die über Living Security-Zugriff verfügt – dem Programmverantwortlichen oder dem Systemadministrator, sofern dieser eingeladen wurde (delegierte Einrichtung).
    </p>
    <ol>
      <li>
        Gehen Sie zu <strong>Einstellungen → Integrationen → Catalog</strong>, suchen Sie die Kachel{' '}
        <strong>{tile}</strong> und klicken Sie auf <strong>Verbinden</strong>.
      </li>
      <li>
        Füllen Sie die folgenden Felder aus und klicken Sie anschließend auf <strong>Verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Diese Anleitung richtet sich an Ihre {system}-Administratorin bzw. Ihren {system}-Administrator.</strong> Sie beschreibt das Erstellen von API-Zugangsdaten in {system}. Dafür ist Administratorzugriff auf {system} erforderlich – nicht auf die
      Living Security Platform.
    </p>
    <p>
      Wenn Sie als <strong>Programmverantwortlicher</strong> von Living Security {system} nicht selbst administrieren,
      leiten Sie diese Seite an die zuständige Person weiter. Diese führt Teil A durch und übergibt Ihnen die Zugangsdaten
      (oder gibt sie direkt ein, sofern Sie sie in die Plattform eingeladen haben).
      {recommendDelegated && <>
          {' '}Da bei der Einrichtung sensibles Schlüsselmaterial entsteht, empfehlen wir den Weg der{' '}
          <strong>delegierten Einrichtung</strong>, damit das Secret nie an Sie zurückgesendet wird.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Google Workspace" recommendDelegated={true} />

## Was diese Integration beisteuert

Google Workspace kann normalisierte Aktivitäten zu Benutzerlebenszyklus, Anmeldung, MFA, Administration und Datenschutz beisteuern. Geprüfte Beispiele:

* `account.compromised` – als kompromittiert gekennzeichnetes Konto
* `data.sensitive.downloaded` – lädt sensible Daten herunter
* `auth.login.unusual` – meldet sich in ungewöhnlichen Kontexten an

Weitere Informationen finden Sie unter [So werden Integrationsdaten zu Signalen](/de/signals/data-sources).

## Was Living Security benötigt

| Anmeldedaten | Beschreibung |
| - | - |
| **Dienstkontoschlüssel** | Ein JSON-Schlüssel für ein dediziertes Google-Cloud-Dienstkonto. |
| **Delegierter Administrator** | Die E-Mail-Adresse eines Google-Workspace-Administrators, die das Dienstkonto imitieren kann. |

Aktivieren Sie die Admin-SDK-APIs und autorisieren Sie nur die Bereiche (Scopes), die die Verbindung liest:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## Einrichtung

<Steps>
  <Step title="Google-Cloud-Dienstkonto erstellen">
    Erstellen Sie ein dediziertes Dienstkonto, aktivieren Sie die domainweite Delegierung und laden Sie den JSON-Schlüssel herunter. Bewahren Sie den Schlüssel sicher auf.
  </Step>

  <Step title="Domainweite Delegierung autorisieren">
    Öffnen Sie in der Google Admin Console **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Fügen Sie die numerische Client-ID des Dienstkontos und die drei oben genannten schreibgeschützten Bereiche (Scopes) hinzu.
  </Step>

  <Step title="Delegierten Administrator auswählen">
    Wählen Sie einen aktiven Workspace-Administrator aus, der das Verzeichnis, Rollenzuweisungen und Audit-Berichte lesen kann. Living Security verwendet diese Identität ausschließlich für delegierte lesende API-Zugriffe.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Laden Sie die Anmeldedaten des Dienstkontos wie angefordert hoch oder fügen Sie sie ein, und geben Sie die E-Mail-Adresse des delegierten Administrators ein.
  </ConnectInPlatform>
</Steps>

## Überprüfen und Fehler beheben

Prüfen Sie, ob die Verbindung einen Verzeichnisbenutzer und die letzten Anmeldeaktivitäten lesen kann. Laut Google kann es einige Zeit dauern, bis neue Berechtigungen für die domainweite Delegierung wirksam werden.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Stellen Sie sicher, dass die domainweite Delegierung die numerische Client-ID des Dienstkontos verwendet und nicht dessen E-Mail-Adresse, und dass alle drei Bereiche (Scopes) exakt übereinstimmen.
  </Accordion>

  <Accordion title="Verzeichnis funktioniert, aber Rollenzuweisungen fehlen">
    Fügen Sie `admin.directory.rolemanagement.readonly` zum Delegierungseintrag hinzu und stellen Sie sicher, dass der delegierte Administrator Rollenzuweisungen anzeigen kann.
  </Accordion>

  <Accordion title="Berichte sind leer">
    Stellen Sie sicher, dass die Admin Reports API aktiviert ist und dass der delegierte Administrator auf die Audit-Berichte des Workspace-Mandanten zugreifen kann.
  </Accordion>
</AccordionGroup>

Weitere Informationen seitens des Anbieters finden Sie in der [Anleitung von Google zur domainweiten Delegierung](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority).

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.