gemSpec_SST_LD_BD_V1.0.1

Elektronische Gesundheitskarte und Telematikinfrastruktur

Spezifikation

Logdaten- und

Betriebsdatenerfassung

    

     

      
Version
      
1.0.1
     
     

      
Revision
      
548770
     
     

      
Stand
      
28.06.2019
     
     

      
Status
      
freigegeben
     
     

      
Klassifizierung
      
öffentlich
     
     

      
Referenzierung
      
gemSpec_SST_LD_BD
     
    

Dokumentinformationen

Änderungen zur Vorversion

Anpassungen des vorliegenden Dokumentes im Vergleich zur Vorversion können Sie der nachfolgenden Tabelle entnehmen.

Dokumentenhistorie

Inhaltsverzeichnis

1 Einordnung des Dokuments

1.1 Zielsetzung

Dieses Dokument enthält die Anforderungen an die Schnittstelle Logdaten- und Betriebsdatenerfassung. Über sie werden von den Clients (z.B. Konnektoren und Fachdienste) versendete Betriebsdaten empfangen.

1.2 Zielgruppe

Das Dokument richtet sich an Hersteller und Anbieter der Schnittstelle Logdaten- und Betriebsdatenerfassung sowie an die Hersteller der Clients (z.B. Konnektoren und Fachdienste).

1.3 Geltungsbereich

Dieses Dokument enthält normative Festlegungen zur Telematikinfrastruktur des Deutschen Gesundheitswesens für den Online-Produktivbetrieb (Stufe 2). Der Gültigkeitszeitraum der vorliegenden Version und deren Anwendung in Zulassungs- oder Abnahmeverfahren wird durch die gematik GmbH in gesonderten Dokumenten (z.B. Dokumentenlandkarte, Produkttypsteckbrief, Leistungsbeschreibung) festgelegt und bekannt gegeben.

Wichtiger Schutzrechts-/Patentrechtshinweis

Die nachfolgende Spezifikation ist von der gematik allein unter technischen Gesichtspunkten erstellt worden. Im Einzelfall kann nicht ausgeschlossen werden, dass die Implementierung der Spezifikation in technische Schutzrechte Dritter eingreift. Es ist allein Sache des Anbieters oder Herstellers, durch geeignete Maßnahmen dafür Sorge zu tragen, dass von ihm aufgrund der Spezifikation angebotene Produkte und/oder Leistungen nicht gegen Schutzrechte Dritter verstoßen und sich ggf. die erforderlichen Erlaubnisse/Lizenzen von den betroffenen Schutzrechtsinhabern einzuholen. Die gematik GmbH übernimmt insofern keinerlei Gewährleistungen.

1.4 Abgrenzungen

Spezifiziert werden in diesem Dokument die Anforderungen und das Verhalten der Schnittstellen Logdatenerfassung  [I_LogData] und  Betriebsdatenerfassung [I_OpsData_Update]. Daraus resultieren ebenfalls Abläufe in den Clients dieser Schnittstelle (z.B. den Konnektoren).

Für das Verständnis dieser Spezifikation wird die Kenntnis von [gemKPT_Arch_TIP] vorausgesetzt.

Dieses Dokument beschreibt für die über I_LogData gelieferten Daten nicht:

• die Weiterleitung der Daten zu einem Backendsystem und
• die Verarbeitung der Daten.

1.5 Methodik

Anforderungen als Ausdruck normativer Festlegungen werden durch eine eindeutige ID sowie die dem RFC 2119 [RFC2119] entsprechenden, in Großbuchstaben geschriebenen deutschen Schlüsselworte MUSS, DARF NICHT, SOLL, SOLL NICHT, KANN gekennzeichnet.

Sie werden im Dokument wie folgt dargestellt:
<AFO-ID> - <Titel der Afo>
Text / Beschreibung
[<=]

Dabei umfasst die Anforderung sämtliche zwischen Afo-ID und der Textmarke [<=] angeführten Inhalte.

2 Systemüberblick

In folgender Abbildung ist die Einbettung der Schnittstelle Logdatenerfassung [I_LogData] in die TI dargestellt.

Abbildung 1: Überblick Schnittstelle Logdatenerfassung

Nach Einwilligung des Leistungserbringers werden alle Logdaten des Konnektors periodisch pseudonymisiert und mit einigen Metadaten angereichert an [I_LogData] gesendet. Von dort werden sie weiter an ein Logdaten-Analyse-System gesendet. Die Einwilligungserklärung und die Widerspruchserklärung werden dem Konnektor über Operation I_LogData::getFile bereitgestellt.

Beispielablauf für den Konnektor:

