Zum Hauptinhalt springen

DVDV-Bibliotheken

Um die Softwareentwickler von Fachverfahren oder Anwendungsprogrammen bei der Integration von Anfragen über die Directory-Schnittstelle an das DVDV zu unterstützen, werden für DVDV-Bibliotheken sowohl für Java- als auch .Net-Umgebungen bereitgestellt und können zusammen mit der erforderlichen Dokumentation sowie einigen Beispielen kostenlos über das Entwicklungsportal der FITKO bezogen werden. Die Bibliotheken bieten Funktionalitäten in Form von Klassen und Methoden, um möglichst komfortabel Anfragen an das DVDV zu formulieren und dessen Antworten auszuwerten. Die Bibliotheken entlasten die Softwareentwickler, so weit möglich, von der Entwicklung der Kommunikationsinfrastruktur oder Nachrichtenformaten. Es werden sowohl Einzelanfragen als auch eine Stapel-Verarbeitung unterstützt.

Die DVDV-Bibliotheken können entweder als direkt nutzbare Programmierschnittstelle unverändert verwendet werden oder die Quellen der Implementierung können ganz oder in Teilen als Muster für die eigene Integrationsprogrammierung dienen. Die Programmierschnittstellen machen keine Vorgaben hinsichtlich der Laufzeit-Architektur der nutzenden Programme.

In der Bibliothek sind die folgenden Features umgesetzt:

  • Authentifizierung entweder am DVDV-IAM/Keycloak oder direkt am DVDV-Server mittels zertifikatbasierter Authentifizierung
  • Failover (Vertreterregelung) zur Nutzung von mehreren DVDV-Servern. Ist ein Server nicht erreichbar, dann wird der nächste Server in der Kette verwendet. In regelmäßigen Abständen wird die Erreichbarkeit des primären Servers erneut geprüft und auf diesen zurückgeschwenkt, sobald die Verbindung wieder etabliert ist. Details zur Vertreterregelung finden sich unter Betreiber.
  • Aufruf der nachfolgend beschriebenen Anfragen an das DVDV und Aufbereitung der Antworten in einem dedizierten Datenmodell.

Folgende DVDV-Anfragen können am Interface „DVDVManager“ der DVDV-Bibliothek verwendet werden:

  • findOrganizationDescription: Diese DVDV-Anfrage dient der Suche nach einer Organisation oder einem Stellvertreter mit Hilfe von Organisationsschlüssel und Kategorie der gesuchten Organisation.
  • findServiceDescription: Mit Hilfe dieser DVDV-Anfrage kann über den Organisationsschlüssel und die URI der Dienstbeschreibung nach einem Dienst zu einer Organisation gesucht werden.
  • verifyCategory: Diese Anfrage wird zur Überprüfung verwendet, ob das einen Dienst anfragende Fachverfahren einer bestimmten Behördenkategorie zugeordnet ist.
  • findCategories: Diese Anfrage dient der Ermittlung der Kategorie einer Organisation oder eines Stellvertreters durch Angabe des Organisationsschlüssels und des Fingerprints eines Client-Zertifikats. Zurückgegeben wird eine Liste der Kategorien der gefundenen Organisation bzw. ihrer Stellvertreter.
  • findOrganizationsByServiceElement: Diese Anfrage dient zur Suche nach Organisationen anhand bestimmter Eigenschaften eines ihrer Dienstelemente.
  • findCertificateByFingerprint: Die letzte Anfrage liefert bei Angabe des Fingerprints eines Zertifikats das zugehörige, im DVDV hinterlegte Zertifikat.