SCIM-Verzeichnisintegration

Über die SCIM-Verzeichnisintegration

SCIM, das System for Cross-domain Identity Management, ist ein Protokoll, das die Verwaltung von Benutzeridentitäten über verschiedene Systeme hinweg einfacher und effizienter macht. Es ist besonders nützlich, wenn Sie mehrere cloudbasierte Anwendungen verwenden, da es das Hinzufügen und Entfernen von Benutzern automatisiert.

Funktionsweise

SCIM umfasst zwei Hauptrollen:

Client – In der Regel ein Identitätsanbieter oder ein Identity-Access-Management-System wie Microsoft Entra ID oder Okta, das die zentralen Identitätsdaten verwaltet.
Service Provider – Eine Software-as-a-Service-Anwendung (SaaS) wie Iru Endpoint, die Identitätsdaten zur Verwaltung von Benutzerzugriff und Berechtigungen verwendet.

SCIM unterstützt mehrere Vorgänge, darunter Bereitstellung, Synchronisierung und Aufhebung der Bereitstellung. Mit dieser Einweg-Synchronisierung können Sie Benutzerkonten in Iru Endpoint automatisch erstellen, Benutzerattribute zwischen Ihrem MDM und Ihrem IdP aktuell halten und Benutzerkonten automatisch entfernen oder deaktivieren, wenn sie nicht mehr benötigt werden.

SCIM in Iru Endpoint konfigurieren

Um eine SCIM-Integration zwischen Ihrem Identitätsanbieter (IdP) und Iru Endpoint zu konfigurieren, müssen Sie:

Eine neue SCIM-Verzeichnisintegration in Iru Endpoint erstellen
Die SCIM-API-URL und das API-Token aus Iru Endpoint zur Verwendung mit Ihrem IdP abrufen.
In Ihrem IdP eine App-Integration erstellen, SCIM-Attribute zuordnen und die gewünschten Benutzergruppen übertragen.

Eine neue SCIM-Verzeichnisintegration erstellen

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-Benutzerverzeichnisintegration verwendet als Authentifizierungsmethode 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.

Kopieren des Tokens bestätigen

Das Token ist nach Auswahl von „Done“ nicht mehr sichtbar. Bewahren Sie es sicher auf, bevor Sie fortfahren.

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

Die SCIM-API-URL abrufen

Ihre SCIM-API-URL finden Sie in den Integrationsdetails in Iru Endpoint. Sie müssen diese URL bei der Konfiguration der SCIM-Verbindung an Ihren Identitätsanbieter übergeben.

Integrationsdetails aufrufen

Wählen Sie die Auslassungspunkte bei der soeben 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 mit Kopieren 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

Eine SCIM-Integration umbenennen

So ändern Sie den Namen einer bestehenden SCIM-Verzeichnisintegration:

Integrationsmenü öffnen

Wählen Sie die Auslassungspunkte bei der SCIM-Verzeichnisintegration, die Sie umbenennen möchten.

Rename wählen

Wählen Sie Rename.

Auslassungsmenü der SCIM-Integration mit der Option Rename

Neuen Namen eingeben

Geben Sie den neuen Namen für die Integration ein und speichern Sie.

Aufforderung bzw. Dialog zum Umbenennen der SCIM-Integration mit Namensfeld

Das SCIM-Token rotieren

Rotieren Sie das SCIM-API-Token, wenn Sie das aktuelle Token ungültig machen müssen (zum Beispiel nach einem Sicherheitsvorfall oder bei einer Neukonfiguration in Ihrem IdP). Aktualisieren Sie nach dem Rotieren das neue Token in Ihrem Identitätsanbieter.

Integrationsmenü öffnen

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

Rotate token wählen

Wählen Sie Rotate token.

Auslassungsmenü der SCIM-Integration mit der Option Rotate token

Rotation bestätigen

Bestätigen Sie die Rotation in der Aufforderung. Das vorherige Token funktioniert dann nicht mehr.

Bestätigungsaufforderung zum Rotieren des Tokens für die SCIM-Integration

Neues Token kopieren

Kopieren Sie das neue Token und aktualisieren Sie es in Ihrem IdP.

Das neue SCIM-Token nach der Rotation kopieren

Eine SCIM-Integration löschen

Durch das Entfernen einer SCIM-Verzeichnisintegration wird die Synchronisierung aus Ihrem IdP beendet und die Integration aus Iru Endpoint entfernt. Aktualisieren oder entfernen Sie die SCIM-App in Ihrem IdP, um Fehler zu vermeiden.

Integrationsmenü öffnen

Wählen Sie die Auslassungspunkte bei der SCIM-Verzeichnisintegration, die Sie entfernen möchten.

Delete integration wählen

Wählen Sie Delete integration.

Auslassungsmenü der SCIM-Integration mit der Option Delete integration

Löschen bestätigen

Bestätigen Sie in der Aufforderung, dass Sie die Integration löschen möchten.

Bestätigungsaufforderung zum Löschen der SCIM-Integration

SCIM-Schema und unterstützte Attribute

Iru Endpoint unterstützt die folgenden SCIM-Attribute. Beziehen Sie sich auf diese Attribute, wenn Sie Ihre SCIM-Anwendung in Ihrem IdP zuordnen.

Iru Endpoint verwendet keine Attribute, die nicht in der folgenden Liste enthalten sind. Um die gesendeten Attribute einzuschränken, ändern Sie bitte die in der SCIM-App in Ihrem IdP konfigurierten Attribute.

Benutzerattribute

Attribut	Beschreibung	Erforderlich
userName	Eindeutige Kennung des Benutzers, die zur Authentifizierung beim Service Provider verwendet wird	Ja
name.formatted	Der vollständige Name des Benutzers (zum Beispiel „John Doe“). Dieses Attribut oder das Attribut displayName ist erforderlich	Nein
displayName	Der vollständige Name des Benutzers (zum Beispiel „John Doe“). Dieses Attribut oder das Attribut name.formatted ist erforderlich	Ja
title	Der Titel des Benutzers, z. B. „Vice President“.	Nein
active	Der Status des Benutzers beim Identitätsanbieter. Dieses Attribut wird vom Identitätsanbieter automatisch hinzugefügt.	Ja
emails.value	Die E-Mail-Adresse des Benutzers als Unterattribut von emails. Iru Endpoint speichert nur die erste E-Mail-Adresse in der Liste.	Ja
department	Gibt den Namen einer Abteilung an.	Nein

Wenn die erste Übertragung für einen Benutzer active auf false setzt, erstellt Iru Endpoint diesen Benutzer als gesperrt. Gruppenattribute

Attribut	Beschreibung	Erforderlich
displayName	Ein lesbarer Name für die Gruppe.	Ja
members	Eine Liste der Mitglieder der Gruppe.	Ja

Wenn Sie SCIM zum Synchronisieren von Benutzern aus einem Verzeichnis verwenden, sendet die SCIM-App neue Informationen automatisch an Iru Endpoint, sodass keine Schaltfläche „Sync Now“ erforderlich ist, wie Sie sie bei den nativen Verzeichnisintegrationen für Entra ID oder Google Workspace sehen würden. Jeder Cloud-IdP hat seinen eigenen Standard für die Synchronisierung von SCIM-Daten. Bitte lesen Sie in der Dokumentation Ihres Identitätsanbieters nach, wie die SCIM-Synchronisierung konfiguriert wird.