SCIM-Verzeichnisintegration mit Okta

Ü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 aufgeführt sind.

Iru Endpoint
Okta

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.

Integrationen öffnen

Wählen Sie in Iru Endpoint in der Seitenleiste die Schaltfläche Kontomenü und dann Integrationen.

Screenshot des Kontomenüs mit hervorgehobener Option Integrations

Alle Integrationen durchsuchen

Wählen Sie oben rechts auf der Seite „Integrations“ Alle Integrationen durchsuchen.

Nach Directory integrations filtern

Aktivieren Sie den Filter Directory integrations.

SCIM protocol auswählen

Wählen Sie die Kachel SCIM protocol.

Seite zum Hinzufügen einer neuen Integration mit der Kachel SCIM protocol

Konfiguration starten

Wählen Sie Erste Schritte.

Integration benennen

Geben Sie einen eindeutigen Namen für die SCIM-Integration ein.

Authentifizierungstoken generieren

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

Token kopieren

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 und Einrichtung abschließen

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

Integrationsdetails aufrufen

Wählen Sie die Auslassungspunkte bei der von Ihnen erstellten SCIM-Verzeichnisintegration.

Details anzeigen

Wählen Sie View Details.

Liste der Verzeichnisintegrationen mit SCIM-Integration und Auslassungsmenü mit View details, Rename, Rotate token, Delete

API-URL kopieren

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.

Details schließen

Wählen Sie Schließen.

Dialog mit Details zur Benutzerintegration mit SCIM-API-URL und Kopierschaltfläche

Zur Registerkarte Okta wechseln

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.

Okta-Tenant aufrufen

Melden Sie sich unter login.okta.com bei Ihrer Okta-Admin-Konsole an.

Zu Applications navigieren

Erweitern Sie nach der Anmeldung in der linken Navigation den Bereich Anwendungen und wählen Sie Anwendungen.

App-Integration erstellen

Wählen Sie Create App Integration.

Okta-Seite Applications mit der Schaltfläche Create App Integration

Anwendungstyp auswählen

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

Allgemeine Einstellungen konfigurieren

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

SAML-Einstellungen konfigurieren

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

Konfiguration fortsetzen

Wählen Sie Weiter.

Einrichtung abschließen

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

Registerkarte General aufrufen

Navigieren Sie in der soeben erstellten Okta-SCIM-App zur Registerkarte Allgemein.

Einstellungen bearbeiten

Wählen Sie im Bereich Einstellungen die Option Bearbeiten.

SCIM-Provisioning auswählen

Wählen Sie in der Einstellung „Provisioning“ SCIM aus.

Allgemeine Einstellungen speichern

Ändern Sie keine anderen Einstellungen und wählen Sie Speichern.

Okta-Registerkarte General mit ausgewähltem SCIM in der Einstellung Provisioning

Registerkarte Provisioning aufrufen

Wählen Sie auf der Registerkarte Provisioning im Bereich „Integration“ die Option Bearbeiten.

Okta-Registerkarte Provisioning mit SCIM Connection und der Schaltfläche Edit

SCIM-API-URL konfigurieren

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.

Benutzerkennung festlegen

Geben Sie für Unique identifier field for users userName ein.

Provisioning-Aktionen auswählen

Wählen Sie für Supported provisioning actions die Optionen Push New Users, Push Profile Updates und Push Groups.

Authentifizierung konfigurieren

Wählen Sie für Authentication Mode die Option HTTP Header.

Autorisierungstoken eingeben

Geben Sie für Authorization das Bearer-Token ein, das Sie auf der Registerkarte Iru Endpoint erhalten haben.

Konfiguration testen

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

Testergebnisse überprüfen

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

Integrationseinstellungen speichern

Wählen Sie Speichern.

App-Provisioning konfigurieren

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

Benutzervorgänge aktivieren

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

App-Einstellungen speichern

Wählen Sie Speichern.

Attributzuordnungen konfigurieren

