Error codes

LdapAuth returns an error code with a message if the JSON-RPC 2.0 request failed for some reason.

The error codes fall into three ranges according to their category:

Here is an example JSON-RPC 2.0 response that reports an -2000 error:

{ "error"   : { "message" : "Bad username/password",
                "code"    : -2000 },
  "id"      : "0001",
  "jsonrpc" : "2.0" }

The exact format of error responses is described in the JSON-RPC 2.0 specification.

LdapAuth keeps error messages deliberately concise. To obtain more information about the cause of an error examine the LdapAuth log file (logging must be enabled at INFO level).

User authentication and provisioning exceptions

This section lists JSON-RPC 2.0 errors indicating user authentication and attribute provisioning exceptions, such as LDAP directory exceptions.

Access denied messages

This section lists JSON-RPC 2.0 errors indicating the client was denied access to LdapAuth, e.g. due to a blocked client IP address.

JSON-RPC 2.0 specific errors

Errors with codes between -32000 and -32768 are reserved by the JSON-RPC 2.0 specification to indicate a general protocol exception.