Custom SAML 2.0/ADFS

If you haven't read our first article about SAML, we recommend you to check out this article right here prior reading this one. 

We are currently working with two main SAML providers: OKTA and OneLogin but we also offer you the option to custom SAML 2.0 with the provider of your choice. Here is how!


Step 1: Get the data

You have two options to get the data in order to set up your custom SAML SSO.

  • SP ( metadata:

You can get the metadata of from this URL: https://<YOUR_DOMAIN>

  • Assertion Consumer Service URL

SSO post-back up URL - https://<YOUR_DOMAIN> (Also known as the Assertion Consumer Service URL)

Entity ID - https://<YOUR_DOMAIN>


Step 2: Attributes to be included in IDP response

  • NameID (Required)


<saml:NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-format:persistent" NameQualifier="" SPNameQualifier="">Your Unique Identifier</saml:NameID>




<saml:NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-format:emailAddress" NameQualifier="" SPNameQualifier="">Your Unique Identifier</saml:NameID>


  • Email Attribute (Required)

<saml:Attribute Name="Email"


<saml:AttributeValue xsi:type="xs:anyType">[email protected]




  • First Name Attribute (Required)

<saml:Attribute Name="FirstName"


<saml:AttributeValue xsi:type="xs:anyType">FirstName



  • Last Name Attribute (Required)

 <saml:Attribute Name="LastName"


<saml:AttributeValue xsi:type="xs:anyType">LastName




Step 3: Certificates requires that the SAML response is signed, and you will need to paste a valid X.509.pem Certificate to verify your identity. This is different from your SSL certificate.  


Step 4: Provisioning

By default uses just in time provisioning, meaning the user is create in upon first login if he does not exist

If you wish to enable full provisioning, please generate the token, and follow your IDP instructions to enable this. supports IDP Initiated Flow or SP Initiated Flow


Fig1. - SAML token generator.


If you have any further questions about setting up SSO with, feel free to reach out to our customer success team anytime right here







Was this article helpful?
2 out of 4 found this helpful