Zum Inhalt springen
Service status

Tippen, um zu suchen

SSO und Benutzergruppen · 6 Min. Lesezeit

Nutzerbereitstellung (SCIM)

Wie dein Identity Provider mit SCIM Intric-Konten anlegt, aktualisiert, deaktiviert und entfernt, wie du es in Microsoft Entra ID einrichtest und was SCIM nicht abdeckt.

SCIM (System for Cross-domain Identity Management) ist ein Standard, um Nutzerkonten von einem System an ein anderes zu übertragen. Mit eingeschaltetem SCIM entscheidet dein Identity Provider (IdP), wer ein Intric-Konto hat und ob es aktiv ist. Eine Person, die du hinzufügst, legt Intric vor ihrer ersten Anmeldung an. Eine Person, die du entfernst, verliert den Zugriff, ohne dass jemand in Intric etwas tun muss.

Diese Seite richtet sich an die Person, die deinen IdP administriert. Die Anleitung gilt für Microsoft Entra ID. Wenn du einen anderen IdP einsetzt, der SCIM 2.0 unterstützt, wende dich an den Intric-Support.

SCIM und SSO sind voneinander getrennt, und du brauchst beides.

  • SSO regelt, wie sich eine Person anmeldet.
  • SCIM regelt, ob die Person ein Konto hat und in welchem Zustand.

Mit SSO allein legt Intric ein Konto nur an und aktualisiert es nur, wenn sich die Person anmeldet. Wer aus deinem IdP entfernt ist, kann sich nicht mehr anmelden, doch das Intric-Konto bleibt aktiv, bis jemand es von Hand deaktiviert. Eine neue Person gibt es in Intric erst nach ihrer ersten Anmeldung, daher kann ein:e Administrator:in vorher nichts für sie vorbereiten.

Mit SCIM allein hat eine Person ein Konto, kann sich aber nicht anmelden. SCIM vergibt kein Passwort, die Anmeldung läuft weiterhin über SSO.

SCIM ändert nichts an deiner bestehenden SSO-Einrichtung. Richte zuerst SSO ein, siehe SSO und Nutzergruppen.

Änderung in deinem IdP Auswirkung in Intric
Du weist einer Person die Provisioning-Anwendung zu Intric legt vor der ersten Anmeldung der Person ein Konto an, mit der Rolle User und in deiner Standard-Abrechnungsgruppe. In der Nutzerliste steht es als Eingeladen, bis sich die Person zum ersten Mal anmeldet.
Du hebst die Zuweisung einer Person auf oder deaktivierst ihr Konto Intric deaktiviert das Konto, es steht dann als Inaktiv in der Liste. Die Person kann sich nicht anmelden, und Intric weist ihre Sitzungen und API-Schlüssel ab. Nichts wird gelöscht, und du kannst die Änderung rückgängig machen.
Du aktivierst eine Person wieder oder weist sie erneut zu Intric stellt das Konto mit allen Inhalten wieder her.
Du löschst eine Person in deinem IdP Intric deaktiviert das Konto sofort. Wenn Entra ID die Person nach etwa 30 Tagen endgültig löscht, entfernt Intric das Konto: Es verschwindet aus allen Listen, und seine E-Mail-Adresse lässt sich wieder verwenden. Inhalte, die die Person erstellt hat, und der Audit-Verlauf bleiben erhalten.
Der Name einer Person ändert sich Intric aktualisiert den Namen, außer die Person hat ihren Namen in Intric selbst geändert. Einen Namen, den die Person in Intric gewählt hat, behält Intric bei.
Die E-Mail-Adresse einer Person ändert sich Intric aktualisiert die E-Mail-Adresse, sobald sie verifiziert ist und sofern kein anderes Intric-Konto sie verwendet.

Ein paar Regeln entscheiden die Fälle, die die Tabelle nicht abdeckt:

  • Eine Person, die bereits ein Intric-Konto mit derselben E-Mail-Adresse hat, behält dieses Konto. Intric legt kein zweites Konto an. Dasselbe gilt für eine Person mit ausstehender Einladung: Sie tritt über die Einladung bei.
  • Ein Konto, das ein:e Intric-Administrator:in von Hand deaktiviert hat, bleibt deaktiviert. Wenn du die Person in deinem IdP wieder aktivierst, stellt Intric nur Konten wieder her, die dein IdP deaktiviert hat.
  • Jede Änderung, die SCIM vornimmt, protokolliert Intric im Audit-Log.
  • SCIM arbeitet nur in eine Richtung. Änderungen gehen von deinem IdP an Intric, nie zurück. Wenn du in Intric eine Rolle änderst, eine Person deaktivierst oder sie in eine andere Abrechnungsgruppe verschiebst, ändert sich in deinem IdP nichts.
  • SCIM synchronisiert keine Gruppen. Die Gruppenmitgliedschaft aktualisiert sich weiterhin bei jeder Anmeldung, wie unter Nutzergruppen beschrieben.
  • SCIM weist keine Rollen zu. Bereitgestellte Nutzende erhalten die Rolle User. Rollen ändert eine Intric-Administrator:in in Intric.
  • SCIM wirkt nicht sofort. Entra ID sendet Änderungen in einem Zyklus, der alle 40 Minuten läuft. Intric wendet jede Änderung innerhalb von Sekunden nach dem Empfang an. Um eine Person sofort auszuschließen, deaktiviere sie zusätzlich in der Nutzerverwaltung von Intric.
  • SSO mit Entra ID, das für deine Organisation bereits funktioniert.
  • Die Rolle Application Administrator oder Cloud Application Administrator in Entra ID.
  • Entra ID P1 oder P2, wenn du Gruppen statt einzelner Nutzender zuweist.
  • Zwei Werte von Intric, die du über einen sicheren Kanal erhältst: eine Tenant URL und ein Secret Token. Bitte den Intric-Support, die Bereitstellung für deine Organisation einzuschalten, dann senden wir dir beide.

