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

# Passport-Konfiguration mit OneLogin

> Konfigurieren Sie Passport mit OneLogin in Iru Endpoint für die macOS-Anmeldung und Passwortsynchronisierung. Richten Sie die OneLogin-App-Integration und die Authentifizierung ein.

<Callout icon="apple" color="#B84A7A" iconType="regular">Diese Anleitung gilt für Mac-Computer</Callout>

## Über Passport mit OneLogin

Mit Passport und OneLogin können sich Benutzer mit ihren OneLogin-Anmeldedaten an Mac-Computern anmelden. Diese Integration bietet eine sichere Authentifizierung über das OneLogin-Identitätssystem Ihrer Organisation und unterstützt Standard- sowie Multi-Faktor-Authentifizierung.

## Funktionsweise

Passport wird über OpenID Connect (OIDC) in Ihre OneLogin-Instanz integriert, um Benutzer am macOS-Anmeldebildschirm zu authentifizieren. Ob Sie MFA für die Passport-Anmeldung benötigen, bestimmt, wie viele OIDC-Anwendungen Sie in OneLogin erstellen und ob Sie Authentifizierungsmodus im Passport Library Item auf Webanmeldung oder Mac-Anmeldung setzen.

<Tabs>
  <Tab title="OneLogin" id="onelogin">
    ## Voraussetzungen

    * Verwenden Sie zum Hinzufügen von Apps in OneLogin ein Konto, das Super User oder Account Owner ist.

    ## Eine OIDC-App konfigurieren

    Wenn Sie keine MFA für die Passport-Anmeldung benötigen, setzen Sie **Authentifizierungsmodus** im Passport Library Item auf **Mac-Anmeldung** und folgen Sie nur dem Abschnitt [Mac-Anmeldung](#onelogin-oidc-mac-login) (überspringen Sie [Webanmeldung](#onelogin-oidc-web-login)).

    Wenn Sie MFA bei der Anmeldung benötigen, setzen Sie **Authentifizierungsmodus** auf **Webanmeldung**. Sie müssen in OneLogin **zwei** OIDC-Apps erstellen: zuerst **Mac-Anmeldung** (Anmeldung und Passwortsynchronisierung mit dem Mac), dann **Webanmeldung** (MFA in der eingebetteten Webansicht). Folgen Sie dem Abschnitt **Mac-Anmeldung** und dann dem Abschnitt **Webanmeldung** in dieser Reihenfolge.

    <span id="onelogin-oidc-mac-login" />

    ### Mac-Anmeldung

    Erstellen Sie die Mac-Login-OIDC-Anwendung in OneLogin. In diesem Artikel wird der Anzeigename *Iru Passport Mac-Anmeldung* verwendet.

    Jede Bereitstellung verwendet diese App. Mit **Mac-Anmeldung** als Authentifizierungsmodus ist sie die einzige OneLogin-OIDC-App, die Sie in dieser Anleitung hinzufügen. Bei **Webanmeldung** (MFA) fügen Sie zuerst diese App hinzu und fahren dann mit [Webanmeldung](#onelogin-oidc-web-login) fort.

    <Steps>
      <Step title="Bei OneLogin anmelden">
        Melden Sie sich als Account Owner oder Super User bei OneLogin an.
      </Step>

      <Step title="Zu Applications navigieren">
        Navigieren Sie in Ihrer OneLogin-Admin-Konsole zur Seite **Anwendungen**.
      </Step>

      <Step title="Neue App hinzufügen">
        Wählen Sie oben rechts **Add App** aus.
      </Step>

      <Step title="Nach OIDC suchen">
        Geben Sie im Suchfeld oben links *OIDC* ein.
      </Step>

      <Step title="OpenID Connect auswählen">
        Wählen Sie **OpenID Connect (OIDC)** aus.
      </Step>

      <Step title="App-Details konfigurieren">
        Geben Sie im Feld **Display Name** einen aussagekräftigen Namen wie *Iru Passport Mac-Anmeldung* ein.
      </Step>

      <Step title="Sichtbarkeit festlegen">
        Stellen Sie den Schalter **Visible in portal** auf **Off**; diese App muss für die Funktion von Passport nicht sichtbar sein, und es könnte Benutzer verwirren, diese App in ihrem OneLogin-Portal zu sehen.
      </Step>

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

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

      <Step title="Redirect URI eingeben">
        Geben Sie im Feld **Redirect URIs** Folgendes ein:

        ```
        https://localhost.redirect
        ```

        <Note>
          Passport benötigt diesen Wert nicht, aber Sie können die App-Konfiguration nicht ohne einen Wert im Feld Redirect URIs speichern.
        </Note>
      </Step>

      <Step title="SSO-Einstellungen öffnen">
        Wählen Sie in der linken Seitenleiste **SSO** aus.
      </Step>

      <Step title="Application Type festlegen">
        Wählen Sie im Menü **Application Type** die Option **Native** aus.
      </Step>

      <Step title="Token Endpoint festlegen">
        Wählen Sie im Menü **Token Endpoint** die Option **None (PKCE)** aus.
      </Step>

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

    #### Konfigurationsdetails für Mac-Anmeldung sammeln

    <Steps>
      <Step title="Sicheres Dokument vorbereiten">
        Diese OIDC-App hält das Mac-Passwort mit OneLogin synchron. Öffnen Sie ein sicheres Textdokument, in dem Sie die Werte für diese OIDC-App speichern können. Sie benötigen die Client ID und die Issuer URL, wenn Sie das Passport Library Item konfigurieren (das Client-Secret benötigen Sie nicht).
      </Step>

      <Step title="Client ID kopieren">
        Wählen Sie rechts neben dem Feld **Client ID** die Schaltfläche **Copy to Clipboard** aus (sieht wie eine Zwischenablage aus).
      </Step>

      <Step title="Client ID speichern">
        Fügen Sie die Client ID in das sichere Textdokument ein.
      </Step>

      <Step title="Issuer URL kopieren">
        Klicken Sie mit der rechten Maustaste (oder bei gedrückter Ctrl-Taste) auf den Link **Well-known Configuration** und kopieren Sie seinen Wert. Die Issuer URL ist Ihr OIDC-Well-known-Konfigurationsendpunkt und folgt diesem Muster:

        ```bash theme={null}
        https://{subdomain}.onelogin.com/oidc/2/.well-known/openid-configuration
        ```
      </Step>

      <Step title="Issuer URL speichern">
        Fügen Sie die Issuer URL in das sichere Textdokument ein.
      </Step>

      <Step title="Dokument speichern">
        Speichern Sie das sichere Textdokument.
      </Step>

      <Step title="App Benutzern zuweisen">
        Weisen Sie die App in OneLogin den Benutzern oder Gruppen zu, die sich mit Passport an ihren Mac-Computern anmelden werden.
      </Step>
    </Steps>

    <Note>
      Wenn Sie Webanmeldung nicht verwenden (keine MFA), überspringen Sie den Abschnitt [Webanmeldung](#onelogin-oidc-web-login) unten, fahren Sie bei Bedarf für rollenbasierte Kontotypen mit [Einen Benutzerkontotyp nach Identitätsanbietergruppe in OneLogin konfigurieren](#configuring-a-user-account-type-by-identity-provider-group-in-onelogin) fort und öffnen Sie dann die [Registerkarte Iru Endpoint](#iru-endpoint).
    </Note>

    <span id="onelogin-oidc-web-login" />

    ### Webanmeldung

    Verwenden Sie diesen Abschnitt nur, wenn **Authentifizierungsmodus** auf **Webanmeldung** (MFA) eingestellt ist. Nachdem Sie [Mac-Anmeldung](#onelogin-oidc-mac-login) abgeschlossen haben, erstellen Sie hier die zweite OIDC-App. In diesem Artikel wird der Anzeigename *Iru Passport Webanmeldung* verwendet.

    <Steps>
      <Step title="Zu Applications navigieren">
        Navigieren Sie in Ihrer OneLogin-Admin-Konsole zur Seite **Anwendungen**.
      </Step>

      <Step title="Neue App hinzufügen">
        Wählen Sie oben rechts **Add App** aus.

        <Note>
          Wenn die Schaltfläche **Add App** nicht angezeigt wird, haben Sie möglicherweise zuvor **See the new apps list** ausgewählt. Damit OneLogin die Schaltfläche **Add App** anzeigt, entfernen Sie die Zeichenfolge */admin2* aus der URL. Verwenden Sie beispielsweise statt *[https://accuhive.onelogin.com/admin2/apps](https://accuhive.onelogin.com/admin2/apps)* die URL *[https://accuhive.onelogin.com/apps](https://accuhive.onelogin.com/apps)*.
        </Note>
      </Step>

      <Step title="Nach OIDC suchen">
        Geben Sie im Suchfeld oben links OIDC ein.
      </Step>

      <Step title="OpenID Connect auswählen">
        Wählen Sie **OpenID Connect (OIDC)** aus.
      </Step>

      <Step title="App-Details konfigurieren">
        Geben Sie im Feld Display Name einen aussagekräftigen Namen wie **Iru Passport Webanmeldung** ein.
      </Step>

      <Step title="Sichtbarkeit festlegen">
        Stellen Sie den Schalter **Visible in portal** auf **Off**; diese App muss für die Funktion von Passport nicht sichtbar sein, und es könnte Benutzer verwirren, diese App in ihrem OneLogin-Portal zu sehen.
      </Step>

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

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

      <Step title="Redirect URI eingeben">
        Geben Sie im Feld **Redirect URIs** Folgendes ein:

        ```
        https://localhost.redirect
        ```
      </Step>

      <Step title="SSO-Einstellungen öffnen">
        Wählen Sie in der linken Seitenleiste **SSO** aus.
      </Step>

      <Step title="Application Type festlegen">
        Wählen Sie im Menü **Application Type** die Option **Native** aus.
      </Step>

      <Step title="Authentication Method festlegen">
        Wählen Sie im Abschnitt **Token Endpoint** im Menü **Authentication Method** die Option **POST** aus. POST ist erforderlich, damit Benutzer MFA bei der Mac-Anmeldung in der Webansicht abschließen können.
      </Step>

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

    #### Konfigurationsdetails für Webanmeldung sammeln

    <Steps>
      <Step title="Sicheres Dokument vorbereiten">
        Diese OIDC-App liefert die Web-Login-Felder für das Passport Library Item. Öffnen Sie ein sicheres Textdokument, in dem Sie die Werte für diese OIDC-App speichern können. Sie benötigen die Client ID und das Client Secret dieser POST-App, wenn Sie das Passport Library Item konfigurieren. Wenn Sie bereits ein sicheres Dokument für die Mac-Login-OIDC-App haben, vermerken Sie, dass die neuen Werte für die Web-Login-OIDC-App gelten.
      </Step>

      <Step title="Client ID kopieren">
        Kopieren Sie den Inhalt des Felds **Client ID**.
      </Step>

      <Step title="Client ID speichern">
        Fügen Sie die Client ID in das sichere Textdokument ein.
      </Step>

      <Step title="Client-Secret anzeigen">
        Wählen Sie **Show client secret** aus.
      </Step>

      <Step title="Client-Secret kopieren">
        Kopieren Sie das Client-Secret.
      </Step>

      <Step title="Client-Secret speichern">
        Fügen Sie das Client-Secret in das sichere Textdokument ein.
      </Step>

      <Step title="Dokument speichern">
        Speichern Sie das sichere Dokument.
      </Step>

      <Step title="App Benutzern zuweisen">
        Weisen Sie die App in OneLogin den Benutzern oder Gruppen zu, die sich mit Webanmeldung (MFA) anmelden werden.
      </Step>
    </Steps>

    ## Einen Benutzerkontotyp nach Identitätsanbietergruppe in OneLogin konfigurieren

    Verwenden Sie diesen Abschnitt, wenn Sie OneLogin-Rollen in Passport Standard- oder Administrator-Mac-Konten zuordnen. Er gilt sowohl für Mac-Anmeldung (keine MFA) als auch für Webanmeldung (MFA).

    Folgen Sie den nachstehenden Schritten, um festzulegen, ob ein Benutzer ein Standardbenutzer oder ein Administrator sein wird.

    <Steps>
      <Step title="Roles öffnen">
        Melden Sie sich bei Ihrer OneLogin-Konsole an. Wählen Sie Users > Roles aus.

        <Frame>
          <img src="https://mintcdn.com/iru/g5XvVqFV1vl7oJEO/assets/media/images/iru-onelogin-users-roles-menu.png?fit=max&auto=format&n=g5XvVqFV1vl7oJEO&q=85&s=7832230128da495dda9f46604cb20f4c" alt="Menü Users der OneLogin-Konsole mit Roles" width="1089" height="589" data-path="assets/media/images/iru-onelogin-users-roles-menu.png" />
        </Frame>
      </Step>

      <Step title="Neue Rolle erstellen">
        Wählen Sie oben rechts auf dem Bildschirm **New Role** aus und benennen Sie Ihre Rolle. (*Stellen Sie sicher, dass der Rollenname mit dem IdP-Gruppennamen übereinstimmt, den Sie in Ihrer Iru Passport-Konfiguration verwenden.*) In diesem Beispiel heißt die Rolle Passport Admin Users. Wählen Sie abschließend Ihre in OneLogin erstellte Iru Passport-App aus und wählen Sie oben rechts auf dem Bildschirm **Speichern** aus.
      </Step>

      <Step title="App-Parameter konfigurieren">
        Navigieren Sie als Nächstes zu der Iru Passport-App, die Sie in OneLogin erstellt haben. Wählen Sie den Link **parameters** und dann das Feld **Gruppen** aus.
      </Step>

      <Step title="Standardwert festlegen">
        Wählen Sie im Abschnitt „Default if no value selected“ in der Dropdown-Liste User Roles aus und stellen Sie sicher, dass Semicolon Delimited Input ausgewählt ist. Wählen Sie **Speichern** aus.

        <Frame>
          <img src="https://mintcdn.com/iru/g5XvVqFV1vl7oJEO/assets/media/images/iru-onelogin-passport-groups-parameter.png?fit=max&auto=format&n=g5XvVqFV1vl7oJEO&q=85&s=15f0b569dd02121a46ed1cacd2ed551e" alt="OneLogin Edit Field Groups mit User Roles und Semicolon Delimited Input" width="642" height="633" data-path="assets/media/images/iru-onelogin-passport-groups-parameter.png" />
        </Frame>
      </Step>

      <Step title="Benutzer der Rolle zuweisen">
        Stellen Sie abschließend sicher, dass Ihre Benutzer Teil der von Ihnen erstellten Rolle sowie Mitglied der Iru Passport-Anwendung in OneLogin sind. Um einen Benutzer zu einer Rolle hinzuzufügen, wählen Sie Users > Roles > *Ihr Rollenname (z. B. Passport Admin Users)*, wählen Sie den Link **Benutzer**, suchen Sie nach dem Benutzer, aktivieren Sie das blaue **Kontrollkästchen**, wählen Sie den Link **Add to Role** und dann oben rechts auf der Seite **Speichern** aus.
      </Step>
    </Steps>

    <Note>
      Wenn die OIDC-Apps und Rollen in OneLogin Ihren Anforderungen entsprechen, öffnen Sie die [Registerkarte Iru Endpoint](#iru-endpoint), um Werte in das Passport Library Item einzugeben. Auf dieser Registerkarte enthält Benutzerbereitstellung ein Beispiel für den Fall, dass eine OneLogin-Rolle den Namen der Administratorgruppe liefert.
    </Note>
  </Tab>

  <Tab title="Iru Endpoint" id="iru-endpoint">
    Falls noch nicht geschehen, verwenden Sie [Das Passport Library Item konfigurieren](/de/endpoint/library/passport/configure-the-passport-library-item), um das Passport Library Item und die Grundeinstellungen hinzuzufügen. Die folgenden Schritte sind die für OneLogin Passport spezifischen Schritte in Iru Endpoint; verwenden Sie die Werte, die Sie auf der [Registerkarte OneLogin](#onelogin) gesammelt haben.

    ### Authentifizierungsmodus

    Legen Sie **Authentifizierungsmodus** im Passport Library Item passend dazu fest, wie sich Benutzer mit OneLogin anmelden. Verwenden Sie **Webanmeldung**, wenn MFA gilt, und **Mac-Anmeldung**, wenn nicht.

    In OneLogin konfigurieren Sie immer die Mac-Login-OIDC-App; fügen Sie die Web-Login-OIDC-App als zweite App hinzu, wenn Sie MFA verwenden, wie auf der [Registerkarte OneLogin](#onelogin) beschrieben.

    #### Webanmeldung

    Wenn Sie Multi-Faktor-Authentifizierung mit Passport verwenden, müssen Sie **Webanmeldung** als Authentifizierungsmodus verwenden, damit Benutzer MFA während der Anmeldung abschließen können. Sie sollten bereits zwei OIDC-Apps in OneLogin erstellt haben (Mac-Anmeldung, dann Webanmeldung).

    Wenn **Identitätsanbieter** im Passport Library Item auf **OneLogin** und **Authentifizierungsmodus** auf **Webanmeldung** eingestellt ist, muss die **zweite** OneLogin-OIDC-Anwendung am Token-Endpunkt die Authentifizierungsmethode **POST** verwenden (siehe die Schritte für die OIDC-App [Webanmeldung](#onelogin-oidc-web-login) auf der [Registerkarte OneLogin](#onelogin)). Geben Sie im Library Item die Client-ID dieser zweiten Anwendung unter **Client ID (Web Authentication)**, die Redirect-URI unter **Redirect URI** und das Client-Secret unter **Client secret** ein (Schritte unten).

    <Steps>
      <Step title="OneLogin als Identity Provider auswählen">
        Setzen Sie im Passport Library Item **Identitätsanbieter** auf **OneLogin**.
      </Step>

      <Step title="Identitätsanbieter-URL eingeben">
        Geben Sie im Feld **Identitätsanbieter-URL** die OIDC-Well-known-Konfigurations-URL (Issuer URL) der **Mac-Anmeldung**-OIDC-App ein, die Sie auf der [Registerkarte OneLogin](#onelogin) gesammelt haben. Sie folgt diesem Muster:

        ```bash theme={null}
        https://{subdomain}.onelogin.com/oidc/2/.well-known/openid-configuration
        ```
      </Step>

      <Step title="Client ID (Kennwortsynchronisierung) eingeben">
        Geben Sie im Feld **Client ID (Password Sync)** die Client ID der **Mac-Anmeldung**-OIDC-Anwendung von der [Registerkarte OneLogin](#onelogin) ein.
      </Step>

      <Step title="Webanmeldung auswählen">
        Wählen Sie unter **Authentifizierungsmodus** die Option **Webanmeldung** aus.
      </Step>

      <Step title="Client ID (Web Authentication) eingeben">
        Geben Sie im Feld **Client ID (Web Authentication)** die Client-ID der Web-Login-OIDC-Anwendung ein, die Sie auf der [Registerkarte OneLogin](#onelogin) gesammelt haben.
      </Step>

      <Step title="Redirect URI eingeben">
        Geben Sie im Feld **Redirect URI** Folgendes ein:

        ```
        https://localhost.redirect
        ```
      </Step>

      <Step title="Client secret eingeben">
        Geben Sie im Feld **Client secret** das Client-Secret der Web-Login-OIDC-Anwendung in OneLogin ein.
      </Step>

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

    #### Mac-Anmeldung

    Wenn Sie MFA nicht mit Passport verwenden, verwenden Sie **Mac-Anmeldung** als Authentifizierungsmodus. Benutzer melden sich im Mac-Anmeldefenster mit ihrem OneLogin-Passwort ohne den MFA-Ablauf von Webanmeldung an. Sie sollten bereits eine OIDC-App in OneLogin erstellt haben (nur Mac-Anmeldung).

    <Steps>
      <Step title="OneLogin als Identity Provider auswählen">
        Setzen Sie im Passport Library Item **Identitätsanbieter** auf **OneLogin**.
      </Step>

      <Step title="Identitätsanbieter-URL eingeben">
        Geben Sie im Feld **Identitätsanbieter-URL** die OIDC-Well-known-Konfigurations-URL der **Mac-Anmeldung**-OIDC-App ein, die Sie auf der [Registerkarte OneLogin](#onelogin) gesammelt haben. Sie folgt diesem Muster:

        ```bash theme={null}
        https://{subdomain}.onelogin.com/oidc/2/.well-known/openid-configuration
        ```
      </Step>

      <Step title="Client ID (Kennwortsynchronisierung) eingeben">
        Geben Sie im Feld **Client ID (Password Sync)** die Client ID der **Mac-Anmeldung**-OIDC-Anwendung von der [Registerkarte OneLogin](#onelogin) ein.
      </Step>

      <Step title="Mac-Anmeldung auswählen">
        Wählen Sie unter **Authentifizierungsmodus** die Option **Mac-Anmeldung** aus.
      </Step>

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

    ### Benutzerbereitstellung

    Wenn Passport den Mac-Kontotyp jedes Benutzers anhand von OneLogin-Rollen festlegen soll, schließen Sie zuerst [Einen Benutzerkontotyp nach Identitätsanbietergruppe in OneLogin konfigurieren](#configuring-a-user-account-type-by-identity-provider-group-in-onelogin) ab. Verwenden Sie die folgenden Schritte unter **Benutzerbereitstellung** auf der [Registerkarte **Iru Endpoint**](#iru-endpoint) des Passport Library Item.

    <Steps>
      <Step title="Benutzerkontotyp konfigurieren">
        Öffnen Sie im Passport Library Item im Abschnitt Benutzerbereitstellung das Menü Benutzerkontotyp und wählen Sie **Pro Identitätsanbietergruppe angeben** aus.
      </Step>

      <Step title="Ausweich-Kontotyp wählen">
        Wenn **Benutzerkontotyp** auf **Pro Identitätsanbietergruppe angeben** eingestellt ist, öffnen Sie das darunterliegende Dropdown-Menü für den Kontotyp und wählen Sie Administrator oder Standardbenutzer aus. Wenn die IdP-Gruppenmitgliedschaft eines Benutzers sowohl Administrator- als auch Standard-Kontotypen ergibt, wird der Benutzer als Administrator festgelegt.
      </Step>

      <Step title="Rollennamen eingeben">
        Geben Sie in jedes Feld **Identitätsanbietergruppe** einen Rollennamen ein, der Ihrer OneLogin-Konfiguration entspricht.
      </Step>

      <Step title="Kontotypen festlegen">
        Legen Sie für jede Zeile **Identitätsanbietergruppe** den passenden **Account type** fest.

        <Frame>
          <img src="https://mintcdn.com/iru/g5XvVqFV1vl7oJEO/assets/media/images/iru-passport-user-account-type.png?fit=max&auto=format&n=g5XvVqFV1vl7oJEO&q=85&s=dae709f0e35f1eabb21c7ee9cb8b8e7a" alt="Benutzerkontotyp im Passport Library Item nach Identitätsanbietergruppe" width="2272" height="712" data-path="assets/media/images/iru-passport-user-account-type.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Wenn das Passport Library Item gespeichert ist, kehren Sie zur [Registerkarte OneLogin](#onelogin) zurück, falls Sie OIDC-Apps oder Rollenzuordnungen ändern müssen.
    </Note>
  </Tab>
</Tabs>

Wenn Probleme mit Passport und OneLogin auftreten, lesen Sie [Passport-Fehlerbehebung mit OneLogin](/de/endpoint/library/passport/onelogin/passport-troubleshooting-with-onelogin).