Login to ECE

edit

IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Login to ECE

edit

Authenticates against available users.

Request

edit

POST /api/v1/users/auth/_login

Request body

edit

(LoginRequest) (required) The login request

Responses

edit

200

(TokenResponse)

302

(EmptyResponse)

Redirects to '/sso/token#BEARER_TOKEN?state=LOGIN_STATE' with the fragment containing a bearer token (if 'login_state.path' is specified)

401

(BasicFailedReply)

The supplied authentication is invalid. (code: root.unauthenticated)

Headers

x-cloud-error-codes (string; allowed values: [root.unauthenticated]): The error codes associated with the response

501

(BasicFailedReply)

The administrator needs to configure the authentication cluster. (code: authc.no_authentication_cluster)

Headers

x-cloud-error-codes (string; allowed values: [authc.no_authentication_cluster]): The error codes associated with the response

502

(BasicFailedReply)

The authentication cluster failed to process the request. The response body contains details about the error. (code: authc.authentication_cluster_error)

Headers

x-cloud-error-codes (string; allowed values: [authc.authentication_cluster_error]): The error codes associated with the response

Request example

edit

curl -XPOST https://{{hostname}}/api/v1/users/auth/_login \
-H "Authorization: ApiKey $ECE_API_KEY" \
-H 'Content-Type: application/json' \
-d '
{
   "login_state" : {
      "path" : "string"
   },
   "password" : "string",
   "username" : "string"
}
'

« Enable elevated permissions Logout from ECE »