Skip to main content
Submit or View Requests
Deutsch Español (España) Français (France)

Configuring Okta for SAML Authentication

Kate G.
  • Updated

 

Please note: The instructions listed in this article are exclusively applicable to those who have had SAML Single Sign-On activated for their company by Aircall. To have SAML Single Sign-On activated for your company, please contact your Account Manager. Please note that, at this time, this functionality is only offered for a limited number of customers.

______________________________

 

Step 1: Create a SAML app integration

  1. Open the Okta Developer Console. (https://company.okta.com/admin/dashboad)
    From the navigation menu on the left-hand side, expand the Applications section, and then choose Applications.
  2. Click on Create App Integration.
  3. In the Create a new app integration modal, select SAML 2.0 as the sign-in method.
  4. Click on Next.

⚠️ Please note: you will not be able to access Aircall via the tile on the Okta dashboard, even after successful configuration. Please login at dashboard.aircall.io/login/sso or using the “Login with SSO” button on the Aircall app.


Step 2: Configure SAML integration for your Okta app

  1. On the Create SAML Integration page, under General Settings, enter a name for your app (e.g. acme-saml@company).
  2. (Optional) Upload a logo and choose the visibility settings for your app.
  3. Choose Next.
  4. Under the GENERAL section, enter the following values:
    • Single sign on URL: 
      https://sso.aircall.io/saml2/idpresponse
    • Audience URI (SP Entity ID): 
      urn:amazon:cognito:sp:us-west-2_hZkGBmIsz
  5. Under the ATTRIBUTE STATEMENTS section, add a statement with the following information:
    • Name: 
      http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
    • Name format: Leave it unspecified
    • Value: 
      user.email
  6. Click on Next.
  7. Use default values.
  8. Click on Finish.

Step 3: Assign People to your Okta app

  1. Click on acme-saml@company (the name used in the first step) Okta application
  2. Click on the Assignments tab
  3. Click on the Assign button to either assign the app to people or user groups to enable SAML authentication for Aircall

Step 4: Export the Metadata

  1. Click on acme-saml@company(the name used in the first step) Okta application
  2. Click on the Sign On tab
  3. Find the SAML Signing Certificates section
  4. Select the Active certificate and click on the Actions button
  5. Click on View IdP metadata - it will open a new browser tab
  6. Either use the URL or download the XML file as the metadata

For more information on SAML, please read more here or contact your Account Manager.

 

Related articles