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

# Benutzerverzeichnis-Integration mit Google Workspace

> Verbinden Sie Google Workspace mit Iru Endpoint, um Benutzer und Gruppen zu synchronisieren. Schließen Sie Google-Anmeldung, Berechtigungen und Verzeichniseinrichtung ab.

### Benutzerverzeichnis-Integration mit Google Workspace

Die Google Workspace-Integration in Iru Endpoint synchronisiert Benutzer- und Gruppenobjekte aus Google Workspace in das Benutzerverzeichnis von Iru Endpoint. Iru Endpoint verwendet diese delegierten Berechtigungen über die Google API, um diese Verzeichnisinformationen zu synchronisieren. Warum die Verzeichnisintegration wichtig ist sowie Informationen zu Marketplace-Filtern, Synchronisierung, erneuter Authentifizierung und Entfernung finden Sie unter [Überblick über die Benutzerverzeichnis-Integration und Anbieter](/de/endpoint/integrations/directory-services/user-directory-integration).

### Google Workspace-Integration hinzufügen

<Steps>
  <Step title="Integrationen öffnen">
    Wählen Sie in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Integrationen** aus.

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Screenshot des Kontomenüs mit hervorgehobener Option Integrations" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="Alle Integrationen durchsuchen">
    Wählen Sie oben rechts auf der Seite Integrations **Alle Integrationen durchsuchen** aus.
  </Step>

  <Step title="Google Workspace auswählen">
    Wählen Sie die Kachel **Google Workspace** aus.
  </Step>

  <Step title="Einrichtung starten">
    Wählen Sie **Get Started** aus.
  </Step>

  <Step title="Integrationsnamen eingeben">
    Geben Sie einen eindeutigen Namen ein, der in Iru Endpoint verwendet wird, um das Verzeichnis anzuzeigen, aus dem ein Benutzer stammt.
  </Step>

  <Step title="Mit Google anmelden">
    Wählen Sie **Sign in with Google** aus.
  </Step>

  <Step title="Authentifizierung abschließen">
    Melden Sie sich mit einem Google-Konto an, das Administratorzugriff auf das zu integrierende Verzeichnis hat.
  </Step>

  <Step title="Kontoberechtigungen bestätigen">
    Überprüfen Sie die grundlegenden Kontoinformationen, die Iru Endpoint anfordert, und wählen Sie dann **Fortfahren**.

    <Note>
      Wenn Sie in Google Zugriff gewähren, benennt Google diese App weiterhin als **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" />. Erlauben Sie der App **Kandji**, Ihr Google Workspace-Verzeichnis mit Iru Endpoint zu verbinden.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-directory-sign-in.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=825f25759f2648293f647e6c3fcfa1ba" alt="Google-Bildschirm Sign in to Kandji mit Anforderung von Name, Profilbild und E-Mail-Adresse, Continue hervorgehoben" width="1080" height="625" data-path="assets/media/images/iru-google-directory-sign-in.png" />
    </Frame>
  </Step>

  <Step title="Alle Berechtigungen auswählen">
    Aktivieren Sie auf dem Berechtigungsbildschirm das Kontrollkästchen **Select all**.

    <Note>
      Wenn Sie [die Integration erneut authentifizieren](/de/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration), wählen Sie erneut **Select all** und dann **Fortfahren**. Die erneute Authentifizierung stellt den Zugriff auf Ihre Benutzer und Gruppen nur wieder her, wenn Sie diese Berechtigungen erneut erteilen.
    </Note>
  </Step>

  <Step title="Zugriff auf Benutzer und Gruppen gewähren">
    Bestätigen Sie, dass **View groups on your domain** und **See info about users on your domain** ausgewählt sind, und wählen Sie dann **Fortfahren**.

    <Frame>
      <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-directory-grant-user-and-group-access.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=0e99bc87005fc0c2129c1c6649c1c989" alt="Google-Zugriffsbildschirm mit ausgewähltem Select all, View groups on your domain und See info about users on your domain, Continue hervorgehoben" width="1072" height="710" data-path="assets/media/images/iru-google-directory-grant-user-and-group-access.png" />
    </Frame>

    <Note>
      Wenn Sie fortfahren, ohne Iru Endpoint zu erlauben, Gruppen in Ihrer Domain anzuzeigen und Informationen über Benutzer in Ihrer Domain einzusehen, wird die Integration zwar erfolgreich verbunden, aber Ihre Benutzer und Gruppen werden nicht korrekt synchronisiert. Um dies zu beheben, [authentifizieren Sie die Integration erneut](/de/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration) und erteilen Sie alle angeforderten Berechtigungen.
    </Note>
  </Step>

  <Step title="Integration bestätigen">
    Das neue Benutzerverzeichnis wird auf der Seite **Integrationen** angezeigt.
  </Step>
</Steps>

