Provision Users Through Okta

  1. On the Okta Admin login splash page choose “Create a new app”.


  1. Choose Web and SAML 2.0.


  1. In the “App name” field, fill in “My OPSWAT Central Management” or something similar. You can also upload a logo if you like. Do not check the “App visibility” checkboxes. Click Next to continue.


  1. Under the “SAML Settings” , fill in the “Single Sign on URL” field with a properly formatted URL as a placeholder. Note You will change this later after retrieving the applicable value from My OPSWAT Central Management.

  2. Leave the box checked next to “Use this for Recipient URL and Destination URL”. Leave the box unchecked, next to “Allow this app to request other SSO URLs“.

  3. Fill in the Audience URL

  4. Default setting are fine for “Default Relay State”, “Name ID format”, “Application username”, and “Update application username on”.

  5. Skip the first “Name” and “Value” fields.

  6. Under “GROUP ATTRIBUTE STATEMENTS (OPTIONAL)”, fill in the “Name” and “Filter” fields.

    1. For “Name” enter whatever you want but save the value to use later in the MA UI”, eg: “groups”.

    2. Under Filter , choose “Matches regex” and “.*”

    3. Advanced users may choose other options but it’s recommended to use these setting unless you’re very familiar with Okta.


  1. Click “Next” to continue.


  1. The next page is just feedback for Okta, and has no functional impact. You can choose “I'm an Okta customer adding an internal app”, then leave all the other fields blank and click “Finish”.

  2. On the next page (under the “Sign On” tab), in the Info Box labeled “SAML 2.0” there is a link called “Metadata URL”. Click Copy, open new tab and paste that url, press Enter. Save as metadata.xml file you will import into My OPSWAT Central Management.


  1. Log into your My OPSWAT Central Management Console at https://my.us.opswat.com/

  2. Navigate to User Management > SSO > SDP and check “Enable Single Sign On”.


  1. Next to “Import configuration from XML Metadata file”, click “Choose File” and upload the “metadata” file you just downloaded from Okta. This should automatically fill in the “Current Certificate”, “Issuer”, and “IdP SSO URL” fields.

  2. In the “IdP Name” field, enter “Okta” or some other string. This is only for reference in the My OPSWAT Central Management UI.

  3. Leave the Logout URL and Error URL fields blank.


  1. At the bottom, click “Add Group Attribute” and enter the value the value from the “Name” field in Okta. Presumably something like “group”.

  1. At the bottom of the page you will see a new value called “My OPSWAT Central Management Login URL”. Click “Copy to clipboard”.


  1. Scroll to the top of the page, click “Save” and enter your My OPSWAT Central Management admin PIN.

  1. Switch back to Okta, click the “General” tab, scroll down to “SAML Settings” and click “Edit”.


  1. Click “Next” on the first panel.


  1. There will be a placeholder URL under “Single sign on URL”. Replace this with the URL you just copied from My OPSWAT Central Management.


  1. Scroll to the bottom and click “Next” and then “Finish”.



  1. In the navigation bar on the top, mouse over Applications and click the Applications link. Then click the Gear icon next to the My OPSWAT Central Management app, and choose “Assign to Groups”.


  1. On the groups panel, you can decide which groups you want to use for assigning SDP access in the My OPSWAT Central Management console. Click “Assign” next to each SDP user group. Note You will need to record the selected group names for use in My OPSWAT Central Management. Please copy and paste the group names to minimize human error!

  2. Click “Done.”


  1. Navigate to the My OPSWAT Central Management console, then go to User Management > IdP Groups, and click “Add”.

  2. Fill in a group name you copied from Okta, enter your PIN and choose Add. Your new group will show up in the “IdP Groups” section.


  1. Repeat for each SDP user group in Okta.

  2. When you are ready to assign your new groups to protected applications, go to Secure Access > Protected Apps, click the “Assign” link next to your desired application(s).

  3. On the “Assign End Users/IdP Groups to Protected Applications” Move groups “Available Users/Groups” to “Selected Users/Groups” to assign access, then enter your PIN again and choose Enter.


  1. Log back in to the Okta console as an end user and click on the “My OPSWAT Central Management” application.