Skip to main content

How to configure Short.io SSO via OneLogin

View as Markdown

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

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 OneLogin​

OneLogin settings​

  1. Sign in to your OneLogin account.

  2. From the dashboard choose Applications:

    OneLogin dashboard with Applications menu and Add App button highlighted

  3. Click on Add App.

  4. In the search field enter SAML test connector and select the option SAML Test Connector (IdP):

    Search results for SAML Test Connector with SAML Test Connector IdP highlighted

  5. From the Configuration panel you can change the Display name value and upload an icon/logo for the application:

    SAML Test Connector configuration panel with Display Name field and icon upload options

  6. Click on Save.

  7. Navigate to the SSO menu to copy and save in a text document the values of Issuer URL and SAML 2.0 Endpoint (HTTP) fields:

    OneLogin SSO tab showing Issuer URL and SAML 2.0 Endpoint fields highlighted

  8. Click on View details to open the X.509 Certificate:

    OneLogin SSO page with View Details link highlighted under X.509 Certificate

  9. Copy the certificate and save it in a separate text document:

    OneLogin SSO settings showing X.509 Certificate and SAML endpoint details

Short.io settings​

  1. Sign in to your Short.io account.

  2. Navigate to the Settings and click on Teams:

    Short.io Settings sidebar with Teams selected and SAML configuration option 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 panel with SSO configuration name field and ACS URL displayed

    • paste the SAML 2.0 Endpoint (HTTP) identifier which you copied from the application settings into the Entry point URL field:

      Entry Point URI field populated with OneLogin SAML 2.0 Endpoint HTTP URL

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

      Public certificate field with X.509 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 URL which you copied from the application settings into the Service provider issuer field:

      Advanced options with Service provider issuer field containing OneLogin Issuer URL

    • 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 settings with update profile on login and custom display name checkboxes

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

      Custom label field set to Sign in to Short.io with Save button below

  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.