Nachdem die Integration verbunden ist, können Sie [zusätzliche Informationen anzeigen](/de/endpoint/integrations/directory-services/user-directory-integration#view-additional-information-about-a-directory-integration), [eine Synchronisierung des Benutzerverzeichnisses erzwingen](/de/endpoint/integrations/directory-services/user-directory-integration#force-a-user-directory-sync), [erneut authentifizieren](/de/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration) oder [die Integration entfernen](/de/endpoint/integrations/directory-services/user-directory-integration#remove-a-directory-integration).

### Google Workspace-Berechtigungen

Die folgenden Berechtigungen werden automatisch angefordert und sind erforderlich, um Google Workspace-Benutzer erfolgreich in Iru Endpoint zu synchronisieren. Ein Google-Administrator muss über ausreichende Berechtigungen verfügen, um die folgenden Berechtigungen an Iru Endpoint zu delegieren.

| Berechtigung | Anzeigetext | Begründung |
| - | - | - |
| openid | See info about users on your domain | Sie mit Ihren persönlichen Informationen bei Google verknüpfen |
| userinfo.profile | See info about users on your domain | Ihre persönlichen Informationen einsehen, einschließlich aller persönlichen Informationen, die Sie öffentlich zugänglich gemacht haben |
| userinfo.email | See info about users on your domain | Die primäre E-Mail-Adresse Ihres Google-Kontos einsehen |
| admin.directory.group.readonly | View groups on your domain | Details (z. B. Name, Mitglieder) und Metadaten (z. B. Anmeldedetails) von Gruppen in Ihrer Domain anzeigen |
| admin.directory.user.readonly | See info about users on your domain | Berechtigung zum Einsehen von Profilinformationen der Benutzer Ihrer Domain, z. B. Name, E-Mail, Position und Abteilung |

### Fehlerbehebung bei der Synchronisierung von Benutzern und Gruppen

Wenn Benutzer oder Gruppen nach dem Verbinden der Integration nicht in Iru Endpoint angezeigt werden, gehen Sie die folgenden Prüfungen der Reihe nach durch.

<AccordionGroup>
  <Accordion title="Benutzer und Gruppen werden nach dem Verbinden der Integration nicht synchronisiert" icon="arrows-rotate">
    Die häufigste Ursache ist eine unvollständige Zustimmung. Wenn der Administrator den Google-Berechtigungsbildschirm übersprungen hat, ohne alle Berechtigungen auszuwählen, wird die Integration verbunden und meldet Erfolg, aber Iru Endpoint kann Ihr Verzeichnis nicht lesen.

    [Authentifizieren Sie die Integration erneut](/de/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration), aktivieren Sie auf dem Berechtigungsbildschirm das Kontrollkästchen **Select all** und wählen Sie dann **Fortfahren**. Sobald die Integration wieder verbunden ist, [erzwingen Sie eine Synchronisierung des Benutzerverzeichnisses](/de/endpoint/integrations/directory-services/user-directory-integration#force-a-user-directory-sync), anstatt auf die nächste vierstündliche Synchronisierung zu warten.
  </Accordion>

  <Accordion title="Sicherstellen, dass der Administrator Benutzer und Gruppen lesen kann" icon="user-shield">
    Iru Endpoint liest Ihr Verzeichnis mit den Berechtigungen des Administrators, der die Integration autorisiert hat. Dieses Konto benötigt daher Lesezugriff auf Benutzer und Gruppen.

    Gehen Sie in der Google Admin-Konsole zu **Verzeichnis** > **Benutzer**, wählen Sie das Konto aus, mit dem Sie die Integration autorisiert haben, und öffnen Sie **Admin roles and privileges**. Öffnen Sie jede zugewiesene Rolle und bestätigen Sie, dass sie Leseberechtigungen für Benutzer und Gruppen gewährt.

    Die Directory API gehört zum Google Admin SDK und ist auf Administratoren beschränkt. Wenn dem Konto diese Berechtigungen fehlen, gibt Google den Fehler `403 Not Authorized to access this resource/api` zurück, und es gelangen keine Verzeichnisdaten zu Iru Endpoint. Die vollständige Liste der Bereiche finden Sie in Googles [Choose Directory API scopes](https://developers.google.com/workspace/admin/directory/v1/guides/authorizing).
  </Accordion>

  <Accordion title="Sicherstellen, dass Google Workspace Iru Endpoint den Zugriff auf Verzeichnisdaten erlaubt" icon="shield-check">
    Google Workspace-Administratoren können einschränken, welche Anwendungen auf Google Workspace-APIs zugreifen. Dadurch wird die Synchronisierung blockiert, selbst wenn der Zustimmungsbildschirm korrekt aussieht.

    Gehen Sie in der Google Admin-Konsole zu **Sicherheit** > **Access and data control** > **API controls** > **App access control** und bestätigen Sie, dass die von Iru Endpoint verwendete OAuth-App als **Trusted** und nicht als **Limited** oder **Blocked** eingestuft ist. Auf dem Google-Zustimmungsbildschirm heißt diese App weiterhin **Kandji**.

    Details zum Verhalten dieser Steuerelemente finden Sie in Googles [Control which apps access Google Workspace data](https://knowledge.workspace.google.com/admin/apps/control-which-apps-access-google-workspace-data).
  </Accordion>

  <Accordion title="Mit dem richtigen Konto in einem privaten Browserfenster autorisieren" icon="user-lock">
    Google wendet die Zustimmung auf das aktuell angemeldete Konto an. Eine bestehende Sitzung eines Nicht-Administratorkontos kann die Integration daher mit dem falschen Benutzer autorisieren.

    Öffnen Sie ein privates Fenster in [Safari](https://support.apple.com/guide/safari/browse-in-private-ibrw1069/mac) oder ein Inkognito-Fenster in [Chrome](https://support.google.com/chrome/answer/95464), schließen Sie alle anderen Browserfenster mit einer Google-Sitzung, melden Sie sich dann bei Iru Endpoint an und [authentifizieren Sie die Integration erneut](/de/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration) mit dem richtigen Administratorkonto.
  </Accordion>
</AccordionGroup>

### Integration von Google trennen

<Steps>
  <Step title="Google-Berechtigungen aufrufen">
    Gehen Sie zu [https://myaccount.google.com/permissions.](https://myaccount.google.com/permissions) Stellen Sie sicher, dass Sie mit demselben Konto angemeldet sind, mit dem die Integration ursprünglich konfiguriert wurde.
  </Step>

  <Step title="Kandji-Anwendung entfernen">
    Wählen Sie in der Liste der Anwendungen **Entfernen** für die Anwendung **Kandji** aus. Google benennt diese App weiterhin als **Kandji**.
  </Step>
</Steps>