Hilfe Die Plattform Import und SSO
Keycloak verbinden
Auf dieser Seite
Überblick
Keycloak wird mit reinem Lesezugriff gelesen: Benutzer, Gruppen (einschliesslich Untergruppen) und Mitglieder eines Realms. Dieser Artikel behandelt die Vorbereitung in Keycloak und die Abschnitte Verbindung und SSO-Anmeldung; die übrigen Einstellungen sind bei allen Importen gleich.
1Einen Client in Keycloak vorbereiten
Die Synchronisierung authentifiziert sich als vertraulicher Client mit Dienstkonto (client_credentials-Flow). Im zu lesenden Realm:
erstellen Sie einen OpenID-Connect-Client mit aktivierter Client-Authentifizierung und aktiviertem Dienstkonto;
weisen Sie seinem Dienstkonto die beiden folgenden Rollen des Clients
realm-managementzu;prüfen Sie, dass der Realm unter
{Basis-URL}/realms/{Realm}/protocol/openid-connect/token(Token) und{Basis-URL}/admin/realms/{Realm}/(Lesevorgänge) antwortet.
Ohne clientseitige Verschlüsselung verbinden sich unsere Server aus dem Internet mit Keycloak: Die Adresse muss https:// verwenden und sich ausschliesslich zu öffentlichen Adressen auflösen. In einer verschlüsselten Organisation liest der Bexxo Protected Agent Keycloak aus Ihrem Netzwerk.
2Den Abschnitt Verbindung ausfüllen
Geben Sie den Realm, die Client-ID und das Secret sowie die Basis-URL ein: die Serveradresse in https://, ohne /realms, zum Beispiel https://sso.exemple.ch. Wenn Ihr Server seine Realms unter einem Pfad veröffentlicht (etwa /auth), schliessen Sie ihn ein.
Was importiert wird
- Ein in Keycloak deaktivierter Benutzer wird als inaktiv importiert.
- Jede Untergruppe, in jeder Tiefe, wird zu einer Gruppe. Nur die direkten Mitglieder werden zugeordnet: Ein Mitglied einer Untergruppe gehört nicht zur übergeordneten Gruppe.
- In der Feldzuordnung und den Filtern verwendbare Eigenschaften für eine Person:
username,email,firstName,lastName,enabledund jedes benutzerdefinierte Attribut in der Formattributes.gefolgt von seinem Namen (nur erster Wert), zum Beispielattributes.department. - Für eine Gruppe:
nameundpath(vollständiger Pfad, zum Beispiel/Siège/Vente).
Die vorausgefüllte Zuordnung deckt nur den Namen, den Vornamen und die E-Mail ab: Fügen Sie bei Bedarf eine Zeile für die Funktion oder das Telefon aus einem benutzerdefinierten Attribut hinzu.
SSO-Anmeldung mit Keycloak
SSO verwendet einen OpenID-Connect-Client des Realms mit eigener Client-ID und eigenem Secret, unabhängig vom Abschnitt Verbindung.
Deklarieren Sie alle in SSO-Anmeldung angezeigten Redirect-URLs (Portal und Academy) als gültige Redirect-URIs des Clients.
Geben Sie den Issuer des Realms in der Form
https://{Server}/realms/{Realm}, die Client-ID und das Secret ein, speichern Sie und testen Sie dann die Discovery. Der Issuer muss aus dem Internet erreichbar sein, auch für eine Organisation mit aktiver Verschlüsselung.
Die Aktivierung von SSO und die Auswirkungen eines Ausfalls sind im allgemeinen Artikel beschrieben.
Testen und Fehler beheben
| Situation | Zu prüfen |
|---|---|
| Verbindungstest fehlgeschlagen | Ist die Basis-URL in https://, ohne /realms? Sind der Realm und die Client-ID korrekt? Ist das Dienstkonto auf dem Client aktiviert? |
| Anmeldedaten akzeptiert, Lesen abgelehnt | Hat das Dienstkonto des Clients die Rollen view-users und query-groups des Clients realm-management? |
| Organisation mit aktiver Verschlüsselung | Test und Synchronisierung laufen über den Bexxo Protected Agenten: Er muss gestartet sein und Ihren Keycloak-Server erreichen. |
Keine Antwort gefunden? Kontakt aufnehmen