Univention UCS@school – Provisioning API (Systemadministrator)
INHALTSVERZEICHNIS
- 1 Überblick
- 2 Voraussetzungen
- 3 Funktionsweise der Synchronisation
- 4 Schuljahreswechsel
- 5 Sicherheit
- 6 Bekannte Einschränkungen
Einleitung
Dieser Artikel beschreibt die neue Univention-UCS@school-Integration mit itslearning über die Univention Provisioning API, die 2026 eingeführt wurde. Er beschreibt, wie der Connector Nutzer*innen, Gruppen und Hierarchien synchronisiert, was Kund*innen vorbereiten müssen und was beim Schuljahreswechsel mit den Daten geschieht.
Wichtig: Dieser Artikel behandelt ausschließlich den auf der Provisioning API basierenden Univention-Connector. Nutzt Ihre Schule stattdessen den Itswizard-Connector oder den ID-Broker-Connector für UCS@school, lesen Sie bitte den jeweils passenden Artikel.
1 Überblick
Der Connector ruft Daten aus UCS@school über die Univention Provisioning API ab, konvertiert sie in das itslearning-Format und sendet sie zum Import an itslearning. Der Connector speichert die Daten außerdem in einer lokalen Datenbank, sodass jederzeit eine vollständige Synchronisation der Daten möglich ist. Diese Synchronisation läuft nächtlich.
Diese Integration unterstützt den Import von Elternkonten und Eltern-Kind-Beziehungen
2 Voraussetzungen
Voraussetzung: Folgendes muss vorhanden sein, bevor der Connector eingerichtet werden kann:
- Die Schule muss UCS-Version 5.2 oder neuer einsetzen. Die Univention Provisioning API ist erst ab dieser Version verfügbar.
- Die Schule installiert die Provisioning API im UCS App Center.
- Die Schule veröffentlicht den Endpunkt der Provisioning API und stellt itslearning die URL zur Verfügung.
- Die Schule erstellt ein Abonnement für itslearning, das die Themen users/user und groups/group abdeckt.
3 Funktionsweise der Synchronisation
3.1 Erstsynchronisation
Beim ersten Ausführen des Abonnements wird ein sogenannter Prefill bereitgestellt: alle zum Zeitpunkt der Anfrage in UCS@school verfügbaren Daten.
3.2 Laufende Synchronisation
Nach dem Prefill liefert das Abonnement Aktualisierungen zu Verzeichnisobjekten, die sich seit der letzten Anfrage geändert haben. itslearning speichert den Prefill zusammen mit allen nachfolgenden Änderungen in einer Zwischendatenbank, die jederzeit einen vollständigen, aktuellen Stand der Daten enthält. Dieser Stand wird nächtlich mit itslearning synchronisiert.
3.3 Synchronisierte Daten
Der Connector verwendet eine Teilmenge der über die Provisioning API verfügbaren Eigenschaften und ordnet sie den entsprechenden, von itslearning genutzten IMS-Enterprise-Elementen zu:
| Quelle (UCS@school) | itslearning-Feld | Anmerkungen |
|---|---|---|
univentionObjectIdentifier | Sync-Key | Wird als itslearning-Sync-Key verwendet |
username (LDAP uid) | Benutzername | Wird häufig als SSO-Attribut verwendet |
firstname / lastname | Vorname / Nachname | – |
| E-Mail / Telefon | E-Mail / Telefon | Optional |
ucsschoolRole | Nutzerrolle | Schüler*in, Lehrkraft oder Administrator |
ucsschoolLegalGuardian | Eltern-Kind-Beziehung | Verknüpft ein Elternkonto mit dem/der Schüler*in |
Gruppen (erste cn) | Sync-Key und Titel der Hierarchie | – |
Gruppenzugehörigkeiten basieren auf der ucsschoolRole des Nutzerkontos: Schüler*innen werden als Schüler*in-Mitglieder und Lehrkräfte als Lehrkraft-Mitglieder in ihre jeweiligen Gruppen aufgenommen.
4 Schuljahreswechsel
Bei Univention UCS@school ist der Schuljahreswechsel kein einzelnes Ereignis mit einem festen Ende, sondern ein Prozess, der sich über den gesamten Sommer erstrecken kann und bei jeder Schule anders aussieht. Es wird daher empfohlen, die reguläre nächtliche Synchronisation den ganzen Sommer über weiterlaufen zu lassen.
6 Bekannte Einschränkungen
Wichtig: Gruppen werden aus Nutzereigenschaften abgeleitet und nicht direkt aus UCS@school gelesen. Das bedeutet, dass leere Gruppen ohne Mitglieder nicht mit itslearning synchronisiert werden.
Weitere Hilferessourcen
Haben Sie weitere Fragen? Wenden Sie sich je nach Thema an Ihren itslearning- oder Support-Kontakt.
Produkt-Release-Notes
Bleiben Sie über die neuesten itslearning-Releases auf dem Laufenden: https://itslearning.com/product-updates
Servicestatus
Prüfen Sie den aktuellen Status der itslearning-Dienste: https://status.itslearning.com/
Ideen-Portal
Teilen Sie Ihre Ideen und gestalten Sie die Zukunft von itslearning mit: https://ideas.itslearning.com/
Roadmap
Werfen Sie einen Blick auf unsere Roadmap: https://itslearning.com/global/roadmap/