How to configure Short.io SSO via Google Workspace

View as Markdown

Short.io supports Single Sign-On (SSO) integration with Google Workspace.

Note

SSO is available on the Enterprise Plan.

Before you begin

You need to create a Team before setting up SSO. Follow the instructions in this article.

How to configure SSO with Google Workspace

Google settings

1. Sign in to your Google Workspace account.

2. In the sidebar navigate to Apps > Web and mobile apps:

   

3. Click on Add app and choose the Add custom SAML app option.

4. In the App details screen enter Shortio as app name, add a description of the app, and (optionally) upload an app icon:

   

5. Click on Continue.

6. From the next screen :

   • copy the SSO URL and the Entity ID values and save them in a text file

   • download the certificate

   

7. Click on Continue.

8. In the next screen:

   • in the ACS URL field enter the following value with your company name at the end: https://authorizer.short.io/auth/saml/ <yourcompanyname](https://authorizer.short.io/auth/saml/yourcompanyname)[\>

   • in the Entity ID enter shortcm

   • select EMAIL from the Name ID format list

   • select Basic information > Primary email from the Name ID list

   

9. Click on Continue.

10. In the next screen click on Finish:

    

Short.io settings

1. Sign in to your Short.io account.

2. Navigate to the Settings and click on Teams:

   

3. Click on your team and then click SAML Configuration.

4. In the next screen:

   • enable the configuration:

     

   • enter the name of your company in the SSO configuration field:

     

   • paste the SSO URL value that you copied into the Entry point URL:

     

   • open the certificate which you downloaded in a text editor, copy and paste the content of the certificate into the Public certificate field:

     

   • you can specify whether or not the SSO is required for All members of the team or is Optional:

     

   • expand the Advanced options and paste the Entity ID URL which you copied from the application settings into the Service provider issuer field:

     

   • you can determine if a profile should be updated each time the user logs in,

     and if the users are allowed to chose their own display name:

     

   • you can change the appearance of the Sign in button by adding a custom label:

     

5. Click on Save to confirm.

You can now use the Single Sign-On with Short.io.

Note

The Short.io team configures SSO within 24 hours.

In case you need further assistance, please contact the Short.io support team at support@short.io.