Skip to main content
Skip table of contents

SAML Configuration for Okta


This guide provides step-by-step instructions for configuring SAML authentication between Okta and D3 vSOC. It includes setting up the SAML app integration in Okta, creating and assigning users, configuring specific parameters for different D3 SOAR versions, and enabling login via Okta to D3 vSOC.


Configure SAML in Okta

  1. Login to your Okta Portal at <instance>

  2. Navigate to Applications > Applications > Create App Integration.

    Frame 1 (2)-20240615-211300.png
  3. Select the SAML 2.0 radio option, then click on the Next button.

    Frame 2 (1)-20240615-211601.png
  4. Enter a name for your D3 application, then click on the Next button.

    Frame 3 (2)-20240615-211822.png
  5. Enter your D3 SOAR URL in the Single sign-on URL field with /login.aspx appended.


The inclusion of /login.aspx is mandatory. Failure to do so will result in the following error message and associated troubleshooting details.

  1. Enter your D3 SOAR URL in the Audience URL (SP Entity ID) field.

    Frame 4 (2)-20240616-041943.png
  2. Scroll down to the bottom of the Configure SAML stage, then click on the Next button

  3. Click on the Finish button in the Feedback stage.

    Frame 5 (1)-20240616-044530.png
  4. Click on the Sign On tab, then click on the View SAML setup instructions button to be redirected to another page containing the Single Sign-On URL and X.509 Certificate.

    Frame 7 (2)-20240616-050547.png


In Okta, Single Sign-On URL maps to Target URL in D3 vSOC, whilst X.509 Certificate maps to Certificate in D3 vSOC.

  1. Store the Identity Provider Single Sign-on URL and the X.509 Certificate for later use when configuring SAML in D3 vSOC.

    Frame 8 (3)-20240616-052257.png


  • If you would like D3 to assist with the setup process, send D3 your SAML setup certificate through a private channel.

  • If your organization decides to perform the setup independently, copy Okta’s Single Sign-On URL and the X.509 Certificate into the New Auth form in D3 vSOC. Follow the Login Authentication Configuration Guide for details.

Create Users in Okta

  1. Click on the Directory dropdown menu, then click on the People menu item.

  2. Click on the Add person button.

    Frame 9 (2)-20240616-055301.png
  3. Enter all the input fields within the Add Person form, then click on the Save button.

    Frame 10 (1)-20240616-055841.png


An activation e-mail will be sent to the user.

Assign Okta User the SAML Integration

  1. Click on the Applications dropdown menu, then click on the Applications menu item.

  2. Click on the app integration created from the SAML Configuration for Okta section.

    Frame 11 (5)-20240616-062443.png
  3. Click on the Assignments tab.

  4. Click on the Assign dropdown menu, then select the Assign to People menu item.

    Frame 12 (2)-20240616-063348.png
  5. Click on the Assign button in the popup, for the user created in the Create Users in Okta section.

    Frame 15 (1)-20240616-065827.png
  6. Enter the primary email for user set in the Create Users in Okta section, then click on the Save and Go Back button.

    Frame 14 (1)-20240616-064431.png
  7. Confirm the rendering of the Assigned status, then click on the Done button.

    Frame 16 (1)-20240616-070347.png


Before proceeding to the next section, ensure that you have:

  • Created D3 user accounts (Organization Management > Users > + Add Users). The SAMLEmailIDType configuration key in vSOC’s Application Settings > Web Config determines what your D3 username must be. Depending on its setting, your username could be either your full email address or the local part of your email. Refer to the FAQ section in the Authentication Configuration Guide for more details.

  • Assigned login methods to those D3 user accounts (Application Settings > Login Authentication > Users).


To enable multiple users within your organization to access D3 vSOC, create an Okta user for each individual, and assign them the SAML Integration.

Login to D3 vSOC via Okta

  1. Navigate to the General tab.

    Frame 17 (1)-20240617-161831.png

  2. Scroll down and copy the Embed Link.

    Frame 24 (1)-20240617-173524.png

  3. Paste the Embed Link into a new browser tab and press the Enter.

  4. Enter your Okta username and password, then click on the Sign In button.

    Frame 19 (1)-20240617-163701.png

After logging in to Okta successfully, you will be redirected to D3 vSOC.

Frame 20 (1)-20240617-164020.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.