SAML callbackedit
Accepts a callback request from an identity provider and authenticates the user.
Requestedit
POST /api/v1/users/auth/saml/_callback
Form Parametersedit
| Name | Type | Required | Description |
|---|---|---|---|
|
|
N |
The optional relay state that the API (service provider) sent to the identity provider. |
|
|
Y |
A message issued by the identity provider to the service provider |
Responsesedit
-
302 -
(
EmptyResponse) Redirects to the UI endpoint with an authorization token in the fragment and the relay state, if it was specified during the initialization. -
401 -
(
BasicFailedReply) The supplied SAML response is invalid. (code:root.unauthenticated)Headers
-
x-cloud-error-codes(string; allowed values: [root.unauthenticated]) - The error codes associated with the response
-
-
501 -
(
BasicFailedReply) You need 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 {{hostname}}/api/v1/users/auth/saml/_callback \
-H "Authorization: ApiKey $ECE_API_KEY"