Skip to content

Entwickler:innenreise / VIDEO

TASKS:

  • (OKT) Format für die Entwicklerreise festlegen - Hello World (Vorschlag Video/Youtube)
  • (NOV) 1. Video: SSP
  • (DEZ) 2. Video - Versand eines Antrags
  • (DEZ) 3. Video - Empfang eines Antrags
  • (DEZ) Veröffentlichung und Bereitstellung auf docs.fitko in erste Schritte

Anmerkungen hier eintragen: https://wiki.fit-connect.fitko.dev/de/Betrieb/SubmissionAPI/VideoTutorial

Entwicklerfehler:

  • #43 "Abkürzungen" - Token aus Beta7 verwenden, Destination nicht eingerichtet und dann dem Client nicht zugeordnet, Schlüsselgenerierung mit eigenen Tools)
  • #7 Geradeauseinrichtung optimierbar (Zuordnung Destination zu Client übersprungen)
  • Fehlernachstellen ohne Logging schwierig
  • #43, #7 SSP: Was fülle ich wie aus?(ggf. Hello World Beispiele) Fehlermeldungen frustrierend (Speziell Service - Leistungskatalog)
  • würde ich ignorieren: Schlüsselgenerierung (leider scheitert die Generierung der Schlüssel an folgendem Schritt „pip install jwcrypto“. Phyton (3.9.6) und pip (21.1.3) sind installiert.)
  • #44 Auswahl welche Schlüssel hochzuladen sind
  • #44 woher ist Client_Secret zu beziehen?
  • #44 Fehlermeldung "invalid_scope" weil dem client keine destination zugeordnet zu verdeutlichen
  • Sprint 9 - "Token not found" - Authentication statt Authorization angegeben in https://docs.fitko.de/fit-connect/docs/getting-started/sending/get-destination
  • Sprint 9 - JWT decoding error: Token-Validator Problem -> OpenSSL vs. LibraSSL, und weitere... -> Doku der benötigten Bibliotheken in Wiki-Betrieb aufnehmen
  • Sprint 9 - https://submission-api-testing.fit-connect.fitko.dev/submissions gibt immer OK und Startsteite von SSP
  • #7 https://submission-api-testing.fit-connect.fitko.dev/submissions "status": 500, "detail": "Scope send:region:DE+send:service: is invalid!" - Bei Einreichung komischer Fehler, da Scopes nicht richtig gepflegt
  • Sprint 9 - Polling - 11.0 statt 13.2 deployt - https://submission-api-testing.fit-connect.fitko.dev/submissions GET not supported
  • Sprint 9 - Status Abfragen - Access is denied
  • Sprint 9 - Antrag abholen - OK und Startseite SSP
  • Sprint 9 - x5c - Korrektur der Schlüsselgenerierung - SET kann nicht gesetzt werden

Zur Identifizierung von Handlungsbedarfen (auf Seiten FITKO) bis zum Go-Live sollen "Entwickler:innenreisen" für Hersteller von Fachverfahren und Onlinediensten erarbeitet werden. Die Entwickler:innenreisen können als Grundlage für die Inhaltserstellung des Entwicklungsportal zweitverwertet werden.

