Skip to main content

How to configure Short.io SSO via Okta

View as Markdown

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

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

Okta settings​

  1. Sign in to your Okta account.

  2. Open Admin:

    Okta dashboard with Admin button highlighted in top-right corner

  3. Choose Applications > Applications:

    Okta Admin panel with Applications menu highlighted in sidebar

  4. Click on Create App Integration:

    Okta Applications page with Create App Integration button highlighted

  5. Select SAML 2.0 and click on Next:

    Create a new app integration dialog with SAML 2.0 option selected

  6. Choose the application name and click on Next:

    Create SAML Integration General Settings with app name field and Next button

  7. Paste the URL https://authorizer.short.io/auth/saml/ <yourcompanyname](https://authorizer.short.io/auth/saml/yourcompanyname)[\> into the Single sign-on URL field and your company name into the Service Provider Entity Id fields > Done:

    SAML Settings with Single sign-on URL and Audience URI fields highlighted

  8. Scroll down and click on Next:

    SAML assertion preview section with Next button highlighted

  9. On the next screen click on Finish:

    Okta Feedback page with Finish button highlighted

  10. Select the Sign On tab and click on View Setup Instructions:

    Okta Sign On tab with View SAML setup instructions link highlighted

  11. Copy and save in a text document the Identity Provider Single Sign-On URL and the Identity Provider Issuer:

    Okta setup page with Identity Provider SSO URL and Issuer fields highlighted

  12. Click on Download certificate and save it on your device:

    Okta setup page with Download certificate button highlighted

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

      SSO configuration name field highlighted with YourCompanyName entered

    • paste the Identity Provider Single Sign-On URL which you copied from the Okta settings into the Entry point URL field:

      Entry Point URL field with Okta SSO endpoint URL pasted

    • 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 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 Identity Provider Issuer which you copied from the Okta settings into the Service provider issuer field:

      Advanced options with Service provider issuer field containing Okta 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:

      SSO settings with profile update and display name options

    • 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

  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.