Skip to content

Alternative Fachdienstlokalisierung über zentralen gematik Dienst (C_12681_Anlage_2) #121

Merged
CSchmidtDD merged 16 commits intomainfrom
feature/service-discovery-alt
Apr 10, 2026
Merged

Alternative Fachdienstlokalisierung über zentralen gematik Dienst (C_12681_Anlage_2) #121
CSchmidtDD merged 16 commits intomainfrom
feature/service-discovery-alt

Conversation

@CSchmidtDD
Copy link
Copy Markdown
Contributor

@CSchmidtDD CSchmidtDD commented Mar 17, 2026

Es gibt ca. 9 Fachdienst VSDM 2 Betreiber, die von 94 gesetzliche Krankenkassen beauftragt werden bzw. in einer vertraglichen Beziehung mit diesen stehen. Die Vergangenheit hat gezeigt, dass es des öfteren vorkommt, dass Krankenkassen den Betreiber wechseln. Ein Primärsystem kennt auf Basis der IK-NR immer nur die die Krankenkasse zu einem bestimmten Patienten, jedoch nicht bei welchem Betreiber die Krankenkasse aktuell ist.

  1. Der ZETA-Client kann das protected resource metadata Dokument nicht standardkonform gemäß https://www.rfc-editor.org/rfc/rfc9728.html#name-protected-resource-metadata-v abrufen und verarbeiten, wodurch die VSDM-spezifischen ZETA-Konfiguratonen nicht ermittelt werden können.
  2. Anfragen am /authorize Endpunkt des AuthZ-Server resultieren aufgrund des Kostenträger-spezifischen claims "aud" in der Anfrage in Kostenträger-spezifische Access-Token. Dies führt zu n (mit n = Anzahl der Kassen) durch das Primärsystem zu verwaltende Access-Token, da der ZETA Client vom VSDM2 Client mit einem kompletten HTTP Request (mit genau einer URL == Audience) angefragt wird und auf Basis dessen ein Access- und Refresh-Token immer für die angeforderte Audience (Endpunkt des RS) und zugehörigem Scope ausgestellt wird.
  3. Anfragen an den /vsdmservice Endpunkt des Resource Server resultieren aufgrund des Kostenträger-spezifischen HOST Parameter im HTTP-Request des Primärsystem in ebenso Kostenträger-spezifische ASL-Kanäle. Dies führt bis zu n (mit n = Anzahl der Kassen) durch das Primärsystem zu verwaltende ASL-Kanäle bzw. ASL Schlüsselpaare, da ein ASL Kanal immer für einen bestimmten Host (== FQDN im CNAME) aufgebaut werden muss.

Der hier skizzierte Lösungsvorschlag sieht vor, dass die vollständige Fachdienstlokalisierung eines Clientsystems über einen eigens von der gematik angebotenen Endpunkt erfolgt. Dieser Endpunkt liefert eine, pro Betriebsumgebung konfigurierte, statische JSON-Datei (catalog.json) aus, welche die Verknüpfung von IK-Nummer zu Betreiber-FQDN für mandantenspezifische TI 2.0 Fachdienste (wie z.B. VSDM 2) beinhaltet. Dabei entfällt die derzeit bekannte Fachdienstlokalisierung mittels DNS.

Dabei werden weder Änderungen am ZETA-Guard, noch unmittelbar am Fachdienst VSDM 2 erforderlich. Die nachfolgend beschriebenen Änderungen erhöhen die Lesbarkeit der Spezifikation und erklären hauptsächlich die Fachdienstlokalisierung aus Sicht eines Clientsystems. Es finden weiterhin Maßnahmen und Anpassungen zur Qualitätssicherung statt.

Die Änderung basiert auf dem aktualisierten Vorabveröffentlichungspaket gemSpec_VSDM_2_V1.4.0_CC2

Dieser Pull Request löst den unter #113 Erstellten ab.

@CSchmidtDD CSchmidtDD self-assigned this Mar 17, 2026
Comment thread src/openapi/servicediscovery.yaml Outdated
Comment thread src/openapi/servicediscovery.yaml Outdated
Comment thread src/openapi/vsdm2.yaml Outdated
Comment thread src/openapi/vsdm2.yaml Outdated
Comment thread src/openapi/vsdm2.yaml Outdated
Comment thread src/openapi/vsdm2.yaml Outdated
Comment thread src/openapi/vsdm2.yaml Outdated
Comment thread src/openapi/vsdm2.yaml Outdated
Comment thread src/openapi/servicediscovery.yaml
Comment thread src/openapi/servicediscovery.yaml Outdated
Comment thread src/schemas/catalog.schema.json Outdated
Reflects schema version bump to 0.9.2 and updates the description with the latest modification date. Replaces the revision number field with a Unix timestamp in seconds for last generation at updated_at.
@CSchmidtDD CSchmidtDD marked this pull request as ready for review April 9, 2026 08:30
@CSchmidtDD CSchmidtDD added the documentation Improvements or additions to documentation label Apr 9, 2026
@CSchmidtDD CSchmidtDD added the enhancement New feature or request label Apr 9, 2026
@CSchmidtDD
Copy link
Copy Markdown
Contributor Author

Nach eingehender Review-Zeit und der Beantwortung aller ausstehender Kommentare wird der Pull-Request in Vorbreitung auf das Release abgeschlossen und gemerged.

@CSchmidtDD CSchmidtDD merged commit 3af9693 into main Apr 10, 2026
1 check passed
@CSchmidtDD CSchmidtDD deleted the feature/service-discovery-alt branch April 10, 2026 13:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants