Skip to main content

How to configure Short.io SSO via SSOCircle

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

Note: SSO is available on the Enterprise Plan.

Before you begin​

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

How to configure SSO with SSOCircle​

SSOCircle settings​

  1. Sign in to your SSOCircle account.

  2. Navigate to Manage Metadata:

  3. Click on Add new Service Provider.

  4. In the next screen:

    • enter short.io as FQDN

    • select Firstname

    • click on the link named "here" to build your SAML Metadata

  5. A new Build your own Metadata dialog is opened. Enter shortcm as entityID and [https://authorizer.short.io/auth/saml/<yourcompanyname](https://authorizer.short.io/auth/saml/<yourcompanyname)\> as ACS URL:

  6. Click on Insert.

  7. Copy the generated XML metadata:

  8. Return to the Manage Metadata screen and paste the XML code in the text panel:

  9. Click on Submit. The metadata is successfully imported:

  10. Click again on Manage Metadata.

  11. Click on How to: URLs, IDP certificates and more:

  12. You are redirected to the Public IDP Configuration section. Copy the values of the Issuer and SSO Service HTTP POST fields and save them in a text document:

  13. Copy the content of the Signing and Encryption Certificate and save it in a separate text document:

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 SAML configuration:

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

    • paste the SSO Service HTTP POST value which you copied from the Public IDP Configuration into the Entry point URL field:

    • paste the content of the certificate which you copied from the Public IDP Configuration 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 Issuer value which you copied from the Public IDP Configuration 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.