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

# Single Sign-On mit Google Workspace (nativ)

> Konfigurieren Sie natives Google Workspace-SSO für Iru Endpoint mit OAuth2 und OpenID Connect. Ermöglichen Sie Administratoren die Anmeldung mit einem Klick über ihre Google-Anmeldedaten.

### Über die native Google Workspace-Integration

Mit der nativen Google Workspace-Integration in Iru Endpoint können Sie eine native Google Workspace-Integration für SSO einrichten. Benutzer authentifizieren sich mit ihren Google Workspace-Anmeldedaten, ohne dass eine benutzerdefinierte SAML-Konfiguration erforderlich ist.

#### Funktionsweise

Wenn Benutzer versuchen, auf Iru Endpoint zuzugreifen, werden sie zur Authentifizierung über die Protokolle OAuth2/OpenID Connect an Google Workspace weitergeleitet. Nach erfolgreicher Authentifizierung sendet Google Workspace ein Zugriffstoken an Iru Endpoint zurück, das die Identität des Benutzers validiert und Zugriff auf die Plattform gewährt.

<Warning>
  Wenn Sie für iOS-Registrierungen [Authentifizierung mit Automated Device Enrollment voraussetzen](/de/endpoint/enrollment/configure-require-authentication-for-enrollment) und Google Workspace als Identitätsanbieter verwenden, muss der Single Sign-On-Eintrag [mit Custom SAML](/de/endpoint/integrations/single-sign-on-integrations/single-sign-on-with-google-workspace-saml) erstellt werden. Die integrierte Google Workspace-Integration wird nicht unterstützt.
</Warning>

### Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

* [Zugriff auf die Iru Endpoint-Web-App](/de/endpoint/getting-started/foundation/admins-and-access) als Admin oder Account Owner
* Ein Google Workspace-Super-Administratorkonto, um die Konfigurationsschritte in Google Workspace durchzuführen

