GSuite is a collection of business, productivity, collaboration, and education software developed and powered by Google. It is one of the many SAML providers that Telnyx supports for use with its SSO feature. Now learn how to set up Auth0 as a SAML Identity Provider so that we can utilize Telnyx's Single Sign-On feature.
Note: If you experience technical difficulties while attempting to set up your GSuite SSO with Telnyx, its possible your provider is experiencing outages/maintenance. You can always check the status of GSuite's features.
Instructions for setting up Google GSuite SAML Identity Provider with Telnyx
In this activity you will:
Ensure that your Telnyx Mission Command Portal is configured properly
(OPTIONAL) You can configure an Organization in your Telnyx Mission Control Portal before beginning. Otherwise, you'll have to do this during this activity.
Setting up your Telnyx SIP portal account so you can make and receive calls:
Note: Video walkthrough for GSuite/Telnyx configuration coming soon. Check back as we update our docs.
1. Add a SAML app to GSuite
In this activity,
Open Google GSuite admin portal, log in, and click on the Apps icon as shown below.
On the next page click on the Web and mobile apps tile.
You will be brought to the Web & Mobile apps page where you can click the Add Apps drop down menu and select Add custom SAML app.
On the next page, fill in an app name of your choice and click Continue.
In the step 2 section of the Google Identity Provider details page, make note of the values for SSO URL, Entity ID and SHA-256 fingerprint.
2. Enable SSO for your organization
Log into your Telnyx Mission Control Portal and navigate to your Organization section where you will create an Organization if you have not already.
Now navigate to the Single Sign-On section of the portal and click the green Enable Single Sign-On button.
Provide the following information:
Authentication Provider Name: Provide a value of your choice
Short Name Provide a value of your choice, but note that the Short Name will be part of the SSO URLs.
Manually enter configuration: Select this
IdP Certificate Fingerprint: Enter the SHA-256 fingerprint that you copied from GSuite.
IdP Certificate Fingerprint Algorithm: Select sha256.
IdP Entity ID: Enter the Entity ID that you copied from GSuite.
IdP SSO Target URL: Enter the SSO URL that you copied from GSuite.
Click Save Changes.
Scroll down to the Authentication Provider Generated Config section and take note of the values for:
Return to GSuite and click Continue.
3. Configure Telnyx as the SSO Provider
In this step, you'll configure Telnyx to act as your SSO provider
On the Service Provider Details page, provide the following information:
ACS URL: Use the value generated for Assertion Consumer Service URL on the Telnyx Mission Control Portal
Entity ID: Use the value generated for Service Provider Entity ID on the Telnyx Mission Control Portal
Start URL: Fill in the following URL: https://portal.telnyx.com
Name ID format: select EMAIL.
Name ID: Select Basic Information > Primary email.
Click Continue at the bottom of the page. On the next page, click Finish.
4. Enable your SSO configuration on your Telnyx account
In this section, you'll enable your SSO configuration on your Telnyx Mission Control Portal.
Log back into your Telnyx Mission Control Portal.
Check the Enable Single-Sign-On box.
Click Save Changes.
Your chosen settings are now in effect! This will send all users in your organization an email informing them that SSO is now enabled. Your users will still be able to login using username/password for the next 72 hours. After that, they will be required to use SSO.
Review our getting started with guide to make sure your Telnyx Mission Control Portal account is setup correctly!
Additionally, check out: