Skip to main content

Okta

Okta is an identity management service provider that allows employees to login various services using single sign-on.

What this does?

  • Synchronize employee accounts from Okta to WOX
  • Allow employees to login WOX using Single Sign-On.

Pre-requisites

  1. Okta Administrator account
  2. WOX Space Administrator account

SCIM Tenant URL and Token

In order to set up SCIM, you need to get Tenant URL and Token from WOX. You can login to WOX as a space administrator, click Space > Integrations > SCIM, click Configure button to get Tenant URL and Token. Take a note of these values.

picture 125

Okta

  1. Login Okta as Administrator.
  2. Click Create App Integration:

picture 1

In the popup window, select SAML 2.0 and click Next

picture 2

  1. In the new application form, enter an application name, such as "WOX" and click "Next"

picture 3

  1. Follow SSO to create an SAML SSO App.

  2. In the newly created app, click General tab, then Edit:

picture 4

  1. Click Enable SCIM Provisioning and click Save.

  2. From the integration's settings page, choose the Provisioning tab. The SCIM connection settings appear under Settings > Integration. Click Edit.

  3. Fill in the form as follows:

    SCIM base URL: https://api.woxday.com/scim/v2 Unique identifier field for users: email. Supported provisioning actions: Import New Users and Profile Updates, Push New Users, Push Profile Updates Authentication Mode: HTTP Header Authorization: [token above]

    Click "Test Connector Configuration" to verify connection is successful.

    picture 5

    You should see a successful popup:

    picture 6

    Click Save button.

note

Ignore the error of Push Groups and Import Groups. They're not necessary.

  1. In Provisioning tab, click Settings > To App, click Edit, check all options except Sync Password, click Save

picture 7

Activate and Deactivate users

  • When Okta users and groups are added to assigned application, the user is activated in WOX.

  • When Okta users and groups are removed from assigned application, the user is deactivated in WOX.

  • When users are deactivated in Okta, the user is deactivated in WOX

Assign users to WOX in Okta

  1. Click Assignments tab in Okta

picture 8

  1. Click Assign then select Assign to Group

picture 10

or you can assign to individual users by selecting Assign to People

picture 9

  1. Select group and click Assign button. All users in the group will be synchronized to WOX.

View logs

Click View logs to examine all logs

picture 11

You can see if user has been pushed to WOX successfully:

picture 12

tip

Set up Single Sign-On when you're done.