C_12520_Anlage_V1.0.0

Prereleases:

PDF HTML Excel XML
C_12520_Anlage_V1.0.0

C_12520_Anlage

Inhaltsverzeichnis

1 Änderungsbeschreibung

Konkretisierung des Fehlerhandlings nach zahlreichen Rückfragen aus der Implementierungsphase

Für das Parsen der Eingangsparameter wird nun einheitlich SMBS_0008 verwendet.

SMBS_0012 wird für die Base64-Dekodierung verwendet.

Als generischer Fehler für nicht aufgeführte Fehlersituationen wird SMBS_0006 verwendet.

2 Änderung in gemF_Personalisierung_HSM-B

Neue Abbildung unter A_25126-01 (https://wiki.gematik.de/spaces/EDGE/pages/689719552/Fehlerhandling+HSM-B )

Übersicht über das Fehlerhandling des SMB-Service für die HSM-B-Personalisierung

A_25110-01 - SMB-Service - Operation requestCSR wird abgelöst durch:

A_25110-02 - SMB-Service - Operation requestCSR

Das Zugangsmodul MUSS am SMB-Service die Operation requestCSR anbieten

Service Endpunkt <SMB-Service-URL>/requestCSR
Eingangsparameter
POST
Content-Type: application/json;charset=UTF-8
{
  "client_id": "<TSPName/Name aus TSL-Eintrag des Anbieters SMC-B>",
  "state": "<Antragsnummer>",
  "user": "<GatewayUserID>"
}

Verarbeitung
  1. Extrahiere TSPName/Name des Anbieter-SMB, Antragsnummer und GatewayUserID aus client_id, state und user (vgl. A_25121*)
  2. Prüfe ob das Tripel Anbieter-SMB, Antragsnummer, GatewayUserID bereits persistiert ist
  3. Löse Erstellung CSR-Paket im HSK aus und persistiere den Status CSR-creation-HSK. Wurde zu dieser Antragsnummer bereits eine CSR ausgelöst, wird kein neuer CSR ausgelöst und SMBS_001 zurückgemeldet.
  4. Rückmeldung an den Aufrufer
Rückgabe code: "SMBS_0001", message: "CSR-Erstellung im HSK ausgelöst"
Fehlermeldung zu 1. code:  "Fehler im Aufruf", code: "SMBS_0008"
zu 2. code: "SMBS_0005", message: "Nutzerauthentisierung notwendig"
sonst code: "SMBS_0006", message: "Fehler bei Verarbeitung"
[<=]

A_25112-01 - SMB-Service - Operation getCSR wird abgelöst durch:

A_25112-02 - SMB-Service - Operation getCSR

Das Zugangsmodul MUSS am SMB-Service die Operation getCSR anbieten

Service Endpunkt <SMB-Service-URL>/getCSR
Eingangsparameter POST
Content-Type: application/json;charset=UTF-8
{
  "client_id": "<TSPName/Name aus TSL-Eintrag des Anbieters SMC-B>",
  "state": "<Antragsnummer>",
  "user": "<GatewayUserID>"
}
Verarbeitung
  1. Extrahiere TSPName/Name des Anbieter-SMB, Antragsnummer und GatewayUserID aus client_id, state und user (vgl. A_25121*)
  2. Prüfe den Status für das Tripel Anbieter-SMB, Antragsnummer, GatewayUserID
  3. Rückmeldung an Aufrufer
Rückgabe

{
  "status": "ok",
  "code": "SMBS_0016",
  "message": "CSR erstellt",
  "csr": "BASE64-zip",
  "sig": "BASE64-sig"
 }

Fehlerfälle zu 1. Parameter nicht extrahierbar: message: "Fehler im Aufruf", code: "SMBS_0008"
zu 2. CSR wurde angefordert, liegt aber noch nicht vor. Retry notwendig: message: "CSR noch nicht erstellt", code: "SMBS_0007"
zu 2. Parameter sind nicht persistiert. Authentifizierung notwendig:  message: "Antragsnummer unbekannt", code: "SMBS_0009"
message: "GatewayUserID unbekannt", code: "SMBS_0010"
zu 2. Parameter sind persistiert, es wurde noch kein CSR angefordert: message: "CSR nicht vorhanden", code: "SMBS_0011"
sonst: message: "Fehler bei Verarbeitung", code: "SMBS_0006"
[<=]

A_25114-01 - SMB-Service - Operation loadCerts wird abgelöst durch:

A_25114-02 - SMB-Service - Operation loadCerts

Das Zugangsmodul MUSS am SMB-Service die Operation loadCerts anbieten

Service Endpunkt <SMB-Service-URL>/loadCerts
Eingangsparameter
POST:
Content-Type: application/json;charset=UTF-8
{
  "client_id": "<TSPName/Name aus TSL-Eintrag des Anbieters SMC-B>",
  "state": "<Antragsnummer>",
  "user": "<GatewayUserID>",
  "certs": "BASE64(Zertifikatspaket)"
}
Verarbeitung
  1. Extrahiere TSPName/Name des Anbieter-SMB, Antragsnummer und GatewayUserID aus client_id, state und user (vgl. A_25121*)
  2. Prüfe den Status für das Tripel Anbieter-SMB, Antragsnummer, GatewayUserID
  3. Lade Zertifikatspaket und vInstanz-Liste (A_25113*) in HSK
  4. Nach Erfolgreicher Rückmeldung vom HSK setze Status certs-loaded
  5. Rückmeldung an Aufrufer
Rückgabe message: "Zertifikate erfolgreich geladen", code: "SMBS_0017";
Fehler zu 1. Parameter nicht extrahierbar: message: "Fehler im Aufruf", code: "SMBS_0008"
zu 1. Base64 nicht dekodierbar:  message: "Zertifikatspaket nicht extrahierbar", code: "SMBS_0012"
zu 2. message: "Kein unbeantworteter CSR identifiziert", code: "SMBS_0013"
zu 3. message: "Keine virtuelle Instanz", code: "SMBS_0014"
zu 4. message: "Fehler vom HSK", code: "SMBS_0015"
sonst message:" Fehler in Verarbeitung", code: "SMBS_0006"
[<=]