Die App UCS@school Kelvin REST API aus unserem App Katalog, ist eine REST- Schnittstelle, mit der Sie User und Klassenobjekte von UCS@school komfortabel anlegen, löschen oder ändern. Im Gegensatz zu der Importfunktion und manuellen Eingriffen über das Webinterface kann die API automatisiert angesprochen werden und ist damit weniger fehleranfällig.
Wir haben für die REST API jetzt eine aktualisierte Version veröffentlicht, die Sie im Univention App Center finden und in Ihre UCS Umgebung integrieren können.
Neue Features von Version 1.8.0:
Auswertung von Passwortrichtlinien, Spracheinstellungen und Attribute für Rollen
Über Passwortrichtlinien können Administrator*innen festlegen, welche Zeichen genutzt werden dürfen bzw. wie lang Passwörter sein müssen, damit sie akzeptiert werden. Bisher wurden die Richtlinien nur während des Editierens ausgewertet, also über die PUT und PATCH-Endpunkte.
Mit der neuen Version der REST API können Sie Passwortrichtlinien jetzt auch schon während der Erstellung von Benutzern auswerten. Eine neue Konfigurationsoption ermöglicht es Ihnen, dieses neue Feature selber zu aktivieren. Standardmäßig bleibt ansonsten das alte Verhalten bestehen.
In Anfragen gegen die API kann auch die im System eingestellte Sprache übergeben werden. Kommt es zu einer Fehlermeldung, z.B. dass die Passwortrichtlinie nicht erfüllt wurde, wird den Nutzer*innen die Meldung in der übergebenen Systemsprache angezeigt.
Eine weitere Neuerung gibt es für das Attribut ‚UCS@school Rolle‘.
Mit diesem Attribut können Sie von nun an projektspezifische Rollen der Benutzer speichern. Zum Beispiel erhält ein Nutzer oder eine Nutzerin mit der Rolle „Schüler“ im Rahmen des Projekts „TestProjekt“ an der Schule „School1“ den Wert „student:TestProjekt:School1“.
Um nun eine bestimmte Aktion zu triggern oder explizit zu verbieten, kann das Attribut beispielsweise in einem eigens dafür geschriebenen Hook ausgewertet werden.
So kann unterschiedliches Verhalten für unterschiedliche Kontexte realisiert werden. UCS@school Standardrollen bleiben dabei unveränderbar und können nicht bearbeitet, entfernt oder hinzugefügt werden.
Eine vollständige Liste der Änderungen, sowie wichtige Hinweise finden Sie im Changelog der UCS@school Kelvin REST API, bevor Sie die App updaten.
