SCIM-Verzeichnisintegration mit OneLogin

Über die SCIM-Verzeichnisintegration mit OneLogin

Mit der SCIM-Verzeichnisintegration mit OneLogin in Iru Endpoint können Sie eine SCIM-basierte Benutzerverzeichnissynchronisierung zwischen OneLogin 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 OneLogin und Iru Endpoint her und ermöglicht die automatische Synchronisierung von Benutzer- und Gruppendaten. Wenn Benutzer oder Gruppen in OneLogin hinzugefügt, geändert oder entfernt werden, werden diese Änderungen über das SCIM-Protokoll automatisch in Iru Endpoint übernommen.

Voraussetzungen

Prüfen Sie unbedingt die unterstützten Benutzer- und Gruppenattribute, die im Artikel SCIM-Verzeichnisintegration aufgeführt sind.

Iru Endpoint
OneLogin

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

Halten Sie das Token und die API-URL bereit und wechseln Sie dann zur Registerkarte OneLogin, 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 OneLogin erstellen

OneLogin-Admin-Konsole aufrufen

Melden Sie sich bei Ihrer OneLogin-Admin-Konsole an. (Beispiel: https://accuhive.onelogin.com/admin2)

Zu Applications navigieren

Bewegen Sie in der oberen Navigation den Mauszeiger über Anwendungen.

Menü Anwendungen öffnen

Wählen Sie im Dropdown-Menü Anwendungen.

Obere Navigation von OneLogin mit dem Menü Applications

Neue Anwendung hinzufügen

Wählen Sie oben rechts Add App.

OneLogin-Seite Applications mit der Schaltfläche Add App

Nach SCIM Provisioner suchen

Geben Sie in das Textfeld SCIM Provisioner with SAML (SCIM v2 Enterprise) ein.

SCIM Provisioner auswählen

Wählen Sie SCIM Provisioner with SAML (SCIM v2 Enterprise).

OneLogin-Suche Add App mit der Option SCIM Provisioner with SAML

SCIM-Einstellungen konfigurieren

Verwenden Sie in der Anwendung SCIM Provisioner with SAML (SCIM v2 Enterprise) die folgenden Schritte, um die SCIM-Einstellungen zu konfigurieren. Die folgenden Schritte umfassen die Bereitstellung von Benutzern und Gruppen (Rollen).

Anwendungsinformationen

Anzeigenamen aktualisieren

(optional) Ändern Sie den Display Name der App in etwa Iru Endpoint SCIM Provisioner

Sichtbarkeit im Portal konfigurieren

(optional) Wählen Sie, ob die App im OneLogin-Portal sichtbar sein soll.

Anwendungssymbol hinzufügen

(optional) Fügen Sie ein Symbol hinzu.

Beschreibung hinzufügen

(optional) Fügen Sie eine Beschreibung hinzu.

Konfiguration speichern

Wählen Sie nach Abschluss der Grundkonfiguration Speichern.

Grundkonfiguration der OneLogin-SCIM-App mit Display Name und Save

Parameter

Zu Parameters navigieren

Navigieren Sie zur Seite Parameters.

Neuen Parameter hinzufügen

Wählen Sie rechts die Schaltfläche (+) zum Hinzufügen.

OneLogin-Seite Parameters mit der Schaltfläche zum Hinzufügen von Parametern

Feldnamen eingeben

Geben Sie email.value in Field name ein.

Neuer OneLogin-Parameter mit dem Feldnamen email.value

Parameter speichern

Wählen Sie Speichern.

Parameterwert konfigurieren

Wählen Sie im Dropdown-Menü „Value“ E-Mail aus.

OneLogin-Parameter email.value mit ausgewähltem Wert Email

Konfiguration speichern

Wählen Sie Speichern.

Konfiguration

Zu Configuration navigieren

Navigieren Sie zur Seite Konfiguration.

SCIM-API-URL eingeben

Fügen Sie im Feld SCIM 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.

Bearer-Token eingeben

Fügen Sie im Feld SCIM Bearer Token das Token ein, das Sie auf der Registerkarte Iru Endpoint erhalten haben.

API-Verbindung aktivieren

Wählen Sie Aktivieren, um die API-Verbindung zu aktivieren.

Konfiguration speichern

Wählen Sie Speichern.

OneLogin-Seite Configuration mit den Feldern SCIM Base URL und Bearer Token

Provisioning

Seite Provisioning aufrufen

Gehen Sie zur Seite Provisioning.

Provisioning aktivieren

Aktivieren Sie das Kontrollkästchen Enable provisioning.

Benutzervorgänge konfigurieren

Deaktivieren Sie die Kontrollkästchen neben Create user, Delete user und Update user.

Löschrichtlinie festlegen

Wählen Sie für die Option When users are deleted in OneLogin, or the user’s app access is removed… die Einstellung Löschen.

Sperrrichtlinie festlegen

Wählen Sie für die Option When user accounts are suspended in OneLogin… die Einstellung Suspend.

Konfiguration speichern

Wählen Sie nun oben rechts Speichern, um die Erstkonfiguration zu speichern.

OneLogin-Seite Provisioning mit Enable provisioning und Benutzervorgängen

Benutzer und Rollen in Iru Endpoint bereitstellen

Verwenden Sie die folgenden Schritte, um Benutzer und OneLogin-Rollen über die SCIM-Integration an Iru Endpoint zu senden.

OneLogin-Rollen entsprechen Gruppen in Iru Endpoint und werden der SCIM-Konfiguration zugewiesen. Wenn Benutzer in OneLogin Rollen zugewiesen werden, werden sie anschließend an Iru Endpoint übertragen. Außerdem werden alle der SCIM-App zugewiesenen Rollen als Gruppen an Iru Endpoint übertragen.

Eine Rolle erstellen

Zu Users navigieren

Bewegen Sie in der oberen Navigation den Mauszeiger über Benutzer.

Roles aufrufen

Wählen Sie im Dropdown-Menü Roles.

Neue Rolle erstellen

Wählen Sie New Role.

Rolle benennen

Geben Sie der Rolle einen Namen.

Apps der Rolle zuweisen

Wählen Sie die Apps aus, die der Rolle zugewiesen werden sollen. In diesem Fall haben wir die SCIM-App ausgewählt.

Rolle speichern

Wählen Sie Speichern.

Benutzer der Rolle zuweisen

Erstellte Rolle aufrufen

Öffnen Sie erneut die soeben erstellte Rolle.

Zu Users navigieren

Wählen Sie Benutzer.

Neue Zuordnung erstellen

Wählen Sie unter Users Added Automatically die Option New Mapping.

Zuordnung benennen

Geben Sie der Zuordnung einen Namen.

Bedingungen konfigurieren

Erstellen Sie die Bedingungen, die Ihren Anforderungen entsprechen. Wählen Sie für dieses Beispiel Group membership als Kriterium; Sie können aber auch andere Kriterien wie die Abteilung verwenden.

Rollenaktion auswählen

Wählen Sie unter Aktionen die Rolle aus, die angewendet werden soll.

Zuordnung speichern

Wählen Sie Speichern.

OneLogin erlaubt einem Benutzer nur die Mitgliedschaft in einer Gruppe, daher können Sie OneLogin-Gruppen als Attribut betrachten, das den Benutzer beschreibt, ähnlich wie Abteilung oder Standort. Verwenden Sie OneLogin-Rollen, wenn ein Benutzer Mitglied in mehr als einer „Gruppe“ sein muss.

Weitere Informationen zur Gruppenbereitstellung finden Sie in der OneLogin-Dokumentation hier.

Bei Bedarf können Benutzer auch manuell über den Datensatz des jeweiligen Benutzers zu den SCIM-Apps hinzugefügt werden.

Der SCIM-App eine Regel hinzufügen

Verwenden Sie die folgenden Schritte, um eine oder mehrere Rollen (Iru Endpoint-Gruppen) in der OneLogin-SCIM-App an Iru Endpoint zu übertragen.

Rules aufrufen

Wählen Sie in der SCIM-App Rules.

Neue Regel hinzufügen

Wählen Sie Add Rule.

Regel benennen

Geben Sie der Regel einen Namen.

Aktion konfigurieren

Wählen Sie unter Aktionen im ersten Dropdown-Menü Set Groups in.

Zuordnungsquelle auswählen

Wählen Sie Map from OneLogin.

Rollenzuordnung konfigurieren

Wählen Sie im Feld For each im Dropdown-Menü role.

Rollenwert festlegen

Geben Sie im Feld with value that matches die SCIM-Rolle ein, die als Gruppe an Iru Endpoint übertragen werden soll.

Regel speichern

Wählen Sie Speichern.

Aktualisierungen übertragen

Synchronisierung: Die Benutzer- und Gruppensynchronisierung erfolgt in eine Richtung, d. h. die SCIM-App sendet Benutzerinformationen nur dann an Iru Endpoint, wenn neue oder aktualisierte Informationen zu senden sind. Aus diesem Grund ist in der Iru Endpoint-Web-App keine Option „Sync Now“ erforderlich.

Wenn die SCIM-App in OneLogin aktualisiert wird, müssen Sie die Änderung speichern und dann Reapply entitlement mappings verwenden.

Weitere Aktionen aufrufen

Bewegen Sie den Mauszeiger über das Menü More Actions.

Berechtigungszuordnungen erneut anwenden

Wählen Sie die Option Reapply entitlement mappings.

Erste Schritte

Geräte

Agent

Blueprints

Registrierung

Library

Bereitstellungsleitfäden

Einstellungen

Integrationen

Endpoint Detection & Response

Schwachstellenmanagement

SCIM-Verzeichnisintegration mit OneLogin

Über die SCIM-Verzeichnisintegration mit OneLogin

Funktionsweise

Voraussetzungen

SCIM-Token und API-URL abrufen

Die SCIM-Integration in OneLogin erstellen

SCIM-Einstellungen konfigurieren

Anwendungsinformationen

Parameter

Konfiguration

Provisioning

Benutzer und Rollen in Iru Endpoint bereitstellen

Eine Rolle erstellen

Benutzer der Rolle zuweisen

Der SCIM-App eine Regel hinzufügen

Aktualisierungen übertragen

​Über die SCIM-Verzeichnisintegration mit OneLogin

​Funktionsweise

​Voraussetzungen

​SCIM-Token und API-URL abrufen

​Die SCIM-Integration in OneLogin erstellen

​SCIM-Einstellungen konfigurieren

​Anwendungsinformationen

​Parameter

​Konfiguration

​Provisioning

​Benutzer und Rollen in Iru Endpoint bereitstellen

​Eine Rolle erstellen

​Benutzer der Rolle zuweisen

​Der SCIM-App eine Regel hinzufügen

​Aktualisierungen übertragen

Über die SCIM-Verzeichnisintegration mit OneLogin

Funktionsweise

Voraussetzungen

SCIM-Token und API-URL abrufen

Die SCIM-Integration in OneLogin erstellen

SCIM-Einstellungen konfigurieren

Anwendungsinformationen

Parameter

Konfiguration

Provisioning

Benutzer und Rollen in Iru Endpoint bereitstellen

Eine Rolle erstellen

Benutzer der Rolle zuweisen

Der SCIM-App eine Regel hinzufügen

Aktualisierungen übertragen