Skip to main content

How to configure Short.io SSO via SSOCircle

View as Markdown

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:

    SSOCircle Manage Metadata page with Add new Service Provider link highlighted

  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

    SAML Metadata Import with FQDN, FirstName attribute, and build metadata link highlighted

  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:

    Build your own Metadata dialog with entityID and ACS URL fields filled in

  6. Click on Insert.

  7. Copy the generated XML metadata:

    Generated XML metadata highlighted for copying

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

    Manage Metadata page with XML metadata pasted in the text panel

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

    Metadata successfully imported confirmation with Manage Metadata link highlighted

  10. Click again on Manage Metadata.

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

    Manage Metadata with URLs, IDP certificates and more link highlighted

  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:

    Public IDP Configuration with Issuer and SSO Service HTTP POST fields highlighted

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

    Signing and Encryption Certificate content highlighted for copying

Short.io settings​

  1. Sign in to your Short.io account.

  2. Navigate to the Settings and click on Teams:

    Short.io Settings with Teams and SAML configuration options highlighted

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

  4. In the next screen:

    • enable the SAML configuration:

      SAML configuration section with Config enabled toggle

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

      SAML configuration with SSO configuration name field highlighted

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

      Entry Point URL field with SSOCircle SSO Service HTTP POST URL

    • paste the content of the certificate which you copied from the Public IDP Configuration into the Public certificate field:

      Public certificate field with X509 certificate content pasted

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

      SSO requirement options for the team with All members and Optional choices

    • expand the Advanced options and paste the Issuer value which you copied from the Public IDP Configuration into the Service provider issuer field:

      Advanced options with Service provider issuer field highlighted

    • 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:

      Profile update and display name settings checkboxes

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

      Custom label field for Sign in button with Save button highlighted

  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.