Configure Workday for the Next Generation API Data Protection
Configure Workday for the Next Generation API Data Protection
To configure Workday for the Next Generation API Data Protection, follow the instructions below.
Enable User Activity Logging
This enables user activity to be recorded in the secured Workday database. To enable it, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for Edit Tenant Setup -System, and click Edit Tenant Setup – System.
-
Under User Activity Logging, check Enable User Activity Logging.
Create an Integration System User
Netskope integration with Workday requires an integration system user. To do so, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for Create Integration System User, and click Create Integration System User.
-
On the Create Integration System User pop-up window, enter the following details:
-
Enter the User Name of the integration system user
-
Enter the New Password and New Password Verify.
-
Click Do Not Allow UI Sessions checkbox.
-
-
Click OK, then Done.
Configure Permissions for Integration System User
To configure an integration system user to authenticate the Next Generation API Data Protection, follow the steps below.
Create an Integration System Security Group
This section explains how to create a new integration system security group and assign it to the integration system user. For more information on security groups, see Concept: Security Groups. You will need a community account to access the Workday documentation.
To do so, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for Create Security Group, and click Create Security Group.
-
On the Create Security Group pop-up window, enter the following details:
-
For Type of Tenant Security Group, select Integration System Security Group (Unconstrained).
-
Enter the name of the security group. Click OK.
-
-
On the Edit Integration System Security Group (Unconstrained) window, enter the following details:
For Integration System Users, select the integration system user you created earlier. This will be the user who will authenticate the Next Generation API Data Protection.
-
Click OK, then Done.
Add Domain Security Policy to Security Group
This section explains how to add domain security policies and map it to the newly created integration system security group. To do so, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for Maintain Permissions for Security Group, and click Maintain Permissions for Security Group.
-
On the Maintain Permissions for Security Group pop-up window, enter the following details:
-
Keep the Operation radio button set to Maintain.
-
In Source Security Group, select the newly created integration system security group. Click OK.
-
-
On the Maintain Permissions for Security Group window, under the Domain Security Policy Permissions tab, click the + icon.
-
Enter the following details:
-
Click OK, the Done.
Activate Pending Security Policy Changes
Once you have added the domain security policies, it’s time to commit the pending security policy changes. To do so, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for Activate Pending Security Policy Changes, and click Activate Pending Security Policy Changes.
-
On the Activate Pending Security Policy Changes window, enter a comment and click OK.
-
Check Confirm and click OK.
-
You should get an acknowledgment.
Register an API Client for Integrations
To integrate Netskope with Workday, you should create a new API client in Workday. To do so, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for Register API Client for Integrations, and click Register API Client for Integrations.
-
On the Register API Client for Integrations page, enter the following details:
Only the mandatory fields (asterisk mark) should be configured. Rest of the fields can be left unchanged.-
Enter a Client Name.
-
Select the Non-Expiring Refresh Tokens checkbox.
-
Under Scope (Functional Areas), select Contact Information, Implementation, Staffing, and System. Click OK.
-
-
Note down the values of Client ID and Client Secret. These values will be required when you set up the Workday instance in the Netskope UI.
-
Client ID
Ensure that you do not use this client ID in any other 3rd party integration. The client ID should be used exclusively for Netskope integration. -
Client Secret
Client secret is visible as soon as you register the API client. Once you move away from the registration page, the client secret is not visible anymore. If you miss noting it down, you can generate a new client secret. To do so, search Generate New API Client Secret in the Workday search bar and follow the steps to create a new API client secret.
-
-
While on the Register API Client for Integrations page, click the horizontal ellipsis beside the client name, then navigate to API Client > Manage Refresh Tokens for Integrations.
-
On the Manage Refresh Tokens for Integrations pop-up window, select the Workday account and click OK.
The Workday account should be the integration system user created as part of Create an Integration System User. -
On the Delete or Regenerate Refresh Token page, check Generate New Refresh Token and click OK.
-
Note down the value of Refresh Token. The value will be required when you set up the Workday instance in the Netskope UI.
View API Client
Before you can configure the Workday instance in Netskope UI, you will need the Workday REST API Endpoint and Token Endpoint values. To find the values, follow the steps below:
-
Log in to your Workday account.
-
On the search bar, search for View API Clients, and click View API Clients.
-
On the View API Clients page, note down the Workday REST API Endpoint and Token Endpoint values. These values will be required when you set up the Workday instance in the Netskope UI.
Configure Workday Instance in Netskope UI
To authorize Netskope to access your Workday instance, follow the steps below:
-
Log in to the Netskope tenant UI and go to Settings > Configure App Access > Next Gen > CASB API.
-
Under Apps, select Workday and click Setup CASB API Instance.
The Setup Instance window opens.
-
Enter the following details that you already noted after registering the API client in Workday:
-
Client ID
-
Client Secret
-
Refresh Token
-
Token Endpoint
-
Workday REST API Endpoint
-
-
Under Administrator Email, enter the email address of the user who will receive an email notification when a policy violation or event triggers. This step is optional.
-
Under Instance Name, enter a name of the SaaS app instance. This step is optional and if left blank, Netskope will determine the name of the app instance post grant.
-
Click Grant Access.
Refresh your browser, and you should see a green check icon next to the instance name.
Next, you can view the Next Generation API Data Protection Inventory page to get deep insights on various entities on your Workday account. For more information on the Inventory page, see Next Generation API Data Protection Inventory.
You can receive audit events and standard user behavior analytic alerts in Skope IT. To know more: Next Generation API Data Protection Skope IT Events.
Next, you should configure a Next Generation API Data Protection policy. To do so, see Next Generation API Data Protection Policy Wizard.