Complete the following fields in the SAML Configuration section of the Add/Edit Identity Provider page:
Use XML Metadata file. Upload the metadata XML file from your SAML provider to configure the provider. This populates the Single Sign-On URL, Issuer, and Public Certificate fields.
This is the recommended way to populate these fields because it eliminates the need to match values between the SAML provider and AppGate ZTNA. Most SAML providers let you download metadata from their UI, or provide a dedicated URL for metadata. After you upload metadata, complete only Audience (and, optionally, Decryption Key).
To configure the provider manually, complete the following fields:
Audience. Audience URI. This value must exactly match the value in your SAML IdP settings under
.Assertion.Conditions.AudienceRestrictions[0].Audiences[0].AudienceURI.ForceAuthn. Enables the
ForceAuthnflag in the SAML request. If your SAML provider supports this flag, users must enter credentials each time the client requires SAML authentication.Public Certificate. The X.509 public key certificate that you download from your IdP. AppGate ZTNA uses it to verify that the SAML assertion is signed by the provider. The certificate must be used to create either the assertion signature in
Response > Assertion > Signature > SignatureValueor the token signature inResponse > Signature > SignatureValue. Paste the certificate contents into the dialog box, or click Choose a file and browse to the file.
NOTE
When certificates approach expiration, the Controller shows a dashboard warning 30 days in advance.
Decryption Key. Optional. Private PEM key used to decrypt encrypted assertions