This guide explains how to configure Auth0 to work with SAML Single Sign-On for Aircall. You will create a Single Page Application in Auth0, enable the SAML2 Web App addon, apply the required settings, and export the Identity Provider Metadata for Aircall.

Important: SAML Single Sign-On must be activated for your company by Aircall before you follow these steps. To request activation, contact our Customer Success team. At this time, this functionality is available only for a limited number of customers.

Create a Single Page Application

Steps:

  1. Open the Auth0 management console: https://manage.auth0.com/
  2. From the left navigation, expand Applications, then click Applications.
  3. Click Create Application.
  4. In the modal:
    • Enter a name, for example acme-saml@aircall.
    • Select Single Page Web Applications.
    • Click Create.

Configure SAML

Steps:

  1. On the Applications page, open your application, for example acme-saml@aircall.
  2. Go to the Addons tab.
  3. Switch on SAML2 Web App.
  4. In the Addon: SAML2 Web App modal, open the Settings tab.
  5. In Application Callback URL, enter:
    • https://sso.aircall.io/saml2/idpresponse

  6. In the Settings JSON editor, delete the existing content and paste the following:

    {
  "audience": "urn:amazon:cognito:sp:us-west-2_hZkGBmIsz",
  "mappings": {
    "email": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
  },
  "nameIdentifierFormat": "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
}
  7. Click Enable, then Save.
  8. Open the Usage tab and click Download under Identity Provider Metadata to export the XML file.
Note: The Application Callback URL and the Settings JSON must match exactly.

Export the metadata

Steps:

  1. Open your application, for example acme-saml@aircall.
  2. Go to the Addons tab and open SAML2 Web App.
  3. In the Addon: SAML2 Web App modal, choose one of the following:
    • Right-click Identity Provider Metadata download and copy the URL.
    • Click Download to save the Identity Provider Metadata .xml file.

For more information on SAML, please read more Aircall and SAML Authentication or our Customer Success team.