[Epic] Anbindung BundID-Statusmonitor über den ZBP-Adapter
Warum
Die BundID ist eine zentrale Komponente der digitalen Verwaltungsleistungen und ermöglicht zum einen allen Bürgern eine einfache, schnelle sowie sichere Authentifizierung in den Onlinediensten. Zum anderen können und sollen über das Zentrale Bürgerpostfach der BundID (ZBP) Bescheide und Nachrichten an die Bürger zugestellt werden.
Der Bürger erhält mit dem Zugang zur BundID zusätzlich zum ZBP einen zentralen Statusmonitor für die transparente Anzeige in Echtzeit aller online gestellten Anträge. In diesem kann der Antragsteller den Bearbeitungsstand der Behörde nachvollziehen und die Notwendigkeit direkter Nachfragen wird reduziert. Die Verwaltungssysteme(als auc Online-Dienste) versenden die Statusänderungen direkt an den Bürger über den Statusmonitor der BundID.
Ziel
Ziel dieses Epics ist es den im Epic #714 erstellten ZBP Adapter so zu erweitern, dass nicht nur die Nachrichten an das jeweilige ZBP versendet werden, sondern auch der zweite öffentliche Endpunkt der BundID angesprochen werden kann, so dass zu einem Antrag sowohl der OD als auch das FV ein Update zu dem Status des Antrags übermitteln kann. Der Antrag wird über eine von der BundID vergebene ApllicationID eindeutig identifiziert. Diese ApplicationID wird beim Login über die BundID(#82 - kommt noch) vom OD abgerufen und an das FV über die Metadaten übergeben(#1113 (closed) - in Arbeit). (Anm. 19.8: Team SDK stellt diese FUnktion bereits zur Verfügung, konnte aber aufgrund der fehlednen ApplicationID es noch nicht testen. Wir versuchen hier mit einer mit NAVO generierten ApplicationID kurzfristg zu testen) Accept- & Reject-Events, sowie Weiterleitung der Fehlermeldungen sind entsprechend der Umsetzung für die ZBP-Nachrichten im Adapter umzusetzen.
Nicht-Ziele:
- eigenes EPIC: Nachrichten in das ZBP Postfach ablegen
- eigenes EPIC: Anbindung FIT-Connect an ZBP durch ZBP-Adapter
- eigenes EPIC: Anpassung Metadaten
- eigenes EPIC: Optimierung Authentifizierungsprozess und Übergabe an FV
Links, Hinweise, Bemerkungen
- Integrationsumgebung BundID: https://int.id.bund.de/de
- Doku BundID: https://ssp.id.bund.de/ip?id=downloads
- FIT-Connect Konzept ZBP Adapter: https://wiki.fit-connect.fitko.dev/de/Konzeption/ZBP-Adapter
Einordnung in die gesamte BundID Thematik:
Als Hilfe zur Abgrenzung: Das folgende Bild zeigt alle EPICs rund um die BundID entlang des E2E Antragsprozesses. In diesem Epic geht es um den STEP 2 aus dem Diagramm.
- STEP 1: #2016 (closed)
- STEP 2: #714
- STEP 3: #82
- STEP 4: #2226
Stories
Akzeptanzkriterien
-
Folgende Antragsstatusmeldungen können dargestellt werden: -
Ausfüllen des Antrags begonnen (OD) -
Antrag bei der Behörde eingereicht (OD) -
Antrag bei der Behörde eingegangen (FV) -
Antrag wird geprüft (FV) -
Aktivität erforderlich (FV) -
Antrag abgeschlossen (FV)
-
-
in der ersten Ausbaustufe keine automatische Kopplung an unseren Antragsstatus (ggf. in den SDKs) -
Statusupdates bekommen immer einen neuen Case, da neuer Sender und Empfänger (andere Leistung als ZBP-Nachricht) - Verlinkung über externe ID -
ZBP-Adapter ruft die Statusupdates vom ZSD ab. (mit SDKs) -
ZBP-Adapter entschlüsselt(mit SDKs) den Statusupdate und sendet den Statusupdate mit den SDKs an das ZBP. -
Es wird vom ZBP-Adapter ein accept/reject Event erstellt und mit den SDKs an den ZSD weitergeleitet (in Abhängigkeit von der Antwort des ZBP). - Sonstige Events entsprechen dem Event der Submission und werden ebenfalls am Case im Event-Log hinterlegt.
-
Statusupdates werden je Umgebung an die selbe DestinationID gesendet wie bei den ZBP-Nachrichten (Schlüsselbereitstellung) -
Löschfristen der Statusupdates an den Statusmonitor entsprechen den Löschfristen, welche an Submissions/ Replies geknüpft sind. -
ZBP Adapter, der ZBP Branch und die SDKs sind als Release Candidate auf einer eigenen Testumgebung veröffentlicht -
Webhooks und Callbacks sollten sich an den fachlichen Prozessen der Submission orientieren (fachlich aktuell kaum Bedarf ZBP-Adapter steht im NdB und kann eh nicht informiert werden, das ist bei künftigen Postfächern aber ggf. anders) -
Verständliche Dokumentation zur Nutzung der neuen Funktionen wurde erstellt. -
Ein Videotutorial zu den neuen Funktionen steht im SSP zur Verfügung. -
Definition of Done wurde überprüft.