Mit dem Beta-Release der REST API für den Univention Directory Manager (UDM) steht eine Vorab-Version der zukünftigen Standardschnittstelle für die Integration von Anwendungen mit dem Verzeichnisdienst von Univention zur Verfügung. Im Folgenden möchte ich Ihnen einen kurzen Überblick über die Ziele und Anwendungsfälle zum aktuellen Stand der API geben und Sie zum Testen animieren – wir freuen uns auf Ihr Feedback für weitere Verbesserungen für die finale Version!
Was ist die „UDM REST API“?
Eine „REST API“ (oder auch „RESTful API“) ist ein Webservice, über den eine Integration zwischen Anwendungen realisiert werden kann.
Über die REST API des Univention Directory Managers wird ein Zugriff auf alle Inhalte des Verzeichnisdienstes von Univention Corporate Server (UCS) ermöglicht. Sie ist damit in der Funktionalität vergleichbar mit den bereits vorhandenen und weiter bestehenden Skritping-Schnittstellen (z. B. dem „udm“ Kommandozeilen-Tool). Im Gegensatz zu diesen ist die API aber über das Netz per HTTPS erreichbar und über standardisierte Datenformate (JSON) einfacher in bestehenden Anwendungen integrierbar.
An wen richtet sich die „UDM REST API“?
Univention Directory Manager erlaubt den Zugriff auf die Inhalte des Verzeichnisdienstes und stellt dabei sicher, dass die Inhalte konsistent und standardkonform bleiben. Daher werden in UCS alle Veränderungen am Verzeichnisdienst nur über UDM durchgeführt.
Mit der REST API kann diese Schnittstelle jetzt vereinfacht von anderen Systemen bzw. anderer Software angesprochen werden. Wir möchten damit vor allem die Integration für beispielsweise folgende Einsatzszenarien erleichtern:
Betreiber von UCS Umgebungen: Integration mit bestehenden Systemen
Anwendungsfälle können die Pflege von Benutzereigenschaften durch Informationen aus HR-Systemen oder der Abgleich von Rechnerobjekten mit Inventarisierungslösungen sein. Betreiber einer IT-Infrastruktur können die REST API nutzen, um aus den anzubindenden Systemen heraus direkt lesend und schreibend auf UDM zuzugreifen.
Anbieter von Apps im Univention App Center: Integration der Apps
Hersteller von Software-Lösungen im Univention App Center können über die UDM REST API standardisiert auf den Verzeichnisdienst zugreifen. Dabei profitieren die Entwickler der jeweiligen Lösung von den standardisierten und von vielen Programmiersprachen unterstützten Datenmodellen genauso wie von dem Zugriff per HTTPS. Entwicklungen können direkt in der gewohnten Programmiersprache erfolgen, da keine Abhängigkeit zu den UDM Python-Schnittstellen mehr besteht.
Anwendungsfälle können die Abfrage von Informationen zum angemeldeten Benutzer oder auch Pflege von Inhalten des Verzeichnisdienstes aus den eigenen Anwendungen heraus sein.
Vereinfachungen innerhalb der UCS Produktentwicklung:
In der zukünftigen Weiterentwicklung von UCS wollen wir verstärkt auf die REST API anstelle der bisher auf jedem System ausgerollten Python Bibliotheken setzen. Wir versprechen uns damit einen Abbau von Risiken durch unterschiedliche Bibliotheksversionen in UCS-Umgebungen, sowie Vereinfachungen bei der Integration mit Software unterschiedlicher Programmiersprachen.