Okta Integration/Bookmark App for Atlassian-Managed Loom Workspaces

Okta Atlassian Cloud Integration

Customers using Okta can use Okta’s Atlassian Cloud integration, which will display one tile for every product that is checked under the General tab in the section Display the following links

If you would like to use the Atlassian Cloud Integration in Okta with Loom, set the Loom Base URL to https://www.loom.com/api/auth/atlassian and set General > Display the following links > Loom to "On".

Okta Bookmark App

The Okta Bookmark application provides another way to present an Okta tile to your users for logging in to Loom. You can read about the process for creating a Bookmark app on the Okta page How to create a Bookmark app. However, just creating a bookmark application and pointing it to a Loom workspace will not authenticate a user.

How to create the bookmark URL

You can use the Okta SSO URL and pass the RelayState to authenticate the user and redirect them to Loom. This is documented in the Okta page How to send a custom RelayState to application through IDP-initiated authentication URL.

The following are the steps to build the URL:

  1. Go to the SAML configuration in Atlassian Admin Hub and copy the Identity provider single sign-on URL value. For our purposes, imagine that this is https://company.okta.com/app/atlassian/exk1mdq3xigRjmhJe0h8/sso/saml.

SAML configuration

2. You will pass the encoded Loom Base URL through the RelayState query string parameter to the Identity provider single sign-on URL. In this example, the final URL is as follows:
https://company.okta.com/app/atlassian/exk1mdq3xigRjmhJe0h8/sso/saml?RelayState=https%3A%2F%2Fwww%2Eloom%2Ecom%2Fapi%2Fauth%2Fatlassian

Still need help?

The Atlassian Community is here for you.