Du kannst die SCIM-Provisionierung zwischen Okta und Haiilo konfigurieren, um deine Nutzer und Gruppen aus Okta zu importieren.

Diese Anweisungen dienen nur als Referenz. Beim Implementieren von SCIM ist es wichtig, die spezifischen Richtlinien und Best-Practices deiner Organisation zu berücksichtigen. Diese Anleitung konzentriert sich auf die Konfiguration von SCIM auf der Okta-Seite und enthält Okta-spezifische Details, die zum Zeitpunkt der Erstellung aktuell sind. Wir empfehlen, die Okta-Dokumentation zur SCIM-Provisionierung für weitere Informationen zu prüfen.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

• Eine erreichbare SCIM-Basis-URL, zum Beispiel https://example.haiilo.app/api/scim/v2.
• Die Berechtigung „Verwaltung der Benutzerverzeichnisse“ in deiner Haiilo-Plattform.
• Administrative Berechtigungen in Okta, um Anwendungen zu erstellen und zu konfigurieren.

1. Starte die Einrichtung eines SCIM-Benutzerverzeichnisses in Haiilo

Du benötigst die Berechtigung „Verwaltung der Benutzerverzeichnisse“ in Haiilo, um ein Benutzerverzeichnis einzurichten.

1. Gehe zur Administration > Benutzerverzeichnisse.
2. Wähle Verzeichnis anlegen, um ein neues Benutzerverzeichnis hinzuzufügen.
3. Gib einen Namen ein.
4. Wähle SCIM als Verzeichnistyp.
5. Aktiviere das Verzeichnis.
6. Wechsle zum Tab API-Clients und wähle Erstellen, um ein API-Client-Paar zu erstellen.
7. Kopiere und speichere die Client-ID und das Client-Secret für die spätere Verwendung. Das Client-Secret wird erst nach dem Speichern generiert und ist nur einmal sichtbar.
8. Wähle Speichern, um das Benutzerverzeichnis zu sichern.

2. Erstelle eine Anwendung in Okta

Du benötigst administrative Berechtigungen in Okta, um SCIM einzurichten.

1. Melde dich bei deiner Okta-Plattform an.
2. Gehe zu Applications > Applications.
3. Wähle Create App Integration aus.
4. Wähle SAML 2.0 > Next.
5. Gib einen Namen ein und lade optional ein Logo für die App hoch.
6. Gib Platzhalterwerte für Single sign-on URL und Audience URI (SP Entity ID) ein. Diese Werte werden für das SCIM-Provisioning nicht verwendet. Lass alles andere unverändert.
7. Wähle Next.
8. Behalte die Standard-Einstellungen bei und wähle Finish, um die App zu erstellen.
9. Öffne den Tab General.
10. Wähle unter App Settings > Edit aus.
11. Ändere die Provisioning-Einstellung auf SCIM.
12. Wähle Save.

3. Richte eine Provisioning-Verbindung in Okta ein

1. Gehe in deiner Okta-App zu Provisioning > Integration.
2. Gib unter SCIM connector base URL deine SCIM-Basis-URL ein. Die URL endet mit /api/scim/v2. Zum Beispiel https://example.haiilo.app/api/scim/v2.
3. Gib unter Unique identifier field for users userName ein.
4. Wähle unter Supported provisioning actions:
   • Push New Users: Erstellt Nutzer in Haiilo.
   • Push Profile Updates: Aktualisiert Nutzerinformationen in Haiilo.
   • Push Groups: Sendet ausgewählte Gruppen und deren Mitgliedsinformationen an Haiilo.
5. Wähle unter Authentication Mode OAuth 2 aus.
6. Wähle unter Grant Type Client Credentials aus.
7. Gib unter Access token endpoint URI deinen OAuth-Token-Endpunkt ein. Die URL endet mit /api/oauth/token. Zum Beispiel https://example.haiilo.app/api/oauth/token.
8. Gib die Client-ID ein, die du von Haiilo kopiert hast.
9. Gib das Client-Secret ein, das du von Haiilo kopiert hast.
10. Wähle Save.
11. Bleibe im Tab Provisioning und öffne To App.
12. Aktiviere:
    • Create Users: Erstellt zugewiesene Nutzer in Haiilo.
    • Update User Attributes: Aktualisiert die Attribute der bereitgestellten Nutzer in Haiilo.
    • Deactivate Users: Deaktiviert Nutzer in Haiilo, wenn sie in Okta deaktiviert werden.
13. Wähle Save.

4. Weisen Sie Nutzer und Gruppen in Okta zu

1. Gehe in deiner Okta-App zu Assignments.
2. Wähle Assign.
3. Wähle aus, ob du Personen oder Gruppen zuweisen möchtest.
4. Wähle die Personen oder Gruppen aus, die Okta in Haiilo bereitstellen soll.
5. Wähle neben jeder Person oder Gruppe Assign.

5. Konfiguriere die Gruppenbereitstellung in Okta

1. Gehe zum Tab Push-Gruppen.
2. Wähle Push-Gruppen aus.
3. Wähle eine Option:
   • Gruppen nach Namen finden: Suche nach einer bestehenden Okta-Gruppe anhand ihres Namens.
   • Gruppen nach Regel finden: Definiere, welche Gruppen per Regel gepusht werden sollen.
4. Gib einen Gruppennamen ein.
5. Wähle die Gruppe aus, die du synchronisieren möchtest.
6. Wähle Speichern oder Speichern & weitere hinzufügen.

Nach dem Speichern startet Okta automatisch die Synchronisierung der Gruppe mit Haiilo.

Fehlerbehebung

Wenn ein Benutzer oder eine Gruppe nicht wie erwartet synchronisiert wird:

• Überprüfe die Bereitstellungsprotokolle in Okta auf Fehler.
• Stelle sicher, dass der Benutzer oder die Gruppe der Anwendung zugewiesen ist.
• Stelle sicher, dass die Gruppe im Tab Push-Gruppen konfiguriert ist.

Bitte kontaktiere unser Support-Team nur, nachdem du die oben genannten Tipps überprüft hast.