Saml2 (Section)#

Path: /profiles/profile/settings/authentication-service/authenticators/authenticator/saml2

Parameters#

NameTypeRequiredDefaultDescription
issuer-entity-idstringrequired-The SAML Entity Id that the authenticator uses when communicating with the remote SAML IDP.
clock-skewuint32optional60The allowed clock-skew in seconds when validating the inbound response message
include-subject-with-requested-authn-contextbooleanoptionalfalseIf there is a previously authenticated subject, pass the subject in the AuthnRequest to the SAML Identity Provider.
force-authnenumeration (always, if-requested-by-client)optional-Setting controlling sending of ForceAuthn=true parameter. By default, it is not sent; this overrules the forceAuthN parameter of the request or the configuration of forced re-authentication on a client.
idp-entity-idstringrequired-The SAML Entity Id of the remote SAML IDP
idp-urlstringrequired-The target IDP URL where SAML Authentication Requests are delivered to.
acs-url-overridestringoptional-The Assertion Consumer Service URL as configured on the IdP - the IdP will send the SAML authentication response to this URL. This setting doesn’t change the real ACS URL of this authenticator. Authorization responses have to be relayed to the real ACS URL of this authenticator.
signature-verification-keyleafref → /base:facilities/base:crypto/base:signature-verification-keys/base:signature-verification-key/base:idoptional-The key to verify the signature of received SAML Response messages. When no key is configured and signed SAML messages are received, then the messages will be rejected.
secondary-signature-verification-keyleafref → /base:facilities/base:crypto/base:signature-verification-keys/base:signature-verification-key/base:idoptional-The secondary key to verify the signature of received SAML Response messages. This key is only used when verification using the signature-verification-key fails.
wants-response-signedbooleanoptionalfalseIndicate whether the received SAML Response message must be signed.
wants-assertion-signedbooleanoptionaltrueIndicate whether the received Assertion must be signed.
require-audience-restrictionbooleanoptionaltrueIndicate whether the received Assertion must contain an AudienceRestriction condition naming this authenticator’s issuer-entity-id (as required by the SAML 2.0 Web Browser SSO Profile §4.1.4.3). When true (the default), an Assertion without an AudienceRestriction is rejected; set this to false only to accommodate Identity Providers that do not emit an AudienceRestriction. In either case, when an AudienceRestriction is present its Audience values must include the issuer-entity-id.
request-signing-keyleafref → /base:facilities/base:crypto/base:signing-keys/base:signing-key/base:idoptional-Optional reference to the signing key that is used to sign outbound SAML AuthnRequest messages. If not configured, signing AuthnRequests is disabled.
request-bindingenumeration (redirect, post)optionalredirectThe binding to use to send the SAML AuthnRequest message to the IDP
assertion-decryption-keyleafref → /base:facilities/base:crypto/base:decryption-keys/base:decryption-key/base:idoptional-The key to decrypt encrypted assertions from the SAML Response. When this is set, an encrypted assertion is required.

Subsections#

NameTypeDescription
authentication-context-class-reference SectionThe Authentication Context Class Reference (ACR) values to be included in the SAML Authentication Request.
request-options SectionOptional settings to finetune how a SAML Authentication Request message is constructed.
use-artifact-binding SectionWhen enabled Assertion Consumer Service expects to receive the authentication response through the artifact binding

Was this helpful?