SAML2-based backendΒΆ

Endpoint URL: /api-auth/saml2/

Valid request example:

POST /api-auth/saml2/ HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: example.com

{
    "saml2response": "SAML_PAYLOAD",
}

Success response example:

HTTP/1.0 200 OK
Allow: POST, OPTIONS
Content-Type: application/json
Vary: Accept, Cookie

{
    "token": "c84d653b9ec92c6cbac41c706593e66f567a7fa4"
}

Invalid token can result in a failure like in the example below. In this case please enable/check concrete problem in SAML2 log file.

HTTP/1.0 401 UNAUTHORIZED
Allow: POST, OPTIONS
Content-Type: application/json

{
    "saml2response": ["SAML2 response has errors."]
}