New Ory Agent Security is now live! Claim your complimentary test drive. Get Started!

Skip to main content

Native SAML Assertion Consumer Service (ACS)

POST 

/self-service/methods/saml/acs/:provider

This is the Assertion Consumer Service (ACS) for the native SAML engine. The identity provider delivers its SAML Response here via the HTTP-POST binding, carrying the RelayState token that correlates it with the AuthnRequest issued by the init endpoint. On success the browser is redirected to complete the login, registration, or settings-link flow that started the sign-in.

This endpoint is posted to directly by the identity provider's browser and is NOT INTENDED to be called by API clients.

Every failure -- a replayed or unknown token, a malformed request, a provider mismatch, a response delivered to a browser other than the one that started the flow, or a signature/assertion validation failure -- is reported with the identical generic error, so the response body cannot be used to probe which check failed.

SDK ReferenceTypeScript
submitSamlAssertion()
ParametersTypeRequiredDescription
providerstringrequiredThe SAML connection ID this assertion is delivered for.
relayStatestringrequiredThe opaque token that correlates this response with the AuthnRequest issued by `POST /self-service/methods/saml/init/{provider}`. The PascalCase property name deliberately violates this API's snake_case convention: `RelayState` is the literal form-field name mandated by the SAML 2.0 HTTP-POST binding (OASIS SAML bindings spec), and every identity provider posts exactly this name. Do not rename it.
sAMLResponsestringrequiredThe base64-encoded, XML-serialized samlp:Response the identity provider produced for the AuthnRequest issued by `POST /self-service/methods/saml/init/{provider}`. The PascalCase property name deliberately violates this API's snake_case convention: `SAMLResponse` is the literal form-field name mandated by the SAML 2.0 HTTP-POST binding (OASIS SAML bindings spec), and every identity provider posts exactly this name. Do not rename it.
VariableType
dataErrorGeneric