Authenticate using configured HTTP request headers.

GET 
/api/v1/auth/header

Reads credentials and connection metadata from configured request headers. The default header names are documented as parameters; they can be changed through the Nauthilus runtime configuration.

Request

Responses

200

Header-mode authentication result. Successful requests return headers such as Auth-Status, Auth-User, X-Nauthilus-Session, and dynamic X-Nauthilus-* attribute headers.

Response Headers

Auth-Status
Auth-User
X-Nauthilus-Memory-Cache
X-Nauthilus-Session

400

Invalid JSON or request validation failure.

401

Authentication is missing or invalid.

403

Header-mode authentication failure. The response body is JSON null; Auth-Status carries the status message.

Response Headers

Auth-Status
Auth-Wait
X-Nauthilus-Session

404

Resource was not found.

500

Error response.