Implementation Guide
TIFlow - Kernfunktionalitäten
Version 2.0.0-ballot.2 - ballot

Server-Anforderungen: Subscription

Seiteninhalt:

Diese Seite enthält die normativen Anforderungen an den TI-Flow-Fachdienst für den Subscription-Endpunkt.

POST /Subscription – Subscription registrieren

Sich.techn. Eignung: Produktgutachten Der TI-Flow-Fachdienst MUSS beim Aufruf der Http-POST-Operation auf die /Subscription Ressource die zeta-user-info.professionOID des Nutzers bestimmen und sicherstellen, dass ausschließlich Nutzer in der Rolle
  • oid_oeffentliche_apotheke
  • oid_krankenhausapotheke
  • oid_kostentraeger
die Operation am TI-Flow-Fachdienst aufrufen und bei Abweichungen die Operation mit dem folgenden Fehler:
HTTP-Code 403 - Forbidden
Severity error
Code invalid
Details Code TIFLOW_AUTH_ROLE_NOT_ALLOWED
Details Text Der Nutzer ist nicht berechtigt, die aufgerufene Operation anzufordern
abbrechen, damit eine Subscription nicht durch Unberechtigte registriert werden kann. funkt. Eignung: Test Produkt/FA Der TI-Flow-Fachdienst MUSS beim Aufruf der Http-POST-Operation auf die /Subscription Ressource durch eine abgebende Institution, diese anhand des zeta-user-info.identifier des Nutzers (Telematik-ID) identifizieren, diese gegen die in der Ressource im Element criteria Attribut receipient hinterlegte Telematik-ID prüfen und bei Ungleichheit die Operation mit dem folgenden Fehler:
HTTP-Code 403 - Forbidden
Severity error
Code invalid
Details Code SVC_IDENTITY_MISMATCH
Details Text Identity mismatch: Access token does not match FHIR data (Telematik-ID)
abbrechen, damit eine abgebende Institution ausschließlich für sich selbst eine Subscription registrieren kann. funkt. Eignung: Test Produkt/FA Der TI-Flow-Fachdienst MUSS beim Aufruf der Http-POST-Operation auf die /Subscription Ressource mit einem Response antworten, welcher eine Subscription Ressource mit
  • Pseudonym der Telematik-ID in id
  • aktueller Timestamp + 12 h in end
  • Bearer Token in Authorization
enthält. Sich.techn. Eignung: Produktgutachten Der TI-Flow-Fachdienst MUSS das Pseudonym mittels eines 128-Bit-AES-CMAC-Schlüssels erstellen und hexadezimal kodieren (32 Byte lang).

Hinweis: Vergleichend kann [gemSpec_Krypt]#A_20163 betrachtet werden.

Sich.techn. Eignung: Produktgutachten Der TI-Flow-Fachdienst MUSS den AES-CMAC-Schlüssel zur Pseudonymgenerierung regelmäßig mindestens alle 3 Monate ändern. Sich.techn. Eignung: Produktgutachten Der TI-Flow-Fachdienst MUSS für die Registrierung der Subscription einen Bearer-Token mit den Claims
  • subscriptionid: Pseudonym der Telematik-ID
  • iAt: Timestamp wann Subscription erstellt wurde
  • exp: Timestamp Ablauf der Subscription
erstellen und mit einer Identität des TI-Flow-Fachdienstes signieren (Signature Algortihm: ES256).

Subscription-Endpunkt (WebSocket)

funkt. Eignung: Herstellererklärung Der TI-Flow-Fachdienst MUSS eine Webschnittstelle anbieten, welche Websocket-Verbindungen mit einer Dauer von bis zu 12 h unterstützt. funkt. Eignung: Test Produkt/FA Der TI-Flow-Fachdienst MUSS an der Webschnittstelle des Subscription Service auf einen WebSocket-Upgrade-Request eines berechtigten Clients mit dem HTTP-Statuscode 101 Switching Protocols antworten. Sich.techn. Eignung: Produktgutachten Der TI-Flow-Fachdienst MUSS an der Webschnittstelle des Subscription Service beim Verbindungsaufbau prüfen, dass der Client einen zeitlich und kryptographisch gültigen Bearer-Token der Schnittstelle POST /Subscription übermittelt und bei nicht-erfolgreicher Prüfung die Verbindung mit dem folgenden Fehler:
HTTP-Code 403 - Forbidden
Severity error
Code invalid
Details Code SVC_INVALID_ACCESS_TOKEN
Details Text Invalid access token provided
ablehnen. funkt. Eignung: Test Produkt/FA Der TI-Flow-Fachdienst MUSS an der Webschnittstelle des Subscription Service sicherstellen, dass Verbindungen nach Überschreiten des Timestamp Ablauf der Subscription geschlossen werden. funkt. Eignung: Test Produkt/FA Der TI-Flow-Fachdienst DARF in der Verbindung zum Subscription Service anfallende Metadaten (Client-IP-Adresse, etc.) NICHT für eine unbefugte Profilbildung der verbundenen Clients verwenden.

Hinweis: Eine Verwendung zur Sicherung der Schnittstelle (DDoS-Schutz, Fehleranalyse in sehr eingeschränktem Maß) ist zulässig (im Sinne einer befugten Profilbildung).