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

RelayState

string

N

The optional relay state that the API (service provider) sent to the identity provider.

SAMLResponse

string

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)

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 exampleedit

curl -XPOST https://{{hostname}}/api/v1/users/auth/saml/_callback \
-H "Authorization: ApiKey $ECE_API_KEY"