Zum Hauptinhalt springen

DVDV Error-Responses

3-stelliger HTTP-Response-Code​

Falls bei der Abarbeitung eines HTTP-Requests an der Directory-Schnittstelle ein Fehler passiert, so beantwortet der DVDV-Server diesen mit einer HTTP-Response. Diese enthält den üblichen, 3-stelligen HTTP-Response-Code, z.B. 404 (NOT_FOUND) oder 400 (BAD_REQUEST). Dieser eignet sich besonders für eine generische programmatische Fehlerbehandlung, auch durch Netzwerkinfrastruktur (wie Proxys) und Client-Bibliotheken.

RFC7807-konformer Error-Response-Body​

Neben diesem 3-stelligen HTTP-Response-Code enthält eine Error-Response i.d.R. einen Response-Body RFC7807-Format. Dieser RFC7808-konforme Response-Body eignet sich besonders zur programmatischen Verarbeitung im Rahmen einer DVDV-spezifischen Fehlerbehandlung. Die beiden DVDV-Bibliotheken (Java™ und .NET) konvertieren eine solche Error-Response in eine entsprechende Exception, sodass Sie die üblichen Sprachmittel zur programmatischen Verarbeitung einsetzen können.

Nachfolgend finden Sie eine Liste der vom DVDV-Server zurzeit verwendeten RFC7807 types:

  • AUTHENTICATION: Fehler bei der Authentifizierung, z.B. bei Standalone-Authentifizierung, wenn es keine Organisation gibt, an der ein passendes Client-Zertifikat hinterlegt ist.
  • AUTHORIZATION: Dieser technische Fehler tritt auf, wenn die Authentifizierung gelungen ist, aber keine ausreichenden Rechte liefert.
  • UNEXPECTED: Ein unerwarteter Fehler. Residual-Typ.
  • ENTITY_NOT_FOUND: Die fachliche Entität (Organisation, Dienst o.ä.) wurde nicht gefunden.
  • PATH_NOT_FOUND: Der URL-Pfad konnte nicht aufgelöst werden, etwa aufgrund eines Konfigurationsfehlers.
  • OBSOLETE_PATH: Der URL-Pfad war früher erlaubt, aber jetzt nicht mehr.
  • INPUT_VALIDATION: Ein fachlicher Fehler, der in der Kernsystem-seitigen Validierung der Request-Parameter aufgetreten ist.
  • JSON_PROCESSING: Fehler beim Parsen von JSON.
  • UNRECOGNIZED_PROPERTY: Vergleichbar zu JSON_PROCESSING
  • SERVICE_VALIDATION: Vergleichbar mit INPUT_VALIDATION

Eine menschenlesbare Erläuterung zu den betroffenen RFC7807 types liefert den DVDV-Server selbst. Z.B. können Sie mit <DVDV-SERVER>/dvdv2-backend/problems/type/ENTITY_NOT_FOUND eine Beschreibung des RFC7807 types ENTITY_NOT_FOUND abrufen.

4-stelliger DVDV-Errorcode​

Eine Error-Response des DVDV-Servers enthält außerdem meist einen Fehlermeldungstext. Dieser beginnt meist mit einem weiteren, 4-stelligen, DVDV-spezifischen Fehlercode. Dieser Code eignet sich weniger zu programmatischen Fehlerbehandlung. Der Vergabe dieser Errorcodes liegt folgende Systematik zugrunde:

  • 5000-5099: Fachliche Fehler im Umfeld von Organisationen und Diensten (seit DVDV 1.x)
  • 6000-6099: Fachliche Fehler im Umfeld von Zerfikaten (seit DVDV 1.x)
  • 7000-7099: Fehler im Umfeld von Directoryrequestparameteranalyse (seit DVDV 2.18)
  • 8000-8099: Fehler im Umfeld von Authentifizierung (seit DVDV 2.18)
  • 9000-9999: sonstige Fehler, nicht mehr genutzt seit DVDV 1.x

Nachfolgend finden Sie eine Liste der vom DVDV-Server zurzeit verwendeten Fehlercodes:

  • 5004: Kein gültiger Dienst zum Organisationsschlüssel ...
  • 5005: Kein Dienst zum Organisationsschlüssel ...
  • 5006: Mehrere gültige Dienste gefunden zum Organisationsschlüssel ...
  • 5009: Keine Organisation mit Kategorie ... und Organisationsschlüssel ... gefunden
  • 5010: Mehrere ... Organisationen mit Kategorie ... und Organisationsschlüssel ...
  • 6001: Kein Zertifikat gefunden für fingerPrint
  • 6002: Mehrere ... Zertifikate gefunden für fingerPrint ...
  • 6003: Zertifikat gefunden für fingerPrint ..., aber Fehler beim Parsen: ...
  • 7001: Die Batch-Länge ... übersteigt die maximale Batch-Länge ...
  • 7002: Parameter ... fehlt
  • 7003: Die Parameter ... und ... dürfen nicht kombiniert werden.
  • 7004: ServiceSpecificationType nicht erkannt: ...
  • 7005: Veralteter Einstiegspfad: ... . Nutzen Sie stattdessen: ...
  • 7006: Fehler bei JSON-Konvertierung für URL-Query-Parameter request_json: ...
  • 7007: JSON-Konvertierung gescheitert für URL-Query-Parameter request_json='...'
  • 7008: HTTP-Methode nicht erlaubt; erlaubte HTTP-Methoden: ...
  • 7009: Schlechter Request: ...
  • 8001: Konnte HTTP-Request nicht ermitteln
  • 8002: Kein Zugriff auf Authorization-Header
  • 8003: Kein Authorization-Header
  • 8004: Kein EmbeddedBearer-Token im Authorization-Header
  • 8005: Token nicht aktiv um ... (Serverzeit): ..., Grund: ...
  • 8006: Token-Signature ungültig: ..., Grund: ...
  • 8007: Nicht verifizierbar: ..., Grund: ...
  • 8008: Gescheitert: ..., Grund: ...
  • 8009: Erforderlicher Parameter 'client_assertion' fehlt.
  • 8010: Fehler beim Parsen der client_assertion: ...
  • 8011: Veraltetes Subject-Format: '...', ...
  • 8012: Unpassendes Subject-Format: '...' passt nicht zu ...
  • 8013: Kein passendes Client-Zertifikat gefunden für fingerprint ...
  • 8014: client_assertion-Token nicht aktiv um ... (Serverzeit): ...