| Vorabinformation zum Änderungseintrag:
Folgende Änderungen sind Bestandteil des Änderungseintrages:
Hinweise zur Lesart: Text, der zur Erklärung der Änderung dient - wird nicht mit eingearbeitet/übernommen. Text, der neu ist oder aktualisiert wurde. Text, der entfernt wird. |
Die Produkttypen "TSL-Dienst", "gematik Root-CA" und "TSP X.509 Komp" werden den Anforderungen zum Senden und Erkennen eines TI-User-Agent zugewiesen.
A_27783 - User-Agent - Senden eines User-Agents (Zentrale Dienste der TI)
Der Produkttyp MUSS in allen HTTP-Requests an die in "Tab_gemSpec_Perf_UserAgent_Dienste" aufgeführten Schnittstellen der Produkttypen ein zusätzliches Header-Feld namens "TI-User-Agent" im Format <Client-ID>/<Version> erstellen und wie folgt befüllen:
Tabelle 1: Tab_gemSpec_Perf_UserAgent_Dienste
| PDT-ID | Produkttyp | Schnittstellen |
|---|---|---|
| PDT02 | TSP X.509 QES | I_OCSP_Status_Information |
| PDT03 | TSP X.509 nonQES - eGK | I_OCSP_Status_Information |
| PDT04 | TSL-Dienst | I_OCSP_Status_Information
I_BNetzA_VL_Download I_TSL_Download |
| PDT22 | gematik-Root-CA | I_OCSP_Status_Information |
| PDT36 | TSP X.509 nonQES - HBA | I_OCSP_Status_Information |
| PDT37 | TSP X.509 nonQES - Komponenten | I_OCSP_Status_Information
I_CRL_Download |
| PDT38 | TSP X.509 nonQES - SMC-B | I_OCSP_Status_Information |
Zuweisen zu Prüfverfahren "funkt. Eignung: Test Produkt/FA" - TSL-Dienst, gematik Root-CA, TSP X.509 Komp
A_26182-01 - User-Agent - Erkennung des eingesetzten Clientsystems
Der Produkttyp MUSS das vom aufrufenden Nutzer verwendete Clientsystem anhand des im HTTP-Request enthaltenen Header-Feld "TI-User-Agent" erkennen und in den Einträgen zur Betriebsdatenerfassung gemäß [gemSpec_Perf] erfassen. Findet eine VAU-Kommunikation statt, so ist vorrangig der User-Agent des inneren HTTP-Requests zu erfassen. [<=]
Zuweisen zu Prüfverfahren "funkt. Eignung: Test Produkt/FA" - TSL-Dienst, gematik Root-CA, TSP X.509 Komp
A_26183-01 - User-Agent - Format
Der Produkttyp, welcher gem. [A_26182-*] das HTTP Header-Feld "TI-User-Agent" erkennt, MUSS dieses ausschließlich in folgendem Format akzeptieren:
<Client-ID>/<Version>
Zuweisen zu Prüfverfahren "funkt. Eignung: Test Produkt/FA" - TSL-Dienst, gematik Root-CA, TSP X.509 Komp
Von der Anforderung A_26184-01 wird eine neue Version erstellt und die Formulierung so angepasst, dass die Anfrage bei Verstößen des TI-User-Agents gegen die Regular Expression nicht abgelehnt wird. Die Anfrage soll weiterhin bearbeitet werden und lediglich der TI-User-Agent soll in den Betriebsdaten nicht sondern anstelle dessen der Wert "invalid" protokolliert werden:
A_26184-02 - User-Agent - Reporting im Fehlerfall
Der Produkttyp MUSS das HTTP Header-Feld "TI-User-Agent" auf die folgenden gültigen Zeichen überprüfen und bei Verstößen die Anfrage mit einem Error Code gem. [A_26185-*] ablehnen anstelle des HTTP Header-Feldes "TI-User-Agent" den Wert "invalid" protokollieren. Das HTTP Header-Feld "TI-User-Agent" MUSS dem folgenden regulären Ausdruck entsprechen, damit eine entsprechende Code-Injection ausgeschlossen werden kann:
[\w\-]{3,20}\/[\w\.\-]{3,20}
Wird das bemängelte HTTP Header-Feld "TI-User-Agent" aufgrund mangelnder Konformität mit den benannten regulären Ausdruck nicht protokolliert, so ist entsprechend der Regelungen zur Betriebsdatenlieferung der Wert "invalid" zu protokollieren und zu übertragen. [<=]
Zuweisen zu Prüfverfahren "funkt. Eignung: Test Produkt/FA" - TSL-Dienst, gematik Root-CA, TSP X.509 Komp
Es wird eine neue Version der AFO A_23725-03 erstellt, damit der TI-User-Agent in den Betriebsdaten berücksichtigt wird:
A_23725-04 - Performance - Betriebsdatenlieferung v2 - Spezifika TSP X.509 nonQES – Komp - Message
Der Produkttyp TSP X.509 nonQES – Komp MUSS bei Betriebsdatenlieferungen im "message"-Feld die folgenden Daten im JSON-Format übermitteln:
{ "prot": "$protocol", "res": "$result", "zert": "$zertifikatstyp", "cc": $certCount, "ip": "$IP-Adresse", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" }
Die Tabelle "Tab_gemSpec_Perf_Berichtsformat_TSP_X.509_nonQES_Komp" wird entsprechend den Änderungen aus A_24171-04 aktualisiert:
Tabelle 2: Tab_gemSpec_Perf_Berichtsformat_TSP_X.509_nonQES_Komp
| Operation / Usecase
|
Aufgerufene Schnittstelle::Operation | Message |
|---|---|---|
| TSPK_1 | I_OCSP_Status_Information::check_Revocation_Status (TI) | { "prot": "$protocol", "res": "$result", "zert": "$zertifikatstyp", "ip": "$IP-Adresse", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" }
|
| TSPK_2 | I_OCSP_Status_Information::check_Revocation_Status (Internet) | { "prot": "$protocol", "res": "$result", "zert": "$zertifikatstyp", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" }
|
| TSPK_3 | I_CRL_Download::download_CRL
|
{ "prot": "$protocol", "cid": "$clientID", "ver": "$version" }
|
| TSPK_4 | I_Cert_Provisioning::provide_Certificate (SOAP / CMP)
|
{ "prot": "$protocol", "cc": $certCount }
|
| TSPK_5 | I_Cert_Provisioning::provide_Certificate (WEB Benutzerschnittstelle)
|
{ "prot": "$protocol", "cc": $certCount }
|
| TSPK_6 | I_Cert_Revocation::revoke_Certificate (SOAP / CMP)
|
{ "prot": "$protocol", "cc": $certCount }
|
| TSPK_7 | I_Cert_Revocation::revoke_Certificate (WEB Benutzerschnittstelle)
|
{ "prot": "$protocol", "cc": $certCount }
|
Es wird eine neue Version der AFO A_24171-03 erstellt, damit der TI-User-Agent in den Betriebsdaten berücksichtigt wird:
A_24171-04 - Performance - Betriebsdatenlieferung v2 - Spezifika TSL-Dienst - Message
Der Produkttyp TSL-Dienst MUSS bei Betriebsdatenlieferungen im "message"-Feld die folgenden Daten im JSON-Format übermitteln:
{ "prot": "$protocol", "res": "$result", "url": "$usedURL", "ip": "$IP-Adresse", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" }
Die Tabelle "Tab_gemSpec_Perf_Berichtsformat_TSL-Dienst" wird entsprechend den Änderungen aus A_24171-04 aktualisiert:
Tabelle 3: Tab_gemSpec_Perf_Berichtsformat_TSL-Dienst
| Operation / Usecase
|
Aufgerufende Schnittstelle::Operation | Duration | Message |
|---|---|---|---|
| TSL_1 | I_OCSP_Status_Information::check_Revocation_Status (TI) | Die Messung der Bearbeitungszeit beginnt mit der Annahme der Nachricht durch den OCSP Responder des TSL-Dienstes und endet mit dem Versand der Antwort an den Client.
|
{ "prot": "$protocol", "res": "$result", "ip": "$IP-Adresse", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" }
|
| TSL_2 | I_OCSP_Status_Information::check_Revocation_Status (Internet) | { "prot": "$protocol", "res": "$result", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" } }
|
|
| TSL_3 | I_TSL_Download::get_Hash (TI)
|
Die Messung der Bearbeitungszeit beginnt mit der Annahme der Nachricht durch den TSL-Dienst und endet mit dem Versand des letzten Bytes der Antwortnachricht.
|
{ "url": "$usedURL", "ip": "$IP-Adresse", "cid": "$clientID", "ver": "$version" } }
|
| TSL_4 | I_TSL_Download::download_TSL (TI)
|
||
| TSL_5 | I_BNetzA_VL_Download::get_Hash | { "url": "$usedURL", "cid": "$clientID", "ver": "$version" } }
|
|
| TSL_6 | I_BNetzA_VL_Download::download_VL | ||
| TSL_7 | I_TSL_Download::get_Hash (Internet)
|
||
| TSL_8 | I_TSL_Download::download_TSL (Internet) | ||
| TSL_9 | I_TSL_Download::download_TSL (Notfall) |
Es wird eine neue Version der AFO A_24167-02 erstellt, damit der TI-User-Agent in den Betriebsdaten berücksichtigt wird:
A_24167-03 - Performance - Betriebsdatenlieferung v2 - Spezifika gematik Root-CA - Message
Der Produkttyp gematik Root-CA MUSS bei Betriebsdatenlieferungen im "message"-Feld die folgenden Daten im JSON-Format übermitteln:
{ "prot": "$protocol", "res": "$result", "cn": "$commonName", "rs": "$responseStatus", "cid": "$clientID", "ver": "$version" } }