Zum Inhalt springen
Bexxo Hilfe

Hilfe Die Plattform Import und SSO

Keycloak verbinden

Für Administratoren Aktualisiert am 13. November 2026

Einen Keycloak-Realm verbinden, um die Personen und Gruppen der Organisation zu synchronisieren, und die Anmeldung mit dem Keycloak-Konto (SSO) vorbereiten.
Auf dieser Seite
  1. Überblick
  2. Einen Client in Keycloak vorbereiten
  3. Den Abschnitt Verbindung ausfüllen
  4. Was importiert wird
  5. SSO-Anmeldung mit Keycloak
  6. Testen und Fehler beheben

Ü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.

Die bei allen Importen gemeinsamen EinstellungenPersonen importieren und SSO einrichten

1Einen Client in Keycloak vorbereiten

Die Synchronisierung authentifiziert sich als vertraulicher Client mit Dienstkonto (client_credentials-Flow). Im zu lesenden Realm:

  1. erstellen Sie einen OpenID-Connect-Client mit aktivierter Client-Authentifizierung und aktiviertem Dienstkonto;

  2. weisen Sie seinem Dienstkonto die beiden folgenden Rollen des Clients realm-management zu;

  3. 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.

Rollen des Clients realm-management

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, enabled und jedes benutzerdefinierte Attribut in der Form attributes. gefolgt von seinem Namen (nur erster Wert), zum Beispiel attributes.department.
  • Für eine Gruppe: name und path (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.

  1. Deklarieren Sie alle in SSO-Anmeldung angezeigten Redirect-URLs (Portal und Academy) als gültige Redirect-URIs des Clients.

  2. 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

SituationZu prüfen
Verbindungstest fehlgeschlagenIst 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 abgelehntHat das Dienstkonto des Clients die Rollen view-users und query-groups des Clients realm-management?
Organisation mit aktiver VerschlüsselungTest und Synchronisierung laufen über den Bexxo Protected Agenten: Er muss gestartet sein und Ihren Keycloak-Server erreichen.
Organisation mit aktiver VerschlüsselungDen Bexxo Protected Agent installieren

Keine Antwort gefunden? Kontakt aufnehmen