NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.
Authenticate APIedit
The Authenticate API enables you to submit a request with a basic auth header to authenticate a user and retrieve information about the authenticated user.
Requestedit
GET _xpack/security/_authenticate
Descriptionedit
A successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.
If the user cannot be authenticated, this API returns a 401 status code.
Examplesedit
To authenticate a user, submit a GET request to the
_xpack/security/_authenticate
endpoint:
GET _xpack/security/_authenticate
The following example output provides information about the "rdeniro" user:
{ "username": "rdeniro", "roles": [ "admin" ], "full_name": null, "email": null, "metadata": { }, "enabled": true, "authentication_realm": { "name" : "default_file", "type" : "file" }, "lookup_realm": { "name" : "default_file", "type" : "file" } }