> ## 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 Microsoft Entra ID (nativ)

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

### Über die native Microsoft Entra ID-Integration

Mit der nativen Microsoft Entra ID-Integration in Iru Endpoint können Sie eine native Microsoft Entra ID-Integration für SSO einrichten. Benutzer authentifizieren sich mit ihren Microsoft Entra ID-Anmeldedaten über OAuth2/OpenID Connect.

#### Funktionsweise

Wenn Benutzer versuchen, auf Iru Endpoint zuzugreifen, werden sie zur Authentifizierung über die Protokolle OAuth2/OpenID Connect an Microsoft Entra ID weitergeleitet. Nach erfolgreicher Authentifizierung sendet Microsoft Entra ID ein Zugriffstoken an Iru Endpoint zurück, das die Identität des Benutzers validiert und Zugriff gewährt. SSO kann für die Anmeldung bei der [Iru Endpoint-Web-App](/de/endpoint/getting-started/foundation/admins-and-access) und für [Require Authentication mit Automated Device Enrollment](/de/endpoint/enrollment/configure-require-authentication-for-enrollment) verwendet werden.

<Note>
  Microsoft Entra ID [ist der neue Name](https://learn.microsoft.com/en-us/entra/fundamentals/new-name) für Azure AD (Azure Active Directory)
</Note>

> Da Client Secrets eine maximale Lebensdauer von 24 Monaten haben, empfehlen wir, [SAML-basiertes Single Sign-On](/de/endpoint/integrations/single-sign-on-integrations/single-sign-on-with-microsoft-entra-id-saml) zu konfigurieren, anstatt die in diesem Dokument beschriebene Methode zu verwenden.

### 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 Administratorkonto in Microsoft Entra ID mit Berechtigungen zum Erstellen von App-Registrierungen (z. B. Global Administrator, Application Administrator oder Cloud Application Administrator)

<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="Authentifizierungsmethode auswählen">
        Wählen Sie **Microsoft Entra ID** als Authentifizierungsmethode 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 Microsoft Entra ID.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_10-54-56.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=944f34794f4d9a91d0b2c90e23c3889d" alt="Redirect-URL für Entra ID in Iru Endpoint kopieren" width="1924" height="1638" data-path="assets/media/images/entra_native_10-54-56.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 Microsoft Entra ID**, um fortzufahren.
      </Step>
    </Steps>

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

    <Info>
      Kehren Sie nach Abschluss der Konfiguration in Microsoft Entra ID 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 Microsoft Entra ID kopiert haben.
    </Info>

    <Steps>
      <Step title="Verzeichnisdomain eingeben">
        Geben Sie die **Tenant ID**, unter der die Anwendung registriert wurde, in das Feld **Microsoft Entra ID Domain** ein. Informationen zum Auffinden Ihrer Tenant ID finden Sie in der [Dokumentation von Microsoft](https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/find-tenant-id-domain).
      </Step>

      <Step title="Client-ID eingeben">
        Geben Sie die **Client ID** ein, die Sie zuvor aus dem Microsoft Entra Admin Center kopiert haben.
      </Step>

      <Step title="Client Secret eingeben">
        Geben Sie das **Client Secret** ein, das Sie zuvor aus dem Microsoft Entra Admin Center kopiert haben.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_12-00-35.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=652ba4ba977cabe185b104cfd2913bbc" alt="Tenant ID, Client ID, Client Secret und Save in Iru Endpoint" width="1646" height="1640" data-path="assets/media/images/entra_native_12-00-35.png" />
        </Frame>
      </Step>

      <Step title="Verbindung autorisieren">
        Nach dem Speichern wird ein neues Dialogfeld mit einem Link zum **Autorisieren Ihrer Verbindung** angezeigt. Ein Microsoft Entra ID-Administrator Ihrer Domain muss den Link auswählen und diesen Vorgang abschließen, um die Anwendung zu autorisieren. Dieses Dialogfeld wird nach Abschluss der Autorisierung nicht ausgeblendet.
      </Step>

      <Step title="Autorisierung abschließen">
        Melden Sie sich im neu geöffneten Fenster an und wählen Sie **Accept** aus.
      </Step>

      <Step title="Autorisierung überprüfen">
        Nachdem Sie **Accept** ausgewählt haben, gelangen Sie zu einer Seite, die die erfolgreiche Autorisierung bestätigt.
      </Step>

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

    <Warning>
      Wenn der Fehler "Failed to obtain access token" auftritt, liegt dies möglicherweise daran, dass die Secret-ID anstelle des korrekten Werts verwendet wurde.
    </Warning>

    ### Für Tenant-Authentifizierung zulassen

    Nachdem Sie die SAML-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 SAML-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).

    ### Erneuern des Client Secrets

    <Steps>
      <Step title="Neues Client Secret erstellen">
        Befolgen Sie die Schritte auf der Registerkarte **Konfiguration in Microsoft Entra ID** oben, um ein neues Client Secret zu erstellen. Führen Sie die Schritte "Certificates and Secrets öffnen" bis "Secret-Wert kopieren" aus, um ein neues Client Secret zu erstellen und den Wert zu kopieren.
      </Step>

      <Step title="Zu Verwaltung und Authentifizierung navigieren">
        Kehren Sie nach dem Kopieren des Werts zur Registerkarte **Konfiguration in der Iru-Web-App** zurück und führen Sie die Schritte 1–3 aus dem Abschnitt **Konfigurieren der Iru Endpoint-Verbindung** aus.
      </Step>

      <Step title="SSO-Integration auswählen">
        Wählen Sie die Auslassungspunkte neben der SSO-Integration aus, die weiter oben in diesem Artikel erstellt wurde.
      </Step>

      <Step title="SSO-Integration bearbeiten">
        Wählen Sie **Bearbeiten** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-37-39.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=4ee6a9ed63ead1405c742d939bc4260d" alt="Auslassungspunkte neben der SSO-Integration mit Edit in Iru Endpoint" width="2198" height="1648" data-path="assets/media/images/entra_native_08-37-39.png" />
        </Frame>
      </Step>

      <Step title="Client Secret bearbeiten">
        Wählen Sie die Schaltfläche **Edit client secret** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-43-21.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=a7c8aa2f5d98d61121a1878564b851cc" alt="Schaltfläche Edit client secret in Iru Endpoint" width="1730" height="1642" data-path="assets/media/images/entra_native_08-43-21.png" />
        </Frame>
      </Step>

      <Step title="Client Secret aktualisieren">
        Fügen Sie den zuvor kopierten neuen Wert für **Client secret** ein.
      </Step>

      <Step title="Änderungen speichern">
        Wählen Sie **Speichern** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-46-11.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=7059a9ab71febe26517d39f8b0eee2ce" alt="Save nach dem Aktualisieren des Client Secrets in Iru Endpoint" width="1702" height="1640" data-path="assets/media/images/entra_native_08-46-11.png" />
        </Frame>
      </Step>

      <Step title="Konfiguration testen">
        Testen Sie die Konfiguration unbedingt, indem Sie sich bei der Iru Endpoint-Web-App anmelden und die erstellte native SSO-Anmeldeoption auswählen. Testen Sie dies in einem privaten Browserfenster bzw. Inkognito-Fenster und überprüfen Sie, ob Sie sich bei der Iru Endpoint-Web-App anmelden können.
      </Step>

      <Step title="Altes Secret bereinigen">
        Anschließend können Sie optional das vorherige Client Secret aus der App-Registrierung in Entra ID löschen.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Konfiguration in Microsoft Entra ID">
    ### Einrichten der Microsoft Entra ID-Anwendung

    <Note>
      Schließen Sie vor Beginn der Konfiguration in Microsoft Entra ID die Ersteinrichtung auf der Registerkarte **Konfiguration in der Iru-Web-App** ab, um die Redirect-URL zu erhalten. Sie benötigen diesen Wert zur Konfiguration der Microsoft Entra ID-Anwendung.
    </Note>

    Führen Sie die folgenden Schritte aus, um Ihre Microsoft Entra ID-Anwendung zu konfigurieren:

    <Steps>
      <Step title="Microsoft Entra Admin Center öffnen">
        Melden Sie sich beim [Microsoft Entra Admin Center](https://entra.microsoft.com) an.
      </Step>

      <Step title="Abschnitt Entra ID erweitern">
        Stellen Sie sicher, dass in der linken Navigationsleiste der Abschnitt **Entra ID** erweitert ist.
      </Step>

      <Step title="Zu Anwendungen navigieren">
        Wählen Sie in der linken Navigationsleiste **App registrations** aus.
      </Step>

      <Step title="Neue Registrierung erstellen">
        Wählen Sie **+ New registration** aus, um eine neue Anwendung zu registrieren.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-10-59.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=fda999ea57500f53e90ef2df74b9fc7a" alt="Entra ID App registrations mit New registration" width="2750" height="1454" data-path="assets/media/images/entra_native_11-10-59.png" />
        </Frame>
      </Step>

      <Step title="Anwendung benennen">
        Geben Sie im Feld **Name** einen Namen für die Anwendung an (z. B. "Iru Native SSO").
      </Step>

      <Step title="Kontotypen auswählen">
        Wählen Sie für "**Unterstützte Kontotypen**" die Option **Accounts in this organizational directory only** aus.
      </Step>

      <Step title="Redirect URIs konfigurieren">
        Wählen Sie im Feld **Redirect URI** im Dropdown-Menü **Web** aus.
      </Step>

      <Step title="Redirect URI eingeben">
        Geben Sie die vollständige Redirect-URL ein, die Sie aus der Konfiguration in der Iru-Web-App kopiert haben (z. B. `https://vpriix.id.iru.com/federated-auth/oidc/callback`).
      </Step>

      <Step title="Anwendung registrieren">
        Wählen Sie **Registrieren** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-30-17.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=05f8f539e3144b5d1c2b069f3ee31d87" alt="Entra ID mit Name, Unterstützte Kontotypen, Redirect URI und Register" width="2358" height="1634" data-path="assets/media/images/entra_native_11-30-17.png" />
        </Frame>
      </Step>

      <Step title="Client-ID kopieren">
        Kopieren Sie auf der neuen Seite die **Application (client) ID** und speichern Sie sie für später. Sie wird in Iru als **Client ID** verwendet.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-40-58.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=790029fe79b3f9dea7429be5d92d2c6b" alt="Application (client) ID in Entra ID kopieren" width="2716" height="1622" data-path="assets/media/images/entra_native_11-40-58.png" />
        </Frame>
      </Step>

      <Step title="Certificates and Secrets öffnen">
        Wählen Sie **Certificates and Secrets** aus.
      </Step>

      <Step title="Neues Client Secret erstellen">
        Wählen Sie **New client secret** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-44-51.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=884d74d10d01813ce5fece20d2dbd1b0" alt="Entra ID Certificates and Secrets mit New client secret" width="2716" height="1528" data-path="assets/media/images/entra_native_11-44-51.png" />
        </Frame>
      </Step>

      <Step title="Secret-Details konfigurieren">
        Geben Sie dem Client Secret eine **Beschreibung** wie "Iru Native SSO".
      </Step>

      <Step title="Ablauf festlegen">
        Legen Sie den Ablauf auf **24 months** fest.
      </Step>

      <Step title="Secret hinzufügen">
        Wählen Sie **Hinzufügen** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-47-12.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=532c64c0100928deb9ed852b02cfa0bf" alt="Entra ID Client Secret mit Description, Ablauf und Add" width="1152" height="446" data-path="assets/media/images/entra_native_11-47-12.png" />
        </Frame>
      </Step>

      <Step title="Secret-Wert kopieren">
        Kopieren Sie den **Wert** des Client Secrets und speichern Sie ihn für später. **Beachten Sie, dass sich der Value des Client Secrets von der Client Secret ID unterscheidet.**

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-48-27.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=3d3cc4b5e7e7ddacaab50425208efc32" alt="Value des Client Secrets in Entra ID kopieren" width="3020" height="1628" data-path="assets/media/images/entra_native_11-48-27.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Kehren Sie nach Abschluss der Konfiguration in Microsoft Entra ID zur Registerkarte **Konfiguration in der Iru-Web-App** zurück, um die Einrichtung der SSO-Verbindung mit der Client-ID und dem Client Secret abzuschließen, die Sie aus Microsoft Entra ID kopiert haben.
    </Note>
  </Tab>
</Tabs>

## Überlegungen

**Sicherheit**: Stellen Sie sicher, dass in Ihrem Microsoft Entra ID-Tenant geeignete Sicherheitsrichtlinien für die OAuth2/OpenID Connect-Authentifizierung konfiguriert sind.

**Verwaltung von Client Secrets**: Client Secrets laufen nach 24 Monaten ab und müssen regelmäßig erneuert werden. Ziehen Sie für langfristige Lösungen SAML-basiertes SSO in Betracht.

**Testen**: Testen Sie die SSO-Integration immer mit einer kleinen Gruppe von Benutzern, bevor Sie sie in Ihrer gesamten Organisation einführen.

**Benutzerverwaltung**: Benutzer müssen sowohl in Microsoft Entra ID als auch in Iru Endpoint vorhanden sein, um sich erfolgreich per SSO authentifizieren zu können.