Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Flex SSO URL Migration Guide


(warning)

Warning

We have deprecated the preview.twilio.com SSO URL. This guide will explain how to migrate to the iam.twilio.com SSO URL.

This guide will show you how to modify your SSO configuration on both your Identity Provider and Twilio so that you can authenticate users and enable Single Sign-On with the iam.twilio.com SSO URL. If you haven't configured SSO for your Flex instance, please see our Configuring Single Sign-on and Identity Provider integration guide.

Single Sign-On for Flex is now Generally Available and we have updated the SSO URL from https://preview.twilio.com/iam/Accounts/<YOUR ACCOUNT SID HERE>/saml2 to https://iam.twilio.com/v1/Accounts/<YOUR ACCOUNT SID HERE>/saml2.

In order to migrate to the new SSO URL you'll need to

  1. Update your configuration on your IDP
  2. Configure the Twilio SSO URL you are using in the Twilio Console
(error)

Danger

You must complete these steps immediately after each other. Please ensure that you have access to your IdP and your Twilio account before migrating to the new Flex SSO URL.


Updating your IDP configuration

updating-your-idp-configuration page anchor

Okta

okta page anchor
Okta Edit SAML.

In the Basic Settings for the Okta Application you need to update both:

  1. The SAML Single Sign On URL https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2(link takes you to an external page) .
  2. The Audience URI from https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2/(link takes you to an external page) metadata . Note the addition of metadata addition at the end of the Audience URI.

Make sure to replace the Account SID (ACxxxx) with your real Account SID.

Turn on the checkbox labeled Use this for Recipient URL & Destination URL and add the Audience URI with /metadata at the end of the iam URL.

Okta Settings.

Okta will auto-populate the Recipient URL and Destination URL. Once you're finished editing your settings, your configuration should look like the following:

Now you need to update the Twilio SSO URL in the Twilio Console to complete the migration

Active Directory Settings Page.

In the Basic SAML Configuration update:

  1. The Identifier (Entity ID): https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2/(link takes you to an external page) metadata . Note the addition of metadata addition at the end of the Identifier (Entity ID).
  2. The Reply URL from https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2(link takes you to an external page) .

Make sure to replace the Account SID (ACxxxx) with your real Account SID.

Now you need to update the Twilio SSO URL in the Twilio Console to complete the migration

Google SSO Flex (IAM v1).

Go to your Google SAML Apps(link takes you to an external page) and click on your Flex SAML app. Then click into your Service Provider Details and update:

  1. The ACS URL: https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2(link takes you to an external page)
  2. The Entity ID from https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2/(link takes you to an external page) metadata . Note the addition of metadata addition at the end of the Entity ID.

Make sure to replace the Account SID (ACxxxx) with your real Account SID.

Now you need to update the Twilio SSO URL in the Twilio Console to complete the migration

Salesforce SSO Flex (IAM v1).

In the Web App Settings update:

  1. The ACS URL: https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2(link takes you to an external page)
  2. The Entity ID from https://preview.twilio.com/iam/Accounts/ACxxxx/saml2(link takes you to an external page) to https://iam.twilio.com/v1/Accounts/ACxxxx/saml2/(link takes you to an external page) metadata . Note the addition of metadata addition at the end of the Entity ID.

Make sure to replace the Account SID (ACxxxx) with your real Account SID.

Now you need to update the Twilio SSO URL in the Twilio Console to complete the migration


Updating your Twilio SSO URL to iam.twilio.com

updating-your-twilio-sso-url-to-iamtwiliocom page anchor
SSO-setup-migration-guide.

Immediately after you've made the above change on the configuration on your IDP to use the iam.twilio.com URL you should update the Twilio SSO URL for your account. You can do this in the Flex Console Single Sign-on settings page(link takes you to an external page) by selecting the USES IAM.TWILIO.COM radio button and saving your changes.


Rate this page: