Loading

Workday

Version 0.3.0 (View all)
Managed integration release status
Subscription level
What's this?
Basic
Developed by
What's this?
Elastic
Ingestion method(s) API
Minimum Kibana version(s) 9.1.0
8.18.0
Important - Managed integrations on Elastic Cloud Hosted

You can use this integration as an Elastic Managed integration on Elastic Cloud Hosted deployments running this version or later.

The Workday integration v0.3.0 is in technical preview

To use pre-release integrations, go to the Integrations page in Kibana, scroll down, and toggle on the Display beta integrations option.

Workday is a cloud-based ERP system that manages business processes and allows organizations to use an integrated application. Workday is a coherent cloud ERP system for financial analysis, analytical solutions, HCM suites, and better business processes.

The Workday integration for Elastic collects Activity logs via the Workday API and Sign-on logs via the Workday Custom Report API, and visualizes them in Kibana.

  • The Activity data stream is compatible with Workday API version v1.
  • The Sign-on data stream is compatible with Workday Custom Reports exposed via the Reports as a Service (RaaS) JSON endpoint (/ccx/service/customreport2/...?format=json).
  • Activity: This integration periodically queries the Workday API to retrieve Activity logs.
  • Sign-on: This integration periodically downloads a Workday Custom Report (for example, a Sign-on report that lists sign-on records along with their key attributes) and ingests each report row as a single event.

This integration collects log messages of the following types:

  • Activity: Collects Activity Logs via the Workday API (endpoint: /activityLogging).
  • Sign-on: Collects sign-on information from a Workday Custom Report via the Workday Reports as a Service (RaaS) JSON endpoint.

Integrating Workday with Elastic gives security and IT teams centralized visibility into Workday activity logging and Workday sign-on data, so you can monitor configuration and usage changes, track sign-on activity and access patterns, support audits, and investigate suspicious or unusual authentication behavior from Kibana.

The Activity dashboard summarizes key patterns such as activity volume over time and top actors, helping you spot unusual spikes and focus on the users and operations that matter. Built-in filters make it easier to narrow events by attributes such as task, system account, and IP address, which supports faster triage and a more consistent investigation workflow across your Workday telemetry.

  1. Sign in to your Workday tenant as a Security Administrator.
  2. In the Workday search bar, search for and open the Edit Tenant Setup - System task.
  3. In the Security section, select the Enable User Activity Logging checkbox.
  4. Click OK to save the changes.
Note

Once enabled, Workday records all user activity in a secure tenant database. Activity logging must be enabled before any logs are available for export.

  1. In the Workday search bar, search for Create Integration System User.
  2. Enter a User Name (for example, ISU_SIEM_Export) and a strong Password.
  3. Clear the Require New Password at Next Sign In checkbox.
  4. Click OK.
  5. Search for Create Security Group and create an Integration System Security Group (Unconstrained).
  6. Add the ISU (ISU_SIEM_Export) to this security group.
  7. Search for View Domain and locate the User Activity Logging domain. Grant Get access to the ISU security group for this domain.
  8. Search for Activate Pending Security Policy Changes and activate the changes.
  1. In the Workday search bar, search for Register API Client for Integrations.
  2. Enter a Client Name (for example, SIEM_OAuth_Client).
  3. Select the Non-Expiring Refresh Tokens option.
  4. Add the scope: System (or the scope required for User Activity Logging API).
  5. Click OK.
  6. Copy and save the following details in a secure location:
    • Client ID: The API client identifier.
    • Client Secret: The API client secret.
  7. Search for Manage Refresh Tokens for Integrations.
  8. Select the ISU account (ISU_SIEM_Export).
  9. Generate a new refresh token for the API client.
  10. Copy and save the Refresh Token.

The API endpoint is based on your Workday tenant. The format is:

Component | Value

Token endpoint | https://HOST/ccx/oauth2/TENANT/token

