Login to ECEedit
Authenticates against available users.
Requestedit
POST /api/v1/users/auth/_login
Request bodyedit
(LoginRequest
) (required) The login request
Responsesedit
-
200
-
(
TokenResponse
) Login successful, returns the token in the body (if 'login_state.path' not specified) -
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
-
To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.
Request exampleedit
curl -XPOST https://{{hostname}}/api/v1/users/auth/_login \ -H "Authorization: ApiKey $ECE_API_KEY" \ -d ' { "login_state" : { "path" : "string" }, "password" : "string", "username" : "string" } '