This is a setup guide for configuring Equinox to work alongside Okta as the IDP for a SAML2 configuration.

  1. Create a new application inside of Okta by clicking on Create App Integration
    A screenshot of a computer 
Description automatically generated
     

  2. Select SAML 2.0 App type 
    A screenshot of a computer 
Description automatically generated
     

  3. Give your app a name - you can use any name you’d like here 

  4. Click Next  

  5. Input the following values into the fields under the “Configure SAML” table:


    Single sign-on URLhttps://[SERVER-URL]/single-sign-on/www/module.php/saml/sp/saml2-acs.php/default-sp
    Audience URI (SP Entity ID)https://[SERVER-URL]/single-sign-on/www/module.php/saml/sp/metadata.php/default-sp
    Name ID formatEmailAddress
    Application usernameEmail
    Update application username onCreate and update



    A screenshot of a computer 
Description automatically generated
     

  1. The easiest way to set this up is to select the options below
    A screenshot of a computer 
Description automatically generated
     

  2. Copy the following data points from the app that has been created into Equinox:

    Okta FieldEquinox Field
    Metadata URLSSO Metadata URL
    IssuerSSO IDP Name

  3. Navigate to your login URL. This will be in the format of: https://[YOUR-EQUINOX-SERVER]/login/[ORGREF]

  4. You'll see a bespoke login screen based on the options you set

  5. Log in with a user you have granted access to via Okta

Note: The login buttons inside of Okta seem to have intermittent issues. We recommend using the dedicated login URL above to log in to the application.