Skip to main content

Okta Workspace

ezto auth's Okta Workspace Synchronization will directly import users and groups from your existing Okta Workspace admin directory to your dashboard. ezto auth will update the user information on every sync. No information from the dashboard is imported into your Okta Workspace directory.

Prerequisites

To set up Okta Workspace Sync, make sure you have the following:

  • You must have an admin account in Okta Workspace.
  • You must have an Owner or Administrator role to setup and manage the directory sync of users into the ezto auth's dashboard.

Set up a connection for user sync

1 Go to Dashboard > User Management > User Sync.

2 Click on +ADD USER SYNC.

+ADD USER SYNC

3 The available User Sync Integrations will be displayed, choose Okta Workspace.

User Sync Integration

4 All the configurations will be displayed, provide a descriptive name and the mandatory configurations.

Configurations

note

The above configurations(Domain Name, API Token) can be obtained from Okta Workspace.


Here's how you obtain the configurations

  • Go to Okta Workspace and click on profile dropdown, copy the domain part of the URL. This is your Domain Name; copy to clipboard.

Domain Name

  • Click on Security > API.

Security API

  • Navigate to Tokens and click on Create token

Tokens

  • Token will be created successfully, copy to clipboard.

Token Created

  • Navigate back to your dashboard and paste the copied configurations.

5 Configure Enrollment Type, there are three types available.

TypeDescriptions
Send Enrollment EmailA verification process takes place, where all the synced users will receive an invite email to the dashboard.
Trust Emailthe email verification will be set true for all users, where all the synced users will be verified upon being synced.
Only SyncThe users from Azure will be synced without any additional email verification or configs.

Enrollment Type

6 Choose the enrollment as per your need, for instance; Send Enrollment Email type is selected here.

7 Configure Unique field, there are two types available:

TypeDescriptions
EmailThe users will be created based on the Email.
UsernameThe users will be created based on the Username.

Unique field

8 Choose the unique field as per your need, for instance; Username type is selected here, click on CREATE.

9 User Sync will be created successfully.

10 Click on SYNC DATA.

note

All Okta Workspace users will be synced into the dashboard upon clicking SYNC DATA.

Sync Data

11 Once the user sync is completed, sync report mail will be sent to the admin mail provided.

Mail

note

Upon every sync, the SYNC HISTORY wll have the details and status on every sync furthermore.

Sync History


Users Synced

1 Go to Dashboard > User Management > Users.

2 All the synced users can be found in this section.

Okta Users


Groups Synced

1 Go to Dashboard > User Management > User Groups.

2 All the synced user groups can be found in this section.

Okta User Groups


Sync

ezto auth's User Sync is a one-way operation. No information from ezto auth will be imported into the Okta Workspace. On syncing, your users can be easily managed with our dashboard.

Edit

The EDIT button will let you edit the configuration settings upon creating the connection.

Groups

  • The Groups that are in Azure AD will be imported to the ezto auth dashboard upon syncing.
  • The users who already existed in a Group(s) will also be synced and automatically assigned to their designated group.

User Sync Completion

After syncing the users into ezto auth's dashboard, wait for a couple of seconds for it to be reflected. On successful sync, a sync report mail will be sent to you, containing the number of synced/updated users.

  • The synced users can be checked in the dashboard (User Management > Users)
  • The synced user groups can be checked in the dashboard (User Management > User Group)

Update

Once Okta Workspace is synced to the dashboard successfully, if the user's information is changed/updated, the changes will be reflected in the ezto auth's dashboard upon givingSYNC.

Delete Synced Users

If the user is deleted, the changes will be reflected in the ezto auth's dashboard upon giving SYNC.

Sequence Diagram

Sequence Diagram