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: ...