Workday-Beta


Workday Connector for Leena AI

The Workday connector for Leena AI allows you to index and search knowledge articles from your Workday tenant. By integrating Workday with Leena AI, organizations can make published help and knowledge content easily discoverable across the company, improving access to policies, procedures, and internal guidance.

The connector focuses on ingesting knowledge articles and provides configuration options to control which articles are indexed, ensuring that only the appropriate and relevant content is made searchable within Leena AI.


Prerequisites

Before proceeding, ensure you have the following details and configurations ready in your Workday tenant:

1. Integration System User (ISU) Credentials

  • Username
  • Password

2. API Client for Integrations Credentials

  • Client ID
  • Client Secret
  • Refresh Token

3. OAuth Configuration

  • OAuth 2.0 Clients Enabled: Must be enabled in Workday.
  • Edit Tenant Setup Access: Required to verify and configure OAuth settings.

4. Required URLs

  • Token Endpoint
  • Workday REST API Endpoint

Set Up the Connector

During the setup process in Leena AI, you will provide a name and icon for the data source along with the following:

  • Domain (host name)
  • Tenant name
  • Client ID
  • Client Secret
  • Refresh Token

Finding your Domain and Tenant Name

Refer to your Workday service endpoint URL.

Example URL: https://wd2-impl-services1.workday.com/ccx/service/tenant_name/Human_Resources/v44.0

  • Domain: wd2-impl-services1.workday.com
  • Tenant Name: tenant_name (the value immediately following /service/)

Grant ISU Domain Security Permissions

To enable secure access, you must create an Integration System User (ISU) and an Integration System Security Group (ISSG).

1. Create the Integration System User (ISU)

  1. Use Universal Search to locate the Create Integration System User task.

  2. Configure the user details and securely record the username and password.

  3. Confirm the ISU has default permissions assigned.

2. Create an Integration System Security Group (ISSG)

  1. Search for the Create Security Group task.

  2. Select Integration System Security Group (Unconstrained) as the type.

  3. Name the group (e.g., ISSG_connector_leena_ai).

3. Add the ISU to the ISSG

  1. Run the All Workday Accounts report to find your ISU.

  2. From the action menu, select Assign Integration System Security Groups.

  3. Add the ISU to the group created in the previous step.

4. Add Domain Security Policies

  1. Open the ISSG using the View Security Group report.

  2. Select Maintain Domain Permissions for Security Group from the related actions menu.

  3. Add the following permissions:

Permission TypePermissionBusiness Justification
View OnlyHelp Article REST APITo read Article content present in Workday
Get OnlyHelp Article REST APITo fetch Article data from Workday REST API
  1. Run the Activate Pending Security Policy Changes task to apply updates.


Create API Client for Integrations

1. Register the API Client

  1. Search for Register API Client for Integrations.

  2. Name the client (e.g., connector_leena_ai).

  3. Add the required functional areas (Help scopes).

  4. Record the Client ID and Client Secret.

2. Retrieve Endpoint Details

  1. Search for View API Clients.
  2. Locate your client and record the:
  • Token Endpoint

  • Workday REST API Endpoint

3. Generate a Refresh Token

  1. In View API Clients, go to the API Clients for Integrations tab.

  2. Select your client and choose Manage Refresh Tokens for Integrations.

  3. Add your ISU account and click Generate Refresh Token.

  4. Securely record the generated Refresh Token.


Checklist for Leena AI KM Integration

Ensure you have these 6 items ready for the Knowledge Management Dashboard:

  • ISU Username
  • ISU Password
  • Client ID & Client Secret
  • Token Endpoint
  • REST API Endpoint
  • Refresh Token
  • Domain and Tenant name

Finalizing Setup in Leena AI

  1. Log in to the Knowledge Management Dashboard.
  2. Navigate to Settings —> Integrations.
  3. Find the Workday Connector and click Connect.
  4. Complete the setup wizard by entering the credentials fetched above.
  5. Click Connect and choose between Manual Sync or Auto Sync.