Zielgruppe BetriebVersion: GSB10.1LDAP-Migration
Um Benutzer aus einem GSB 7.x oder GSB 10.0.x LDAP in den GSB 10.1+ Userservice zu migrieren, wird innerhalb des GSB 10.1+ das Tool ldap-migrator zur Verfügung gestellt.
Hinweis: |
---|
Da der ldap-migrator - wie die meisten GSB-Anwendungen auch - auf Spring Boot basiert, können alle hier Vorgestellten Optionen sowohl als Kommandozeilen-Parameter als auch als Properties in einer application.properties-Datei definiert werden. |
1 Zugriff auf die LDAP-Daten
Der ldap-migrator kann sich entweder direkt mit einem laufenden LDAP-Server verbinden, oder die Daten aus einem LDAP-Export im ldif
-Format lesen:
Verbindung zu einem LDAP-Server:
spring.ldap.urls=ldap://myserver:1235spring.ldap.username=adminspring.ldap.password=secret
Einlesen der Daten aus einem ldif
-Export:
spring.ldap.embedded.ldif=file:///opt/standardlsg.ldifspring.ldap.embedded.base-dn=dc=example,dc=com
2 Migration der Daten
Konfiguration der LDAP-Migration
propertiesbase-dn=dc=standardlsg,dc=preview,dc=example,dc=com (1)
customer=standardlsg (2)
group-type-mapping.JCR_CONTENT_SERVER=content (3)
(1) | Basis DN aus dem die Benutzer und Gruppen gelesen werden sollen. |
(2) | Ziel-Mandant der Migration |
(3) | Zuordnung des LDAP Gruppen-Typs JCR_CONTENT_SERVER zum GSB 10.1+ Gruppen Typ content |
2.1 Passwörter
Die Passwörter der Benutzer werden nicht migriert. Alle Benutzer, welche eine E-Mail Adresse haben, können ihr Passwort nach der Migration über die "Passwort vergessen" Funktion selbst neu setzen. Für Benutzer ohne E-Mail Adresse wird ein neues einmal-Passwort generiert, und am Ende der Migration ausgegeben.
Die Ausgabe der Passwörter kann über die Option --output-file=neue-passwörter.csv
in eine Datei umgeleitet werden.
3 Export der Daten in den Userservice
Die Benutzer und Gruppen werden direkt in den Userservice importiert. Dazu muss die Verbindung zum Userservice konfiguriert werden:
Konfiguration der Userservice-Verbindung
gsb.userservice.url=http://myserver:4711gsb.userservice.username=admingsb.userservice.password=secret