<Tabs>
  <Tab title="Konfiguration in der Iru-Web-App">
    ### Konfigurieren der Iru Endpoint-Verbindung

    Führen Sie die folgenden Schritte aus, um die Verbindung in Iru zu konfigurieren:

    <Steps>
      <Step title="Zur Schaltfläche des Kontomenüs navigieren">
        Wählen Sie in Iru Endpoint in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) aus.
      </Step>

      <Step title="Authentifizierungseinstellungen öffnen">
        Wählen Sie im Menü die Option **Zugriff** aus.

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

      <Step title="Verwaltung und Authentifizierung auswählen">
        Wählen Sie die Registerkarte **Verwaltung und Authentifizierung** aus (standardmäßig ausgewählt) und scrollen Sie nach unten zu **Authentifizierungsmethoden**.
      </Step>

      <Step title="Authentifizierungsmethode hinzufügen">
        Wählen Sie **+ Authentifizierungsmethode** aus.
      </Step>

      <Step title="Anzeigenamen eingeben">
        Geben Sie einen Anzeigenamen für die SSO-Verbindung ein.
      </Step>

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

      <Step title="Verbindung erstellen">
        Wählen Sie **Erstellen** aus.
      </Step>

      <Step title="Redirect-URL kopieren">
        Kopieren Sie die **Redirect URL** zur späteren Verwendung in ein Textdokument. Sie benötigen sie für die Konfiguration in Google Workspace.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-32-18.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=8e9eb7c658d0c596801cb59a4e78a609" alt="Iru Endpoint-SSO-Redirect-URL, die für Google Workspace kopiert werden muss" width="1318" height="520" data-path="assets/media/images/google-native_09-32-18.png" />
        </Frame>
      </Step>

      <Step title="Tab geöffnet lassen">
        Lassen Sie das Konfigurationsdialogfeld der Iru-Web-App geöffnet und wechseln Sie dann zur Registerkarte [**Konfiguration in Google Workspace**](#google-workspace-configuration), um mit [**Einrichten der Google Workspace-Anwendung**](#setting-up-google-workspace-application) fortzufahren.
      </Step>
    </Steps>

    <Note>
      Kehren Sie nach Abschluss der [**Konfiguration in Google Workspace**](#google-workspace-configuration) hierher zurück, um die Einrichtung der SSO-Verbindung in Iru Endpoint abzuschließen. Sie benötigen die Client-ID und das Client Secret, die Sie aus Google Workspace kopiert haben.
    </Note>

    ### Abschließen der Iru Endpoint-Verbindung

    Führen Sie die folgenden Schritte aus, um die Konfiguration abzuschließen:

    <Steps>
      <Step title="Google Workspace-Domain eingeben">
        Geben Sie Ihre **Google Workspace domain** aus Google Workspace ein.
      </Step>

      <Step title="Client-ID einfügen">
        Fügen Sie die aus Google Workspace kopierte **Client ID** in das Feld **Client ID** ein.
      </Step>

      <Step title="Client Secret einfügen">
        Fügen Sie das aus Google Workspace kopierte **Client secret** in das Feld **Client secret** ein.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_10-05-01.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=ce0bce036daf3da619b3c8aa25745d8c" alt="Feld Client secret in Iru Endpoint für Google Workspace" width="2118" height="1646" data-path="assets/media/images/google-native_10-05-01.png" />
        </Frame>
      </Step>

      <Step title="Konfiguration speichern">
        Wählen Sie **Speichern** aus.
      </Step>

      <Step title="Einrichtung bestätigen">
        Ihre Verbindung wurde nun erfolgreich konfiguriert und kann aktiviert und getestet werden.
      </Step>
    </Steps>

    ### Für Tenant-Authentifizierung zulassen

    Nachdem Sie die OIDC-Verbindung in Iru Endpoint und in Ihrem Identitätsanbieter konfiguriert haben, können Sie deren Verwendung für die Tenant-Authentifizierung zulassen. Schrittweise Anleitungen finden Sie im Abschnitt **Tenant-Authentifizierung zulassen und Verbindungen verwalten** in unserem [Support-Artikel zu Single Sign-On](/de/endpoint/integrations/single-sign-on-integrations/single-sign-on).

    ### Authentifizierung auf Domain beschränken

    Bei der Konfiguration der OIDC-Verbindung können Sie die Authentifizierung optional auf eine oder mehrere Domains beschränken. Dies kann nützlich sein, wenn die SSO-Verbindung bei mehreren Domains authentifizieren könnte. Sie können die Authentifizierung bei Ihrem Iru-Tenant auf eine Teilmenge der verfügbaren Domains beschränken.

    ### Single Sign-On erzwingen

    Sobald Sie mindestens eine Single Sign-On-Verbindung konfiguriert haben, können Sie die Verbindungen Passkey, Google Social und Microsoft Social deaktivieren. Durch das Deaktivieren dieser Verbindungen können sich Iru Endpoint-Administratoren in Ihrem Tenant nicht mehr über diese Methoden authentifizieren. Schrittweise Anleitungen finden Sie in unserem [Support-Artikel zu Single Sign-On](/de/endpoint/integrations/single-sign-on-integrations/single-sign-on).
  </Tab>

  <Tab title="Konfiguration in Google Workspace">
    ### Einrichten der Google Workspace-Anwendung

    <Note>
      Schließen Sie vor Beginn der Konfiguration in Google Workspace die Ersteinrichtung auf der Registerkarte [**Konfiguration in der Iru-Web-App**](#iru-web-app-configuration) unter [**Konfigurieren der Iru Endpoint-Verbindung**](#configuring-iru-endpoint-connection) ab, um die Redirect-URL zu erhalten. Sie benötigen diesen Wert zur Konfiguration der Google Workspace-Anwendung.
    </Note>

    Führen Sie die folgenden Schritte aus, um Ihre Google Workspace-Anwendung zu konfigurieren:

    <Steps>
      <Step title="Google Cloud Console öffnen">
        **Melden Sie sich** bei der [Google Cloud Console](https://console.cloud.google.com/) **an**.
      </Step>

      <Step title="Projekt erstellen">
        Wählen Sie **Create project** aus.

        Falls **Create project** nicht verfügbar ist, wählen Sie oben links auf dem Bildschirm die Projektauswahl aus.

        <Frame>
          <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-native-sso-create-project-or-project-selector.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=b7dd8b28183ead2f419e234ae8ed2f46" alt="Seite APIs & Services in Google Cloud mit Create project und der Projektauswahl" width="2300" height="886" data-path="assets/media/images/iru-google-native-sso-create-project-or-project-selector.png" />
        </Frame>
      </Step>

      <Step title="Organisation und neues Projekt auswählen">
        Wenn Sie **Create project** ausgewählt haben, überspringen Sie diesen Schritt. Falls **Create project** nicht verfügbar war, wählen Sie in der Projektauswahl die Organisation und dann **New project** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-native-sso-select-org-and-new-project.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=3d441441c38efc5d951512896772c464" alt="Dialogfeld Select a resource in Google Cloud mit ausgewählter Organisation und New project" width="1584" height="600" data-path="assets/media/images/iru-google-native-sso-select-org-and-new-project.png" />
        </Frame>
      </Step>

      <Step title="Projektdetails konfigurieren">
        Geben Sie einen **Project name** ein.
      </Step>

      <Step title="Organisation auswählen">
        Wählen Sie im Dropdown-Menü die **Organisation** aus.
      </Step>

      <Step title="Speicherort auswählen">
        Wählen Sie die **Location** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-30-58.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=54f4d8f6168d88108d525e7efa484cc8" alt="Dropdown Location für das Projekt in der Google API Console" width="2598" height="874" data-path="assets/media/images/google-native_08-30-58.png" />
        </Frame>
      </Step>

      <Step title="Projekt erstellen">
        Wählen Sie **Erstellen** aus.
      </Step>

      <Step title="Anmeldedaten öffnen">
        Wählen Sie in der Seitenleiste **Credentials** aus.
      </Step>

      <Step title="Zustimmungsbildschirm konfigurieren">
        Wenn Sie zum ersten Mal eine Client-ID erstellen, werden Sie möglicherweise auch aufgefordert, [Ihren Zustimmungsbildschirm zu konfigurieren](https://support.google.com/googleapi/answer/6158849#zippy=%2Cuser-consent).

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-45-03.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=3370df7712a2cd9e0d3d11cd3425bf17" alt="Aufforderung zur Konfiguration des Google-Zustimmungsbildschirms" width="2888" height="1204" data-path="assets/media/images/google-native_08-45-03.png" />
        </Frame>
      </Step>

      <Step title="Anmeldedaten erstellen">
        Wählen Sie oben rechts im Fenster **+ Create credentials** aus.
      </Step>

      <Step title="OAuth Client ID auswählen">
        Wählen Sie im angezeigten Menü **OAuth Client ID** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-50-16.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=de24f6c68f2f98e2bad93052d10646c6" alt="Google Create credentials mit OAuth Client ID" width="2600" height="972" data-path="assets/media/images/google-native_08-50-16.png" />
        </Frame>
      </Step>

      <Step title="Anwendungstyp konfigurieren">
        Öffnen Sie für "**Application Type**" das Menü und wählen Sie "**Web application**" aus.
      </Step>

      <Step title="OAuth-Client benennen">
        Geben Sie im Feld **Name** einen **Name** für Ihren OAuth-Client ein.
      </Step>

      <Step title="Authorized JavaScript Origins konfigurieren">
        Verwenden Sie für **Authorized JavaScript Origins** nur den Domain-Teil der Redirect-URL, die Sie von der Registerkarte [**Konfiguration in der Iru-Web-App**](#iru-web-app-configuration) kopiert haben (z. B. `https://vpriix.id.iru.com`). Diese Domain ist für jeden Iru-Tenant eindeutig.
      </Step>

      <Step title="Authorized Redirect URIs konfigurieren">
        Geben Sie für **Authorized redirect URIs** die vollständige Redirect-URL ein, die Sie von der Registerkarte [**Konfiguration in der Iru-Web-App**](#iru-web-app-configuration) kopiert haben (z. B. `https://vpriix.id.iru.com/federated-auth/oidc/callback`).

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-26-03.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=c5f3ce845da4a0d0ace07f6ab0d2829b" alt="Dokumentation zu Single Sign-On mit Google Workspace (nativ) mit der Konfiguration der Authorized redirect URIs" width="3090" height="2136" data-path="assets/media/images/google-native_09-26-03.png" />
        </Frame>
      </Step>

      <Step title="OAuth-Client erstellen">
        Wählen Sie **Erstellen** aus.
      </Step>

      <Step title="Client-ID kopieren">
        Kopieren Sie den Text aus dem Feld **Client ID** und speichern Sie ihn zur späteren Verwendung.
      </Step>

      <Step title="Client Secret kopieren">
        Kopieren Sie den Text aus dem Feld **Client Secret** und speichern Sie ihn zur späteren Verwendung.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-27-24.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=dc6b3de9f1f68cacf3d4c0f3a4757584" alt="Felder Client ID und Client Secret des Google OAuth-Clients" width="1112" height="1314" data-path="assets/media/images/google-native_09-27-24.png" />
        </Frame>
      </Step>

      <Step title="OK auswählen">
        Wählen Sie **OK** aus.
      </Step>
    </Steps>

    <Note>
      Kehren Sie nach Abschluss der Konfiguration in Google Workspace zur Registerkarte [**Konfiguration in der Iru-Web-App**](#iru-web-app-configuration) zurück und fahren Sie mit [**Abschließen der Iru Endpoint-Verbindung**](#completing-the-iru-endpoint-connection) fort, um die Einrichtung der SSO-Verbindung mit der Client-ID und dem Client Secret abzuschließen, die Sie aus Google Workspace kopiert haben.
    </Note>
  </Tab>
</Tabs>