Activity Logging API | https://HOST/ccx/api/privacy/v1/TENANT/activityLogging

Note

Replace HOST with your Workday hostname and TENANT with your tenant name.

Note

For additional Workday API security context, see Generating API Keys for the Workday API.

  1. Sign in to your Workday tenant as a user with report-authoring privileges.
  2. In the Workday search bar, search for Create Custom Report.
  3. Create an Advanced report on a data source that exposes sign-on activity (for example, Signons and Attempted Signons).
  4. Add the columns required for sign-on analytics (for example, System Account, Session Start, Session End, Authentication Type for Signon, Failed Signon, Invalid Credentials, Account Locked, Disabled or Expired, Browser Type, Operating System, Device Type, Request Originator, SAML Identity Provider).
  5. On the Advanced tab, select Enable As Web Service so the report is exposed as Reports as a Service (RaaS).
  6. Save the report and note the Report Name and the Report Owner (the Workday account that owns the report).
  1. In the Workday search bar, search for Create Integration System User.
  2. Enter a User Name (for example, ISU_SIEM_Export) and a strong Password.
  3. Clear the Require New Password at Next Sign In checkbox.
  4. Click OK.
  5. Search for Create Security Group and create an Integration System Security Group (Unconstrained).
  6. Add the ISU (ISU_SIEM_Export) to this security group.
  7. Grant the ISU security group access to the domain protecting the custom report's data source (for example, the System Auditing domain).
  8. Search for Activate Pending Security Policy Changes and activate the changes.

The Custom Report endpoint URL has the following format:

https://HOST/ccx/service/customreport2/TENANT/REPORT_OWNER/REPORT_NAME?format=json
		

Where:

  • HOST is your Workday hostname.
  • TENANT is your Workday tenant name.
  • REPORT_OWNER is the Workday account that owns the custom report.
  • REPORT_NAME is the name of the custom report you created above.

This integration supports both Elastic Agentless-based and Agent-based installations.

Agentless integrations allow you to collect data without having to manage Elastic Agent in your cloud. They make manual agent deployment unnecessary, so you can focus on your data instead of the agent that collects it. For more information, refer to Agentless integrations and the Agentless integrations FAQ.

Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.

Elastic Agent must be installed. For more details, check the Elastic Agent installation instructions. You can install only one Elastic Agent per host.

  1. In the top search bar in Kibana, search for Integrations.

  2. In the search bar, type Workday.

  3. Select the Workday integration from the search results.

  4. Select Add Workday to add the integration.

  5. Enable and configure only the collection methods which you will use.

    • To Collect Workday Activity logs via API, you'll need to:

      • Configure Hostname.
      • Configure Tenant.
      • Configure Client ID.
      • Configure Client Secret.
      • Configure Refresh Token.
      • Adjust the integration configuration parameters if required, including the Interval, Initial Interval, Preserve original event etc. to enable data collection.
    • To Collect Workday Sign-on logs via Custom Report API, you'll need to:

      • Configure Report URL with the full Workday Custom Report (RaaS) URL noted above.
      • Configure Username and Password for basic authentication against the Workday Custom Report API.
      • Adjust the integration configuration parameters if required, including the Interval and Preserve original event etc. to enable data collection.
  6. Select Save and continue to save the integration.

  1. In the top search bar in Kibana, search for Dashboards.
  2. In the search bar, type Workday.
  3. Select a dashboard for the dataset you are collecting, and verify the dashboard information is populated.

For help with Elastic ingest tools, check Common problems.

For more information on architectures that can be used for scaling this integration, check the Ingest Architectures documentation.

These inputs are used in the integration:

This integration uses the following Workday APIs:

GET https://HOST/ccx/service/customreport2/TENANT/REPORT_OWNER/REPORT_NAME?format=json
		

This integration includes one or more Kibana dashboards that visualizes the data collected by the integration. The screenshots below illustrate how the ingested data is displayed.