Entwickler:innenreise zur Anbindung eines Onlinedienstes an FIT-Connect

  • Einigung mit Herstellern von Fachverfahren auf Fachdaten-Schema (FIM oder XÖV)
    • Bilateral, im EfA Kontext oder irgendwie auf Gesetzesbasis / Beschlüsse
  • Entwickler (oder Verfahrensbetreiber) legt einen Account im Self-Service-Portal an (Merker: Welche Daten wollen wir. Unterscheiden wir zwischen Entwickler und Verfahrensbetreiber?)
    • Entwickler beantragt eine Rolle für eine bestimmte Infrastruktur (Test-/Prod)
      • (Entwickler authentifiziert sich)
    • Entwickler unterschreibt bzw. bestätigt Terms of Services (unterschiedlich zwischen Test- und Prod) und Unterschreibt einen AVV (nur für Prod relevant)
    • Mit dem Account wird ein OAuth Client registriert bzw. gemanaged fitko/architekturmanagement-standards/fit-connect/planning#28
      • Hinweis: Accountsystem stellt den initialen Access für den Registierungsendpunkt
      • Merker: Welche Clientdaten brauchen wird
  • Zuständigkeitsermittlung des zuständigen empfangenden Systems (via Routingdienst)
    • Welcher Zustelldienst ist zuständig?
    • Welche Destination-ID muss adressiert werden?
  • Onlinedienst ruft OAuth-Token beim OAuth-Server ab
    • anschließend ist der Onlinedienst in der Lage, auf die Zustelldienst-API zuzugreifen
  • Abruf der zum Zustellpunkt hinterlegten Daten beim zuständigen Zustelldienst
  • Zusammenstellung der für die Antragstellung benötigten Daten
    • Authentifizierung/Willensbekundung der Antragsteller:in
    • ggf. Zahlung der Antragsgebühren
    • Verschlüsselung Antragsdaten
    • Einrichtung Callback-URL
  • Antrag über Zustelldienst-APIs einreichen
  • Zustelldienst informiert über Callback bei Statusänderungen
    • OD ruft SET ab
    • OD prüft Signauren der SETs
    • Zertifikatsprüfung (OCSP)
  • Offene juristische Frage: Wann läuft die Frist zur Antragsbearbeitung durch die Verwaltung? D.h. was gilt als Posteingang? → Teillösung: Wir protokollieren alle Events im SET. Lösung: Wir müssen rechtlich klären, aber wann Fristen laufen und dies in die Nutzungsbedingungen reinschreiben.
    • RuC fragen
  • Bei Status ~~delivered~~ forwarded (Empfangsbestätigung durch Fachverfahren)
    • Zustelldienst löscht die Antragsdaten // Problem: Fachverfahren kann alle Anhänge nur genau 1x abholen. Was passiert, wenn Übertragung abbricht?
    • Bei Status Accepted (Bestätigung durch Fachverfahren, dass die Daten verarbeitet werden können. Bspw. konnte entschlüsselt werden und Fachdatensatz kann verarbeitet werden)
      • Antragsdienst löscht die Antragsdaten
    • Bei Status Rejected (z.B. Entschlüsselung unmöglich, Validierung des Fachdaten-Schemata nicht möglich, etc.)
      • Onlinedienst ist verantwortlich
        • A: Es kann auf Basis bestehender Daten gefixt werden. Onlinedienst schickt nochmal in korrekter Form (über gleiche ProcessRef?)...
        • B: Offene Frage: Kann der Antrag unkorrigierbar sein? Wenn ja, was dann?
          • Muss beim Zustelldienst-Betreiber Kontaktdaten des Fachverfahrens-Betreibers erfragen.
          • Alternative: Bei Reject immer Kontaktdaten senden. (Vorsicht: OD könnten bewusst fehlerhafte Anträge senden, um Kontaktdaten zu ermitteln)
    • [Test des Onlinedienstes in FIT-Connect-Testumgebung]
  • Betreiber
  • Offene Frage: Wie lange müssen SET vorgehalten werden? (Siehe RegMog Gesetz Protokollierungen)
  • ...

Entwickler:innenreise zur Anbindung eines Fachverfahrens an FIT-Connect

  • Einigung mit Herstellern von Fachverfahren auf Fachdaten-Schema (FIM oder XÖV)
  • Beantragung Account OAuth fitko/architekturmanagement-standards/fit-connect/planning#28
  • Beantragung Zertifikat V-PKI fitko/architekturmanagement-standards/fit-connect/planning#18
  • Eröffnung Zustellpunkt
    • Hinterlegung Destionation-ID in XZuFi (via FIM Redaktionssysteme)
    • Hinterlegung Zertifikat und Verbindungsparameter im Zustelldienst
  • ...
  • Entschlüsselung Antragsdaten
  • Prüfung Fachdatenschema
  • Prüfung Authentifizierung/Willensbekundung der Antragsteller:in
  • Anbindung Rückkanal
    • a) maschinenlesbar
    • b) nicht-maschinenlesbar (inkl. Notification an Antragsteller:in)
  • ...

Nicht betrachtet:

  • OSCI-Anbindung

@Carmen_Bickhard

Edited by Laura Elges