Workday Sign On Event Collector

Use the Workday Sign On Event Collector integration to get sign on logs from Workday.

Analytics & SIEM · Workday

Details

IDWorkday Sign On Event Collector
ProviderWorkday
CategoryAnalytics & SIEM
From Version8.2.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM Cloud Posture Security

README

Use the Workday Sign On Event Collector integration to get sign on logs from Workday.
This integration was integrated and tested with version v37.0 of Workday Sign On Event Collector.

Configure Workday Sign On Event Collector in Cortex

Parameter Description Required
Server URL (e.g., https://services1.myworkday.com) API Endpoint of Workday server. Can be obtained from View API Clients report in Workday application. True
Tenant Name The name of the Workday Tenant. Can be obtained from View API Clients report in Workday application. True
API Version Some tenants may be using different API versions. Check in your Workday tenant to determine the version to use. Default is v40.0. False
Username   True
Password   True
Trust any certificate (not secure)   False
Use system proxy settings   False
Max events per fetch The maximum number of sign on events to retrieve. Large amount of events may cause performance issues. False
Events Fetch Interval   False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

workday-get-sign-on-events


Returns sign on events extracted from Workday. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to events duplication and exceeding the API request limitation.

Base Command

workday-get-sign-on-events

Input

Argument Name Description Required
should_push_events Set this argument to True in order to create events, otherwise the command will only display them. Possible values are: True, False. Default is False. Required
limit The maximum number of events to return. Default is 1000. Optional
from_date The date and time of the earliest event. The default timezone is UTC/GMT. The time format is “{yyyy}-{mm}-{dd}T{hh}:{mm}:{ss}Z”. Example: “2021-05-18T13:45:14Z” indicates May 18, 2021, 1:45PM UTC. Optional
to_date The time format is “{yyyy}-{mm}-{dd}T{hh}:{mm}:{ss}Z”. Example: “2021-05-18T13:45:14Z” indicates May 18, 2021, 1:45PM UTC. Optional
relative_from_date The query from date, for example, “5 minutes”. Be advised, it is strongly suggested to keep this parameter limited in time. Optional

Context Output

There is no context output for this command.

Configuration parameters

  • base_url — Server URL (e.g., https://services1.myworkday.com) (required)
  • tenant_name — Tenant Name (required)
  • api_version — API Version
  • credentials — Username (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • max_fetch — Max events per fetch
  • eventFetchInterval — Events Fetch Interval

Commands (1)

  • workday-get-sign-on-events

    Returns sign on events extracted from Workday. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to events duplication and exceeding the API request limitation.

category: Analytics & SIEM
provider: Workday
sectionorder:
- Connect
- Collect
commonfields:
  id: Workday Sign On Event Collector
  version: -1
configuration:
- name: base_url
  display: Server URL (e.g., https://services1.myworkday.com)
  required: true
  defaultvalue: 'https://services1.myworkday.com'
  type: 0
  additionalinfo: 'API endpoint of Workday server. Can be obtained from the View API Clients report in the Workday application.'
  section: Connect
- name: tenant_name
  display: Tenant Name
  required: true
  defaultvalue:
  type: 0
  additionalinfo: 'The name of the Workday Tenant. Can be obtained from View API Clients report in Workday application.'
  section: Connect
- additionalinfo: Some tenants may be using different API versions. Check in your Workday tenant to determine the version to use. Default is v40.0.
  defaultvalue: v40.0
  display: API Version
  name: api_version
  type: 0
  section: Connect
  required: false
- name: credentials
  display: Username
  additionalinfo: "Username should include tenant info and should be in the Username@TenantName format."
  required: true
  defaultvalue:
  type: 9
  displaypassword: Password
  section: Connect
  hiddenusername: false
- name: insecure
  display: Trust any certificate (not secure)
  required: false
  type: 8
  additionalinfo:
  section: Connect
  advanced: true
- name: proxy
  display: Use system proxy settings
  required: false
  type: 8
  additionalinfo:
  section: Connect
  advanced: true
- additionalinfo: The maximum number of sign on events to retrieve. Large amount of events may cause performance issues.
  defaultvalue: '10000'
  display: Max events per fetch
  name: max_fetch
  required: false
  type: 0
  section: Collect
  hidden: false
- defaultvalue: 1
  display: Events Fetch Interval
  hidden: false
  name: eventFetchInterval
  required: false
  type: 19
  section: Collect
  advanced: true
description: Use the Workday Sign On Event Collector integration to get sign on logs from Workday.
display: Workday Sign On Event Collector
name: Workday Sign On Event Collector
script:
  commands:
  - name: workday-get-sign-on-events
    description: Returns sign on events extracted from Workday. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to events duplication and exceeding the API request limitation.
    deprecated: false
    arguments:
    - auto: PREDEFINED
      defaultValue: "False"
      description: Set this argument to True in order to create events, otherwise the command will only display them.
      name: should_push_events
      predefined:
      - "True"
      - "False"
      required: true
    - name: limit
      description: The maximum number of events to return.
      required: false
      isArray: false
      defaultValue: 1000
    - name: from_date
      description: 'The date and time of the earliest event. The default timezone is UTC/GMT. The time format is "{yyyy}-{mm}-{dd}T{hh}:{mm}:{ss}Z". Example: "2021-05-18T13:45:14Z" indicates May 18, 2021, 1:45PM UTC.'
      required: false
      isArray: false
      defaultValue: ""
    - name: to_date
      description: 'The time format is "{yyyy}-{mm}-{dd}T{hh}:{mm}:{ss}Z". Example: "2021-05-18T13:45:14Z" indicates May 18, 2021, 1:45PM UTC.'
      required: false
      isArray: false
      defaultValue: ""
    - name: relative_from_date
      description: 'The query from date, for example, "5 minutes". Note: We strongly suggest to limit the value of this parameter.'
      required: false
      isArray: false
      defaultValue: ""
    outputs: []
  runonce: false
  script: "-"
  type: python
  subtype: python3
  isfetchevents: true
  dockerimage: demisto/python3:3.12.13.10116658
  feed: false
fromversion: 8.2.0
tests:
- No tests (auto formatted)
marketplaces:
- marketplacev2
- platform
supportedModules:
- xsiam