Create SAML app in Opal and Okta

  1. When logged into Okta as an administrator, click on Applications on the left sidebar.

  2. Click on the Create App Integration button, then select SAML 2.0 and click on Next.

  3. Name your SAML app Opal. You can use this brand asset as the app icon.

  4. For Single Sign On URL and Audience URI, copy and paste the ACS URL and Entity ID from the SAML Identity Provider Configuration section of the Opal Admin UI page (which can be found under the /admin page of the Opal app).

  5. In the Attribute Statements page, input given_name, family_name, and email as first name, last name, and email, respectively, like in the following image:

  6. Leave all other fields in their default state.

  7. Click Next to the next page.

  8. Select I'm an Okta customer adding an internal app.

  9. Click Finish.

  10. When the application creation is completed, navigate to the Assignments tab in the app and add users or groups who you want to grant SAML access to. The email address of each user must match the email address of the Opal account in order for the user to log into Opal via SAML.

  11. After completing the assignment, navigate to the Sign on tab of the app and click on View setup instructions (it should look like the image below):

  12. When clicking on View Setup Instructions, copy the Identity Provider Single Sign-On URL and download the X.509 certificate.

  13. Copy the URL from the previous step into the Identity Provider SAML 2.0 SSO URL field of the SAML Authentication Settings section of the Opal Admin page (image below). Also upload the certificate downloaded from the previous step (by selecting Upload Certificate). Then click Save Changes.

  14. This will create the SAML integration between Okta and Opal!

Test provider initiated SAML flow from Opal

  1. Navigate to Opal, then log out of your Opal account.

  2. Click Continue with SAML on the Opal login screen.

  3. Manually type your email address in the Email field. This email must have the same domain name as whoever created the SAML app in the Opal UI earlier (e.g. if [email protected] created the SAML integration, the SAML integration will be tied only to users with the opal.dev domain). This email must also be associated with an Okta user (either as a single or user or within an Okta group) assigned in the Okta SAML app, described in Step 10.

  4. This should prompt you to log in with Okta.

  5. You may arrive at this linking screen (below). If so, you should click continue and log in with the account corresponding to your email address.

  6. At this point, if you have been granted access via Okta, you should be able to log into Opal!

Did this answer your question?