Skip to main content
Setup instructions to sign in to Isotopes AI with an Okta account. Estimated setup time: 20 minutes. This is the assisted path: you do the Okta side, send us a few values, and we finish the configuration on our side. If you have admin access to Isotopes AI as well and would rather do the whole thing yourself, follow the full Okta SAML SSO setup instead.

What we have already done

Your account is ready, and we have generated the two values Okta needs from us: Both values should be available in the onboarding email (they are to be used exactly as sent).
Note: They might look similar. The Entity ID is the short one ending in /saml. The ACS URL is longer.

Step 1: Create the app in Okta

  1. In your Okta admin console, go to Applications → Applications → Create App Integration.
  2. Select SAML 2.0 and click Next.
  3. Give the name Isotopes AI and click Next.
  4. On the Configure SAML screen, fill in the following fields:

Step 2: Add the attributes

On the same screen, scroll down to Attribute Statements and add these two rows: Right under there is Group Attribute Statements. Add one row: That last row tells us which Okta groups someone belongs to. We use it to set their access level. If you would rather not send every group, use Starts with and a prefix that covers the ones you want us to see. Then click Next, choose I’m an Okta customer adding an internal app, and click Finish.

Step 3: Assign your people to the app

Creating the app does not give anyone access to it. Until someone is assigned, Okta stops them at sign-in with “User is not assigned to this application.” On the app’s Assignments tab, click Assign:
  • Assign to Groups — the usual choice. Assign the groups you named in Step 2’s group filter, so the same groups that grant access also carry the access level.
  • Assign to People — fine for a small pilot or a first test user.
Assign at least one person (typically yourself) before the next step. We cannot complete our side until someone can actually sign in, and the groups attribute from Step 2 is only sent for users who are assigned.

Step 4: Send the following items to Isotopes

On the Sign On tab that was just created, click View SAML setup instructions. The following items are available on that page:
  1. Identity Provider Issuer
  2. Identity Provider Single Sign-On URL
  3. X.509 Certificate — copy the whole block, including the BEGIN and END lines.
The next item is your group list. Tell us which Okta groups should get which access level, and what everyone else should get by default: Example: “our okta-admins group should be Admin, everyone else Viewer” is enough.

What happens next

We run a connection test on our end. Following that, we will be able to onboard new users. If anyone sees “User is not assigned to this application.” when they try to sign in, they have not been assigned in Okta — go back to Step 3 and add them or their group.