1. Lokalisierung der Schnittstelle über DNS (A_17182)
2. Aufbau TLS-Verbindung (A_17108, A_17273)
3. Einwilligungserklärung laden durch Aufruf I_LogData::getFile mit Parameter LEI-ID (A_17172)
4. Statische Metadaten aus der Einwilligungserklärung senden durch Aufruf I_LogData::decIntent (A_17340)
5. Senden von Logdaten durch Aufruf I_LogData::fileUpload (A_17112)

Die Fachdienste und zentralen Dienste können ihre Betriebsdaten über die Schnittstelle Betriebsdatenerfassung I_OpsData_Update mit Operation [I_OpsData_Update]::fileUpload liefern. 

3 Schnittstelle I_LogData

Die Konnektoren liefern ihre Logdaten über die Schnittstelle Logdatenerfassung I_LogData. 

3.1 Transport Layer Security (TLS)

Die Schnittstelle I_LogData wird durch TLS abgesichert.

3.2 DNS Resource Record

Die Schnittstelle I_LogData stellt Funktionen bereit, die über URLs aufgerufen werden können.

Die "ldif"-DNS-Resource-Records werden von den Konnektoren zur Lokalisierung der Schnittstelle genutzt.

3.3 Willenserklärungen zur Konnektor-Logdatenerfassung

Der Leistungserbringer muss der Verarbeitung seiner Konnektor-Logdaten zustimmen. Zur Unterstützung dieses Prozesses wird die Einwilligungs- und Widerrufserklärung über die Schnittstelle I_LogData bereitgestellt. Weiterhin werden die statischen Metadaten (welche keine personenbezogenen Daten enthalten) aus der Einwilligungserklärung und die Widerrufserklärung vom Konnektor an die Schnittstelle gesendet.

Die Schnittstelle I_LogData erlaubt den Download von vordefinierten Dateien durch den Konnektor, die in diesem Kapitel definiert werden. Dazu gehören Dateien wie die Einwilligungserklärung und die Widerspruchserklärung für die Logdatenerfassung, welche durch den Leistungserbringer ausgefüllt werden müssen.

Der Zugriff auf Dateien, die von I_LogData-Clients mit HTTP POST bereitgestellt werden, ist nicht möglich.

3.4 Datei Upload

Hinweise:

• Wenn der Client testen möchte, ob er für die Lieferung von Dateien an die Schnittstelle Logdatenerfassung freigeschaltet wurde, kann er einen HTTP POST Request mit leerem/r Inhalt/Datei und seinem Nutzernamen im Authorization-Parameter senden. Erhält er als Antwort HTTP-Status-Code "401 Unauthorized", ist er nicht freigeschaltet.
• Der Client muss eindeutige Dateinamen für seine Dateien (bspw. durch Anhängen eines Zeitstempels, einer eindeutigen ID, o.ä.) sicherstellen.

4 Schnittstelle I_OpsData_Update

Die Fachdienste und zentralen Dienste liefern ihre Betriebsdaten (darunter fallen auch die Rohdaten) über die Schnittstelle Betriebsdatenerfassung I_OpsData_Update. 

4.1 Transport Layer Security (TLS)

4.2 DNS Resource Record

Die Schnittstelle I_OpsData_Update stellt Funktionen bereit, die über URLs aufgerufen werden können.

Die "fdrdif"-DNS-Resource-Records werden von den Fachdiensten und die "zdrdif"-DNS-Resource-Records von den zentralen Diensten zur Lokalisierung der Schnittstelle genutzt.

4.3 Datei Upload

Hinweise:

• Der Client muss eindeutige Dateinamen für seine Dateien (bspw. durch Anhängen eines Zeitstempels, einer eindeutigen ID, o.ä.) sicherstellen.

5 Anhang – Verzeichnisse

5.1 Abkürzungen

5.2 Glossar

Das Glossar wird als eigenständiges Dokument (vgl. [gemGlossar]) zur Verfügung gestellt.

5.3 Abbildungsverzeichnis

5.4 Tabellenverzeichnis

5.5 Referenzierte Dokumente

5.5.1 Dokumente der gematik

Die nachfolgende Tabelle enthält die Bezeichnung der in dem vorliegenden Dokument referenzierten Dokumente der gematik zur Telematikinfrastruktur. Der mit der vorliegenden Version korrelierende Entwicklungsstand dieser Konzepte und Spezifikationen wird pro Release in einer Dokumentenlandkarte definiert. Version und Stand der referenzierten Dokumente sind daher in der nachfolgenden Tabelle nicht aufgeführt. Deren zu diesem Dokument jeweils gültige Versionsnummer ist in der aktuellen, von der gematik veröffentlichten Dokumentenlandkarte enthalten, in der die vorliegende Version aufgeführt wird.

5.5.2 Weitere Dokumente