(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 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

Zu Groups navigieren

Navigieren Sie in einem neuen Browser-Tab zu Directory > Groups und wählen Sie Add Group.

Benutzergruppe erstellen

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.

Gruppenregeln öffnen

Gehen Sie zu Directory > Groups > Rules und wählen Sie Add Rule.

Okta-Seite Directory Groups Rules mit Add Rule

Regel benennen

Geben Sie einen Regelnamen ein (zum Beispiel Update iru_endpoint_users group membership).

Bedingung für die Gruppenmitgliedschaft konfigurieren

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

Zielgruppe zuweisen

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

Regel aktivieren

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

Benutzer zur Zuweisungsgruppe hinzufügen

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

Zur SCIM-App zurückkehren

Kehren Sie zum Browser-Tab zurück, in dem die Okta-SCIM-App geöffnet ist.

Assignments aufrufen

Gehen Sie zur Registerkarte Zuweisungen und wählen Sie Assign > Assign to Groups.

Gruppe zuweisen

Suchen Sie nach der neu erstellten Gruppe und wählen Sie Zuweisen > Save and Go Back.

Zuweisung bestätigen

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.

Bei Bedarf aktualisieren

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

Push Groups aufrufen

Öffnen Sie die Registerkarte „Push Groups“, wählen Sie Push Groups und dann Find groups by name (oder Find groups by rule).

Gruppe auswählen

Suchen Sie nach der Gruppe und wählen Sie sie aus.

Gruppenerstellung konfigurieren

Wählen Sie Create Group.

Speichern und weitere hinzufügen

Wählen Sie Save & Add Another.

Weitere Gruppen hinzufügen

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.

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

Registerkarte Push Groups aufrufen

Gehen Sie in Okta zur Registerkarte „Push Groups“ der App.

Push-Gruppe trennen

Wählen Sie in der Spalte „Push Status“ Unlink push group.

Löschen konfigurieren

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.

Trennen bestätigen

Wählen Sie Unlink.

Die Gruppe sollte nun nicht mehr auf der Registerkarte „Push Groups“ aufgeführt sein.

Erste Schritte

Geräte

Agent

Blueprints

Registrierung

Library

Bereitstellungsleitfäden

Einstellungen

Integrationen

Endpoint Detection & Response

Schwachstellenmanagement

SCIM-Verzeichnisintegration mit Okta

Über die SCIM-Verzeichnisintegration mit Okta

Funktionsweise

Voraussetzungen

SCIM-Token und API-URL abrufen

Die SCIM-Integration in Okta erstellen

SCIM-Einstellungen konfigurieren

Benutzer Iru Endpoint zuweisen

Die Zuweisungsgruppe erstellen

Mitglieder mit einer Gruppenregel hinzufügen

Mitglieder manuell hinzufügen

Die Gruppe der SCIM-App zuweisen

Gruppen an Iru Endpoint übertragen

Gruppen auf der Registerkarte Push Groups hinzufügen

Gruppenaktualisierungen übertragen

Übertragene Gruppen löschen

​Über die SCIM-Verzeichnisintegration mit Okta

​Funktionsweise

​Voraussetzungen

​SCIM-Token und API-URL abrufen

​Die SCIM-Integration in Okta erstellen

​SCIM-Einstellungen konfigurieren

​Benutzer Iru Endpoint zuweisen

​Die Zuweisungsgruppe erstellen

​Mitglieder mit einer Gruppenregel hinzufügen

​Mitglieder manuell hinzufügen

​Die Gruppe der SCIM-App zuweisen

​Gruppen an Iru Endpoint übertragen

​Gruppen auf der Registerkarte Push Groups hinzufügen

​Gruppenaktualisierungen übertragen

​Übertragene Gruppen löschen

Über die SCIM-Verzeichnisintegration mit Okta

Funktionsweise

Voraussetzungen

SCIM-Token und API-URL abrufen

Die SCIM-Integration in Okta erstellen

SCIM-Einstellungen konfigurieren

Benutzer Iru Endpoint zuweisen

Die Zuweisungsgruppe erstellen

Mitglieder mit einer Gruppenregel hinzufügen

Mitglieder manuell hinzufügen

Die Gruppe der SCIM-App zuweisen

Gruppen an Iru Endpoint übertragen

Gruppen auf der Registerkarte Push Groups hinzufügen

Gruppenaktualisierungen übertragen

Übertragene Gruppen löschen