Den eigentlichen Abgleich übernimmt der Provisioning-Dienst von Entra ID. Er verbindet sich mit dem Secret Token mit dem Anmeldedienst von Intric, login.intric.ai, und verwaltet ausschließlich Nutzende deiner Organisation.

Die Bereitstellung läuft über eine eigene Unternehmensanwendung, getrennt von der App-Registrierung, die du für die Anmeldung verwendest.

Die Provisioning-Anwendung erstellen

  1. Gehe im Entra admin center zu Entra IDEnterprise apps und klicke auf New application.
  2. Klicke auf Create your own application.
  3. Gib ihr einen Namen, den deine Administrator:innen wiedererkennen, zum Beispiel Intric provisioning, wähle Integrate any other application you don’t find in the gallery (Non-gallery) und klicke auf Create.

Mit Intric verbinden

  1. Öffne in der neuen Anwendung Provisioning und stelle den Provisioning-Modus auf Automatic.
  2. Füge unter Admin Credentials die Tenant URL und das Secret Token ein, die du von Intric erhalten hast.
  3. Klicke auf Test Connection. Der Test muss erfolgreich sein, bevor du fortfährst. Schlägt er fehl, prüfe, ob du beide Werte vollständig eingefügt hast, und wende dich dann an den Intric-Support.
  4. Speichere.

Attributzuordnungen festlegen

  1. Öffne unter Mappings den Eintrag Provision Microsoft Entra ID Users und behalte nur die Zuordnungen aus der Tabelle unten. Lösche die übrigen, etwa Abteilung und Jobtitel: Der Anmeldedienst von Intric speichert sie nicht.
  2. Öffne unter Mappings den Eintrag Provision Microsoft Entra ID Groups und stelle Enabled auf No.
  3. Stelle unter Settings den Wert Scope auf Sync only assigned users and groups.
Entra-ID-Attribut SCIM-Attribut
userPrincipalName userName
Switch([IsSoftDeleted], , "False", "True", "True", "False") active
mail emails[type eq "work"].value
givenName name.givenName
surname name.familyName
displayName displayName
objectId externalId

Mit einer Person testen, dann starten

  1. Weise unter Users and groups eine Testperson zu.
  2. Öffne Provision on demand, wähle die Testperson aus und klicke auf Provision. Das Ergebnis listet jeden Schritt auf und was der Anmeldedienst geantwortet hat.
  3. Lass dir vom Intric-Support bestätigen, dass das Konto in Intric angelegt wurde.
  4. Weise dieselben Nutzenden und Gruppen zu, die deiner Anmeldeanwendung zugewiesen sind.
  5. Klicke auf Start provisioning.

Ab jetzt erhält eine Person ein Intric-Konto, sobald du sie zu einer zugewiesenen Gruppe hinzufügst, und verliert es, sobald du sie entfernst.

Die Schritte in Entra ID sind dieselben. Zwei Dinge unterscheiden sich.

Du erstellst die Zugangsdaten selbst. Deine Installation betreibt einen eigenen Anmeldedienst. Du erhältst also von Intric keine Tenant URL und kein Secret Token, sondern legst in deinem eigenen Anmeldedienst ein Dienstkonto und dessen Token an. Intric führt dich dabei an. Deine Installation braucht Intric-Backend 2.7.0 oder neuer und Zitadel 4.13 oder neuer.

Außerdem muss Entra ID deinen Anmeldedienst erreichen. Der Provisioning-Dienst läuft in der Cloud von Microsoft, und dein Anmeldedienst liegt in deinem Netzwerk. Dein Netzwerkteam muss diesen Datenverkehr erlauben. Dafür gibt es zwei Wege:

  • Veröffentliche nur den Pfad /scim/v2/ deines Anmeldehosts für den Provisioning-Dienst von Microsoft.
  • Installiere den lokalen Provisioning-Agenten von Microsoft in deinem Netzwerk. Er erreicht den Anmeldedienst, ohne dass du etwas nach innen öffnest.

Welcher Weg passt, entscheidest du. Teile Intric deine Wahl mit. Passt keiner der beiden, erarbeiten wir gemeinsam mit dir eine Lösung.

  • Das Secret Token hat ein Ablaufdatum. Wenn es abläuft, hört die Bereitstellung ohne Fehlermeldung in Intric auf: Der nächste Zyklus von Entra ID schlägt fehl, und Nutzende werden nicht mehr angelegt oder deaktiviert. Frage Intric vor dem Datum nach einem neuen Token und füge es unter Admin Credentials ein.
  • Prüfe die Provisioning-Protokolle, wenn eine Änderung nicht ankommt. In der Provisioning-Anwendung zeigt Provisioning logs jede Person, die Entra ID senden wollte, und die Antwort, die zurückkam. Meldet Entra ID Erfolg und Intric zeigt nach einigen Minuten trotzdem den alten Zustand, wende dich an den Intric-Support und nenne die E-Mail-Adresse der Person und die Uhrzeit.