> ## 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. # SCIM-Verzeichnisintegration mit Okta > Konfigurieren Sie die SCIM-Verzeichnisintegration zwischen Okta und Iru Endpoint. Stellen Sie Benutzer und Gruppen über das SCIM-Protokoll automatisch bereit und heben Sie deren Bereitstellung auf. ### Über die SCIM-Verzeichnisintegration mit Okta Mit der SCIM-Verzeichnisintegration mit Okta in Iru Endpoint können Sie eine SCIM-basierte Benutzerverzeichnissynchronisierung zwischen Okta und Iru Endpoint einrichten, die die automatische Bereitstellung und Aufhebung der Bereitstellung von Benutzern und Gruppen ermöglicht. ### Funktionsweise Die SCIM-Integration stellt eine sichere Verbindung zwischen Okta und Iru Endpoint her und ermöglicht die automatische Synchronisierung von Benutzer- und Gruppendaten. Wenn Benutzer oder Gruppen in Okta hinzugefügt, geändert oder entfernt werden, werden diese Änderungen über das SCIM-Protokoll automatisch in Iru Endpoint übernommen. ### Voraussetzungen * Stellen Sie sicher, dass Sie den Okta-Tarif **Advanced Lifecycle Management** verwenden, der integrierte, standardbasierte Bereitstellung für SCIM unterstützt. * Prüfen Sie unbedingt die unterstützten Benutzer- und Gruppenattribute, die im Artikel [SCIM-Verzeichnisintegration](/de/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) aufgeführt sind. ### SCIM-Token und API-URL abrufen Führen Sie diese Schritte zuerst in Iru Endpoint durch. Sie benötigen das SCIM-Zugriffstoken und die API-URL bei der Konfiguration von Okta. Alle Details finden Sie im Artikel [SCIM-Verzeichnisintegration](/de/endpoint/integrations/scim/scim-directory-integration). Wählen Sie in Iru Endpoint in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Integrationen**. Screenshot des Kontomenüs mit hervorgehobener Option Integrations Wählen Sie oben rechts auf der Seite „Integrations“ **Alle Integrationen durchsuchen**. Aktivieren Sie den Filter **Directory integrations**. Wählen Sie die Kachel **SCIM protocol**. Seite zum Hinzufügen einer neuen Integration mit der Kachel SCIM protocol Wählen Sie **Erste Schritte**. Geben Sie einen eindeutigen Namen für die SCIM-Integration ein. Wählen Sie **Token generieren**. Die SCIM-Integration verwendet einen HTTP-Authorization-Header mit einem Bearer-Token. Bildschirm zur Konfiguration einer SCIM-Benutzerintegration mit Namensfeld und Schaltfläche Token generieren Wählen Sie **Copy token**. Das Token ist nach Auswahl von „Done“ nicht mehr sichtbar. Bewahren Sie es sicher auf, da Sie es auf der Registerkarte **Okta** benötigen. Bestätigen Sie durch Aktivieren des Kontrollkästchens, dass Sie das Token kopiert haben, und wählen Sie dann **Fertig**. Sie kehren zur Seite **Integrationen** zurück. Dialog zum Kopieren des Tokens und Konfigurieren mit Ihrem Identitätsanbieter mit der Schaltfläche Copy token Wählen Sie die **Auslassungspunkte** bei der von Ihnen erstellten SCIM-Verzeichnisintegration. Wählen Sie **View Details**. Liste der Verzeichnisintegrationen mit SCIM-Integration und Auslassungsmenü mit View details, Rename, Rotate token, Delete Kopieren Sie die SCIM-API-URL (z. B. `https://subdomain.api.iru.com/api/v1/scim`). Ihr Identitätsanbieter benötigt diese. Die in Ihrem Tenant angezeigte URL zeigt möglicherweise noch die Domain `api.kandji.io`. Die `api.kandji.io`-Version der SCIM-API-URL funktioniert für diesen Zweck ebenfalls. Wählen Sie **Schließen**. Dialog mit Details zur Benutzerintegration mit SCIM-API-URL und Kopierschaltfläche Halten Sie das Token und die API-URL bereit und wechseln Sie dann zur Registerkarte **Okta**, um die SCIM-App-Integration zu erstellen und zu konfigurieren. Schließen Sie zuerst die Registerkarte **Iru Endpoint** ab, um das SCIM-Token und die API-URL zu erhalten. Sie geben diese in den folgenden Schritten ein. ## Die SCIM-Integration in Okta erstellen Die im Okta Integration Network (OIN) verfügbare Iru Endpoint-Anwendung kann nicht für SCIM bereitgestellt werden. Für SCIM muss eine neue Application Integration erstellt werden. Diese neue App-Integration beeinträchtigt keine bestehende Okta-SSO-Integration, die die OIN-Anwendung Iru Endpoint verwendet. Melden Sie sich unter login.okta.com bei Ihrer Okta-Admin-Konsole an. Erweitern Sie nach der Anmeldung in der linken Navigation den Bereich **Anwendungen** und wählen Sie **Anwendungen**. Wählen Sie **Create App Integration**. Okta-Seite Applications mit der Schaltfläche Create App Integration Wählen Sie **SAML 2.0** als Anwendungstyp und wählen Sie **Weiter**. Dialog Create a new app integration mit ausgewähltem SAML 2.0 Geben Sie der App unter **General Settings** einen **Namen** und aktivieren Sie das Kontrollkästchen im Bereich **App visibility**. Wählen Sie dann **Weiter**. General Settings von Create SAML Integration mit App-Name und App visibility Geben Sie unter **SAML Settings** eine Platzhalter-URL in die Felder **Single sign-on URL** und **Audience URI (SP Entity ID)** ein. Ändern Sie keine anderen Einstellungen. Schritt Configure SAML von Create SAML Integration mit Single sign-on URL und Audience URI Wählen Sie **Weiter**. Aktivieren Sie unter **Help Okta Support understand how you configured this application** das Kontrollkästchen **This is an internal app that we have created** und wählen Sie **Finish**. Schritt Feedback von Create SAML Integration mit This is an internal app that we have created und Finish Da diese Anwendungsintegration nicht für SSO verwendet wird, müssen die URLs nicht gültig sein; Sie müssen jedoch URLs in diese Felder eingeben, um fortzufahren. Wenn Sie sich entscheiden, SAML SSO in Iru Endpoint zu aktivieren, können Sie dafür dieselbe App verwenden. ## SCIM-Einstellungen konfigurieren Navigieren Sie in der soeben erstellten Okta-SCIM-App zur Registerkarte **Allgemein**. Wählen Sie im Bereich **Einstellungen** die Option **Bearbeiten**. Wählen Sie in der Einstellung „Provisioning“ **SCIM** aus. Ändern Sie keine anderen Einstellungen und wählen Sie **Speichern**. Okta-Registerkarte General mit ausgewähltem SCIM in der Einstellung Provisioning Wählen Sie auf der Registerkarte **Provisioning** im Bereich „Integration“ die Option **Bearbeiten**. Okta-Registerkarte Provisioning mit SCIM Connection und der Schaltfläche Edit Geben Sie für **SCIM connector base URL** die SCIM-API-URL ein, die Sie auf der Registerkarte **Iru Endpoint** kopiert haben (z. B. `https://subdomain.api.iru.com/api/v1/scim`). Die `api.kandji.io`-Version der SCIM-API-URL funktioniert für diesen Zweck ebenfalls. Geben Sie für **Unique identifier field for users** **userName** ein. Wählen Sie für **Supported provisioning actions** die Optionen **Push New Users**, **Push Profile Updates** und **Push Groups**. Wählen Sie für **Authentication Mode** die Option **HTTP Header**. Geben Sie für **Authorization** das Bearer-Token ein, das Sie auf der Registerkarte **Iru Endpoint** erhalten haben. Wählen Sie **Test Connector Configuration**, um die Integration zu testen. Okta SCIM Connection mit Basis-URL, userName, Provisioning-Aktionen, HTTP Header und Bearer-Token Vergewissern Sie sich, dass in der Liste der erkannten Funktionen nur die folgenden Elemente ein Häkchen als Erfolgsanzeige aufweisen: * Create Users * Update User Attributes * Push Groups Okta-Dialog Test Connector Configuration mit Connector configured successfully und erkannten Funktionen Wählen Sie **Speichern**. Gehen Sie auf der Registerkarte **Provisioning** zum Bereich **To App** und wählen Sie **Bearbeiten**. Okta-Bereich Provisioning To App mit Provisioning to App und Edit Aktivieren Sie im Bereich **Provisioning to App** die Optionen **Create Users**, **Update User Attributes** und **Deactivate Users**. Okta-Einstellungen Provisioning to App mit Create Users, Update User Attributes und Deactivate Users Wählen Sie **Speichern**. (optional) Bearbeiten Sie unter **Attribute Mappings** die Benutzerattribute, die an Iru Endpoint gesendet werden sollen. Iru Endpoint speichert und verwendet nur die im Artikel [SCIM-Verzeichnisintegration](/de/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) genannten Attribute. ## Benutzer Iru Endpoint zuweisen In Okta kann dieselbe Gruppe nicht sowohl auf der Registerkarte „Assignments“ als auch auf der Registerkarte „Push Groups“ verwendet werden. Um diesen Konflikt zu vermeiden, erstellen Sie eine Zuweisungsgruppe für den Zugriff auf die SCIM-App (zum Beispiel `iru_endpoint_users`) und halten Sie sie mit den Benutzern in Ihren übertragenen Gruppen synchron. Weisen Sie dann diese Zuweisungsgruppe der SCIM-App zu. Dies ist ein Beispiel für die Zuweisung von Benutzern zu Iru Endpoint über Okta SCIM. ### Die Zuweisungsgruppe erstellen Navigieren Sie in einem neuen Browser-Tab zu **Directory > Groups** und wählen Sie **Add Group**. Geben Sie der Gruppe einen aussagekräftigen Namen wie **iru\_endpoint\_users** und wählen Sie **Speichern**. ### Mitglieder mit einer Gruppenregel hinzufügen Verwenden Sie dies, wenn Personen in Ihren Push-Gruppen (zum Beispiel Sales und Engineering) automatisch Mitglieder von `iru_endpoint_users` werden sollen. Wenn Sie diese Schritte befolgen, müssen Sie diese Benutzer nicht manuell in großen Mengen hinzufügen. Gehen Sie zu Directory > Groups > Rules und wählen Sie **Add Rule**. Okta-Seite Directory Groups Rules mit Add Rule Geben Sie einen Regelnamen ein (zum Beispiel `Update iru_endpoint_users group membership`). Wählen Sie unter IF **Use basic condition** und **Group membership**, setzen Sie dann **includes any of the following** und wählen Sie die Gruppen aus, die Sie übertragen möchten (zum Beispiel Sales und Engineering). Wählen Sie unter **Then Assign to** `iru_endpoint_users` und dann **Speichern**. IF-Bedingung einer Okta-Gruppenregel mit Use basic condition und Group membership Öffnen Sie zurück auf der Seite „Rules“ **Aktionen** für die neue Regel und wählen Sie **Activate**. Liste der Okta-Gruppenregeln mit Actions-Menü und Activate ### Mitglieder manuell hinzufügen Verwenden Sie dies, wenn Sie **keine** Gruppenregel verwenden, zum Beispiel um Testbenutzer hinzuzufügen, bevor Push-Gruppen und Regeln eingerichtet sind, oder für Personen, die in `iru_endpoint_users` sein müssen, aber noch in keiner übertragenen Gruppe sind. Suchen Sie nach `iru_endpoint_users` und fügen Sie die Benutzer hinzu, die die SCIM-App erhalten sollen. ### Die Gruppe der SCIM-App zuweisen Kehren Sie zum Browser-Tab zurück, in dem die Okta-SCIM-App geöffnet ist. Gehen Sie zur Registerkarte **Zuweisungen** und wählen Sie **Assign > Assign to Groups**. Suchen Sie nach der neu erstellten Gruppe und wählen Sie **Zuweisen** > **Save and Go Back**. Vergewissern Sie sich, dass die Gruppe zugewiesen wurde, und wählen Sie **Fertig**. Die Gruppe sollte nun im Bereich **Gruppen** der Registerkarte „Assignments“ angezeigt werden. Wenn die Gruppe nicht angezeigt wird, aktualisieren Sie den Browser-Tab. Alle Benutzer in `iru_endpoint_users` werden in Iru Endpoint bereitgestellt und im Modul „Users“ angezeigt. Um Gruppen für [bedingte Logik in Blueprints](/de/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints) zu synchronisieren, fahren Sie mit dem nächsten Abschnitt fort. #### Gruppen an Iru Endpoint übertragen In diesem Abschnitt erfahren Sie, wie Sie Benutzergruppen an Iru Endpoint übertragen. Wenn Sie Okta-Gruppen zur Verwendung mit [bedingter Logik in Blueprints](/de/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints) an Iru Endpoint übertragen möchten, fügen Sie jede zu übertragende Gruppe auf der Registerkarte **Push Groups** in der SCIM-App hinzu. Laut diesem [Okta-Artikel](https://help.okta.com/oie/en-us/Content/Topics/users-groups-profiles/usgp-about-group-push.htm) können Gruppen, die zum Zuweisen von Benutzern auf der Registerkarte „Assignment“ verwendet werden, nicht auf der Registerkarte „Push Groups“ verwendet werden. Okta empfiehlt, zusätzliche Gruppen mit denselben Benutzern zu erstellen und die neuen Gruppen der Registerkarte „Push Groups“ hinzuzufügen, um eine konsistente Gruppenmitgliedschaft zu gewährleisten. Wenn dieselbe Gruppe an beiden Stellen hinzugefügt wird, hat die Registerkarte „Assignment“ Vorrang, und die Gruppe wird möglicherweise nicht übertragen. Eine Möglichkeit besteht darin, eine einzelne „Benutzerzuweisungsgruppe“ mit allen Ihren Iru Endpoint-Benutzern zu erstellen und diese Gruppe der Registerkarte „Assignment“ hinzuzufügen. Anschließend können Sie Ihre bestehenden Okta-Gruppen als Push-Gruppen verwenden. Beachten Sie, dass die Mitglieder der übertragenen Gruppen auch Mitglieder der der SCIM-App zugewiesenen Iru Endpoint-Benutzergruppe sein müssen, damit die Benutzer-Gruppen-Zuordnung funktioniert. ### Gruppen auf der Registerkarte Push Groups hinzufügen Fügen Sie in der SCIM-App jede Okta-Gruppe hinzu, die in Iru Endpoint angezeigt werden soll. Öffnen Sie die Registerkarte „Push Groups“, wählen Sie **Push Groups** und dann **Find groups by name** (oder **Find groups by rule**). Suchen Sie nach der Gruppe und wählen Sie sie aus. Wählen Sie **Create Group**. Wählen Sie **Save & Add Another**. Fügen Sie alle weiteren Gruppen hinzu, die an Iru Endpoint übertragen werden sollen. ### Gruppenaktualisierungen übertragen Die Benutzer- und Gruppensynchronisierung erfolgt in eine Richtung, d. h. die SCIM-App sendet Benutzer- und Gruppendaten nur dann an Iru Endpoint, wenn neue oder aktualisierte Daten vorliegen. Aus diesem Grund ist in der Iru Endpoint-Web-App keine Option „Sync Now“ erforderlich. * Wenn Sie der in Okta der SCIM-App zugewiesenen Gruppe Benutzer hinzufügen, aktualisieren Sie unbedingt auch die Gruppen, die Sie als Push-Gruppen hinzugefügt haben. * Aktualisierungen sollten recht schnell in Iru Endpoint sichtbar sein; um Gruppenaktualisierungen sofort zu übertragen, verwenden Sie **Push Now** auf der Registerkarte „Push Groups“ in Okta. Siehe den [Okta-Artikel](https://help.okta.com/oie/en-us/content/topics/users-groups-profiles/usgp-enable-group-push.htm). ### Übertragene Gruppen löschen Verwenden Sie die folgenden Schritte, um die Übertragung von Gruppenaktualisierungen zu beenden oder optional eine übertragene Gruppe aus Iru Endpoint zu löschen. Gehen Sie in Okta zur Registerkarte „Push Groups“ der App. Wählen Sie in der Spalte „Push Status“ **Unlink push group**. Wählen Sie **Delete the group in the target app (recommended)**. Dadurch wird die Gruppe in Iru Endpoint entfernt, Benutzerkonten werden jedoch nicht gelöscht. Benutzerkonten bleiben an die Zuweisungsgruppe auf der Registerkarte „Provisioning“ gebunden. Wählen Sie **Unlink**. Die Gruppe sollte nun nicht mehr auf der Registerkarte „Push Groups“ aufgeführt sein.