Integration · SCIM
SCIM-Integration: Benutzer automatisch aus Ihrem Identity Provider anlegen und sperren
Zugriffsrechte gehören ins Identity-Verzeichnis, nicht in manuelle Listen. Über SCIM 2.0 legt Ihr Identity Provider (etwa Entra ID oder Okta) Benutzer in SimpleAct an, aktualisiert sie und deaktiviert sie beim Austritt. Synchronisiert werden Benutzer, keine Gruppen.
Im Produkt verfügbar (Enterprise)
SimpleAct stellt einen SCIM-2.0-Endpunkt für Benutzer bereit. Ihr Identity Provider meldet Zu- und Abgänge; ausgeschiedene Mitarbeitende verlieren den Zugriff, ohne dass jemand eine Liste pflegen muss.
- Benutzer anlegen, ändern, deaktivieren und löschen per SCIM 2.0
- Neue Benutzer starten mit der Rolle Viewer
- Keine Gruppen-Synchronisation. Rollen vergeben Sie in SimpleAct
Was die Integration leistet
Benutzerlebenszyklus aus dem Verzeichnis
Die Integration deckt den SCIM-Ressourcentyp User ab. Gruppen-Endpunkte gibt es nicht; Rollen und Systemzuordnungen bleiben eine bewusste Entscheidung in SimpleAct.
- Automatisches Anlegen
- Wird eine Person im Identity Provider der SimpleAct-Anwendung zugewiesen, entsteht ein Konto mit der Rolle Viewer. Höhere Rechte vergibt ein Administrator in SimpleAct.
- Rollen bleiben in SimpleAct
- Gruppen aus dem Verzeichnis werden nicht übertragen und nicht auf Rollen abgebildet. Das ist Absicht: Wer Admin oder Editor ist, entscheidet jemand in SimpleAct und nicht eine Gruppenzugehörigkeit.
- Automatisches Deprovisioning
- Setzt der Identity Provider ein Konto auf inaktiv oder löscht es, verliert die Person den Zugriff auf SimpleAct. Auch der Wert „False“, wie ihn Entra ID überträgt, wird korrekt als Deaktivierung gelesen.
Ablauf
So richten Sie SCIM ein
Einmalige Einrichtung im Identity Provider, danach läuft die Provisionierung im Hintergrund.
Token anlegen
Ein Administrator legt in SimpleAct einen API-Key mit dem Provisionierungsrecht an. Er dient als Bearer-Token für den SCIM-Endpunkt.
Identity Provider verbinden
Im Identity Provider tragen Sie die SCIM-Basis-URL Ihrer Organisation (/api/v1/scim/v2) und das Token ein und weisen die Benutzer zu.
Rollen in SimpleAct vergeben
Neue Benutzer erscheinen als Viewer. Rollen und Zuordnungen zu KI-Systemen oder Standorten pflegen Sie in SimpleAct.
Was die SCIM-Integration kann und was nicht
Gebaut für den Benutzerlebenszyklus, nicht für Rechteverwaltung über Gruppen.
- Benutzer anlegen, abfragen, ändern (PUT und PATCH), deaktivieren und löschen
- Discovery-Endpunkte: ServiceProviderConfig, Schemas, ResourceTypes
- Neue Benutzer mit der Rolle Viewer
- Keine Gruppen-Endpunkte und keine Abbildung von Gruppen auf Rollen
- E-Mail-Änderung eines Admin-Kontos nur über eine angemeldete Sitzung
- Enterprise-Funktion, je Organisation eingerichtet
Häufige Fragen zur SCIM-Integration
Welche Identity Provider werden unterstützt?
Jeder Identity Provider, der SCIM 2.0 für Benutzer spricht, etwa Microsoft Entra ID oder Okta.
Können wir Rollen über Gruppen steuern?
Nein. SCIM überträgt nur Benutzer. Rollen vergeben Sie in SimpleAct; neue Benutzer starten als Viewer.
Was passiert, wenn jemand das Unternehmen verlässt?
Sobald der Identity Provider das Konto deaktiviert oder löscht, kann sich die Person nicht mehr bei SimpleAct anmelden.
Benutzer, die sich von selbst aktuell halten
Mit SCIM bleiben die Benutzerkonten in SimpleAct auf dem Stand Ihres Verzeichnisses. Die Rechte vergeben Sie weiterhin bewusst.