ELBA: Verzeichnisdienst

XBAU-312
  • 2.4
Geprüft
Fr., 29.12.2023 - 09:15
Fertig
Fr., 22.09.2023 - 13:29
priority-icon High
  • Infrastruktur & Technik

Es ist soweit Konsens, dass zur Adressierung von PI auf der ELBA-Plattform durch XBau-Nachrichten eine eindeutige technische Kennung notwendig ist. Diese technische Kennung soll über einen synchronen Services der ELBA-Plattform abgerufen werden, um zu vermeiden, dass angeschlossene Systeme eigene Verzeichnisse abbilden. Diese Schnittstelle soll vorzugsweise in der REST-Technologie umgesetzt sein. Um eine verlässliche Basis für die Implementierung für Online-Plattformen und Fachverfahren zu bilden, soll die Schnittstelle im XBau-Standard spezifiziert sein.

Kommentare

EG23-03 19.09.2023

Anforderungen, wie sie von Databund u.a. formuliert werden:

Technische Adressierung konkreter PI / Verzeichniszugriff, um an ELBA registrierten PI auszuwählen

  1. Online-Plattformen und Fachverfahren benötigen für die Auswahl eines zu beauftragenden PI eine synchrone, performante und hochverfügbare und durch XBau standardisierte Schnittstelle zum Abruf eines kategorisierten Verzeichnisses (möglichst per gesichertem REST-Aufruf) .
  1. Dafür braucht es eine einheitliche und stabile technische ID eines konkreten PI, welche in den XBau-Nachrichten an ELBA als Identifier genutzt werden kann.
  1. Die Subadressierung soll funktioniren entsprechend den bereits diskutierten Adressierungen von Plattformen wie zur Behördenbeteiligung (siehe CR XBau-281)
  1. Es ist keine Verzeichnis-Synchronisierung o.ä. vorgesehen.

Details zur Schnittstellen sind noch zu klären durch eine kleine AG unter Führung von Databund, die sich im Laufe der nächsten Wochen abstimmen wird. 

Status in Arbeit

Anforderungen von ELBA – Elektronische Bautechnische Prüfakte 18.09.2023
hier: Beschreibung Anforderungen für die Anpassung Version XBau 2.4

Anforderung 1: Verzeichnisdienst für die Subadressierung („Leser“) in Xbau Nachrichten 0500 ff. mit Be-zug auf Ticket XBAU-281
„..mittels welcher Daten wird ein bestimmter Prüfingenieur / Ingenieurbüro adressiert?..“

  • Für die Xbau Kommunikation ist neben dem DVDV Eintrag des Portals die Subadressierung („Leser“) des Prüfingenieurs notwendig.
  • Das Projekt „BVPI ELBA“ wird einen hochverfügbaren und performanten Verzeichnisdienst zur Verfügung stellen, der alle notwendigen Daten für Prüfingenieure der gesamten Bundesrepublik enthält. Für die Pflege der Daten ist die BVPI verantwortlich.
  • Der Verzeichnisdienst wird sich über eine REST API online abfragen lassen.
  • Das Ergebnis der Abfrage ist ein JSON Object zur Weiterverarbeitung (Pull-Down Menue o.ä.) in Fachanwendungen bzw. auf den Portalen. Bestandteil des Ergebnisses wird die eindeutige ID des Prüfingenieurs für die Subadressierung sein.
  • Der Zugriff auf den Verzeichnisdienst wird durch ein X.509 Zertifikat abgesichert. Damit wird ein Standard analog XTA2 erreicht.
  • Die URL wird „https://ds.bvpi-elba.de“ (DS = Directory Service) lauten.
  • Die Routen und die notwendigen technischen Parameter werden in einem gesonderten Wiki dokumentiert.

Beispiele für Routen der REST API. Die Routen sind als Filter zu verstehen.

  • „Bundesland/BL“: Filter für Prüfingenieure eines Bundeslandes (BW, BY, BE usw.) bzw. DE für die gesamte Bundesrepublik.
  • „Fachrichtung/FACHRICHTUNG“: Filter für die Fachrichtung. STA (Statik, Standsichheit), BS (Brandschutz).
  • „Name/NAME“: Filter für eine Namenssuche
  • „Ort/ORT“: Filter für Suche in einem Ort
  • „Qualifizierung/QUALIFIZIERUNG: “Filter für Qualifizierung im Fachbereich STA. Massivbau (MaB), Mauerwerksbau (MwB), Stahlbau (StB), Holzbau (HoB) usw.

Die Routen lassen sich untereinander kombinieren. 

Weitere Informationen seitens ELBA 27.10.2023

Die Routen und die notwendigen technischen Parameter werden unter „https://ds.bvpi-elba.de/api“ dokumentiert.

Absicherung für den Zugriff auf den Verzeichnisdienst

  • Bei den zur Verfügung gestellten Daten handelt es sich um frei zugängliche Daten der Prüfingenieure und ihrer Büros. Zum Beispiel „https://bawue.bvpi.de/de/vpi-mitglieder-suche.php“
  • Verletzungen der Bestimmungen der DSGVO sind ausgeschlossen.

EG23-04 28.11.2023 / Arbeitsgruppe 2

Bemerkungen:

  • Es sind keine strukturellen Anpassungen im Standard mehr gegenüber der jetzigen Umsetzung notwendig.
  • Es sind textuelle Ergänzungen in der Spezifikation notwendig.
  • Der Textinhalt wird von ELBA geklärt.
  • Der konsolidierte Text wird an die Leitstelle weitergeleitet.

In der Nachricht bautechnischeNachweise.pruefauftrag.0500 wurde die Beschreibung des Elements
piKennung aktualisiert. 

Der Text lautet gemäß beigefügtem Dokument "ZuarbeitCR312und313-28112023.pdf":

"Hier ist die PI-Kennung (Prüfingenieurskennung) einzutragen, mit der der Prüfingenieur eindeutig identifiziert werden kann. 
Die Kennung kann über den Verzeichnisdienst „https://ds.bvpi-elba.de“ abgefragt werden. Der Verzeichnisdienst wird mit geeigneten Mitteln abgesichert.
Eine Beschreibung der Zugriffe und der API steht unter „https://ds.bvpi-elba.de/api“ zur Verfügung.“

QS am 29.12.2023 durch XL

o.k. -> Geprüft