> ## 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.

# Google Workspace

> Ermöglichen Sie Benutzern die Anmeldung bei Iru Identity mit ihren Google Workspace-Konten über die integrierte Verbindungsvorlage für föderierte Authentifizierung und Bereitstellung.

Durch die Verbindung von **Google Workspace** können sich Ihre Benutzer bei Iru anmelden (und die
ihnen zugewiesenen Apps erreichen), indem sie ihre vorhandenen Google-Konten verwenden. Iru
stellt eine **Google Workspace-Vorlage** bereit, die die Standardkonfiguration vorab ausfüllt,
sodass dies einer der am schnellsten zu verbindenden Anbieter ist.

<Info>
  Bei den meisten Organisationen, die Iru Identity als Identitätsanbieter verwenden, melden sich Benutzer
  direkt mit einem Passkey oder der Iru Access-App an. Verbinden Sie Google Workspace,
  wenn Sie Iru Identity als Authentifizierungsschicht für die Iru-Plattform
  statt als primären Identitätsanbieter verwenden oder um eine Migration zu Iru
  Identity zu erleichtern. Siehe [Föderierte Authentifizierung](/de/identity/connections/connections-overview).
</Info>

<Note>
  Sie benötigen Administratorzugriff auf Ihren Iru-Mandanten sowie Zugriff auf die
  Google Admin-Konsole Ihrer Google Workspace-Organisation, um diese Verbindung
  einzurichten.
</Note>

## Bevor Sie beginnen

<Steps>
  <Step title="Anmeldedomänen bestätigen">
    Notieren Sie die E-Mail-**Domänen**, mit denen sich Ihre Benutzer anmelden (zum Beispiel
    `yourcompany.com`). Sie können die Verbindung auf diese Domänen beschränken, sodass nur
    Benutzer in diesen Domänen sie verwenden.
  </Step>

  <Step title="Festlegen, wie Iru Benutzer zuordnet">
    Wenn sich jemand über Google anmeldet, ordnet Iru die Person einem Benutzer in Ihrem
    Verzeichnis zu. Legen Sie fest, über welchen Wert die Zuordnung erfolgt, typischerweise die E-Mail-Adresse oder
    der Benutzername. Siehe [Benutzerzuordnung](/de/identity/connections/connections-overview#what-you-configure-on-every-identity-provider-connection).
  </Step>

  <Step title="Sicherstellen, dass Ihre Benutzer in Iru vorhanden sind">
    Eine Anmeldung über eine Verbindung wird einem vorhandenen Iru-Benutzer zugeordnet. Fügen Sie
    Ihre Benutzer zuerst hinzu oder importieren Sie sie; siehe [Benutzer importieren](/de/identity/directory/importing-users)
    oder [Directory Sync](/de/identity/directory/directory-sync).
  </Step>
</Steps>

## Google Workspace verbinden

<Steps>
  <Step title="Verbindung hinzufügen">
    Fügen Sie unter **Access → Authentication** eine **Authentifizierungsmethode** hinzu und wählen Sie die
    Vorlage **Google Workspace**. Die Vorlage füllt die Standardeinstellungen
    für Sie aus.
  </Step>

  <Step title="Iru bei Google autorisieren">
    Folgen Sie den Anweisungen, um Iru für Ihre Google Workspace-Organisation
    zu autorisieren. Melden Sie sich bei Aufforderung mit einem Google-**Super-Administrator**-Konto an
    und stimmen Sie den Standard-Anmelde-Scopes (`openid`, `email` und
    `profile`) zu. Wenn Ihre Organisation einen eigenen OAuth-Client bereitstellt, erstellen Sie ihn in
    der Google Cloud-Konsole, fügen Sie die Redirect-URI hinzu, die Iru für diese Verbindung anzeigt,
    und kopieren Sie dessen Client-ID und Secret in Iru. Die Konsolenbildschirme von Google können
    sich ändern; folgen Sie der aktuellen Dokumentation von Google, falls die Anweisungen abweichen.
  </Step>

  <Step title="Verwendungszweck der Verbindung wählen">
    Wählen Sie die **Anwendungsfälle** der Verbindung: **Endbenutzer-Anmeldung**, **Geräteregistrierung**
    oder beides. Die meisten Konfigurationen aktivieren die Endbenutzer-Anmeldung.
  </Step>

  <Step title="Auf Ihre Domänen beschränken">
    Wenn nur Benutzer in bestimmten E-Mail-Domänen diese Verbindung verwenden sollen,
    aktivieren Sie **Domänenbeschränkungen** und fügen Sie diese Domänen hinzu.
  </Step>

  <Step title="Benutzerzuordnung festlegen">
    Wählen Sie, wie Iru eine Google-Anmeldung einem Iru-Benutzer zuordnet (über UPN, Benutzername,
    externe ID oder ein benutzerdefiniertes Attribut). Wählen Sie einen Wert, der für jeden Benutzer eindeutig und stabil
    ist.
  </Step>

  <Step title="Verbindung speichern">
    Speichern Sie und melden Sie sich dann als Testbenutzer mit einer E-Mail-Adresse in einer zulässigen Domäne an, um
    zu bestätigen, dass die Übergabe an Google durchgängig funktioniert.
  </Step>
</Steps>

<Tip>
  Testen Sie mit einem einzelnen Benutzer, bevor Sie die Verbindung umfassend einführen. Wenn die Anmeldung
  nicht beim richtigen Benutzer landet, überprüfen Sie Ihre Wahl der **Benutzerzuordnung**; der
  zugeordnete Wert muss für alle, die die Verbindung verwenden, vorhanden und eindeutig sein.
</Tip>

## So funktioniert die Anmeldung nach der Verbindung

Wenn sich jemand anmeldet, übergibt Iru die Anmeldung an Google, Google bestätigt den
Benutzer und Iru setzt die Sitzung fort und wertet die
[Authentifizierungsrichtlinie](/de/identity/authentication/authentication-policies) der App aus,
bevor Zugriff gewährt wird. Einen vollständigen Überblick finden Sie unter
[Systemarchitektur](/de/identity/getting-started/system-architecture).

## Verwandte Themen

<CardGroup cols={2}>
  <Card title="Föderierte Authentifizierung" icon="plug" href="/de/identity/connections/connections-overview">
    Anwendungsfälle, Domänenbeschränkungen und Benutzerzuordnung an einem Ort erklärt.
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/de/identity/connections/microsoft-entra-id">
    Verbinden Sie Microsoft Entra ID für die Anmeldung mit der eigenen Vorlage.
  </Card>

  <Card title="Anmeldeerlebnis" icon="arrow-right-to-bracket" href="/de/identity/authentication/sign-in-experience">
    Gestalten Sie, was Benutzer bei der Anmeldung sehen.
  </Card>

  <Card title="Benutzerdefiniertes SAML" icon="shield-halved" href="/de/identity/connections/custom-saml">
    Verbinden Sie einen Anbieter, der nicht durch eine Vorlage abgedeckt ist.
  </Card>
</CardGroup>