Dokumentation Anbindungsleitfaden auf docs.fitko.de/fit-connect

Warum?

Um einen schnellen ersten Überblick zu geben, was zur Anbindung an FIT-Connect wichtig ist, soll ein Anbindungsleitfanden erstellt werden. Der Leitfaden richtet sich nicht an Softwareentwickler:innen, sondern an Umsetzungsverantwortliche und Betreiber:innen von Onlinediensten und Fachverfahren

Relevante Links und Bemerkungen

Akzeptanzkriterien

  1. Der Anbindungsleitfaden beschreibt alle Schritte zur Anbindung getrennt nach Zielgruppe
  2. Der Anbindungsleitfaden ist über die Startseite der Dokumentation gut auffindbar.

Einzelschritte

  1. Das Prozessschaubild "Anbindungs-Prozess für Online-Dienste" ist in Cawemo modelliert und optimiert.
  2. Das Prozessschaubild "Anbindungs-Prozess für Fachverfahren" ist in Cawemo modelliert und optimiert.
  3. Das Prozessschaubild für Online-Dienste wurde in der Doku mit beschreibneden Text ergänzt.
  4. Das Prozessschaubild für Fachverfahren wurde in der Doku mit beschreibenden Text ergänzt.

Inhalte

  • Für (EfA-)Onlinedienste:
    • Festlegung Leistungsschlüssel (LeiKa)
      • Besondere Relevanz im EfA-Kontext
      • Sicherstellen, dass die zu nutzenden Antragsleistungen im LeiKa eingetragen sind
      • Aktuell sind Routing Funktionen noch auf LeiKa Leistungen beschränkt
    • Prüung des Zuständigkeitsmechanismus: Auf Basis der Leistung (LeiKa-ID) + geographische Angabe (z.B. ARS) möglich?
      • Weitere Zuständigkeitskriterien (z.B. Anfangsbuchstabe Nachname, Geburtsdatum, etc.)?
    • Einigung auf das Fachdaten-Schema mit Verantwortlichen von Onlinediensten und Fachverfahren (FIM-Stammdatenschema oder XÖV-Standard)
      • FIT-Connect ermöglicht eine einfache Nutzung von FIM basierten Antragsformaten, aber übernimmt selbst keine fachliche Standardisierung
    • Klärung Authentifizierung/Willensbekundung der Antragsteller:in
      • Erforderliches Authentifizierungslevel (STORK-Level)
      • Technische Standards des genutzten Authentifizierungsdienstes (Servicekontos)
    • Technische Umsetzung der Anbindung in der Testumgebung
      • Registrierung von Clientzugängen für die Testumgebung
      • Anbindung der Software an FIT-Connect und Validierung der API-Umsetzung in der Testumgebung
      • Verweis auf "Getting started"
    • Produktivsetzung
      • Abschluss Nutzungsvereinbarung mit FITKO
  • Für nachnutzende Fachverfahren / empfangende Systeme:
    • Informationen zum genutztem Leistungsschlüssel (LeiKa), Fachdaten-Schema & notwendigen Prüfungen der Authentifizierung/Willensbekundung bei (EfA-)Onlinedienst-Betreiber einholen (Anmerkung: Hier sollten wir im Projekt unterstützung anbieten, z.B. durch Statistiken/Infos, welche Schemata durch welchen Onlinedienst genutzt werden)
    • Technische Umsetzung der Anbindung in der Testumgebung (s.o.)
    • Produktivsetzung
      • Abschluss Nutzungsvereinbarung mit FITKO
      • Beschaffung von Verschlüsselungszertifikaten aus der DOI-CA
      • Pflege der Zuständigkeitsinformation in FIM-Redaktionssytem (Hinterlegung der Destination-ID)

PO-Abnahme durch Hauke per Mail am 17.10.2022

Edited by Michael Haidner