Workday

Configure the Risotto Workday integration for HR management using OAuth 2.0 JWT bearer authentication.

Instructions

  1. Run Create x509 Public Key in Workday. Paste the certificate PEM you generated in this dialog and set Name to:
  2. Create an Integration System User (ISU) and assign domain security and/or user security groups so this user can read/update worker data Risotto uses. Typical policies (search Domain Security Policies for the integration security group; names can vary slightly by tenant):

    Worker lookup

    • Worker Data: Public Worker Reports (Get)
      WQL queries to resolve workers by email
    • Worker Data: Workers (Get)
      Retrieve worker details (job title, manager, org)
    • Worker Data: Current Staffing Information (Get)
      Resolve person ID from worker ID via Staffing service
    • Worker Data: All Positions (Get)
      Current and historical position details
    • Staffing (Get)
      General staffing service access
    • System: Workday Query Language (Get)
      Execute WQL queries
    • System: Worker Event History (Get)
      Read worker event history

    Personal data

    • Person Data: Personal Data (Get)
      Get personal data
    • Person Data: Personal Information (Get)
      Get personal information fields

    Home address

    • Person Data: Home Contact Information (Get and Put)
      Read home addresses and update them within a change event
    • Person Data: Home Address (Get and Put)
      Secures Change Home Contact Information (REST Service)
    • Self-Service: Home Address (Get and Put)
      Secures Change Home Contact Information (REST Service) initiated on behalf of the worker
    • Person Data: Work Contact Information (Get)
      Read work contact information

    Time off and absence

    • Worker Data: Time Off (Get and Put)
      PTO balances, time off entries, eligible types, and submitting time off requests
    • Absence Management (Get and Put)
      Absence management operations
    • Worker Data: Absence Balances (Get)
      Retrieve PTO balances
    • Self-Service: Time Off and Leave Balances (Get)
      Retrieve time off and leave balances
  3. Register an API Client:
    • Client Grant Type: JWT Bearer Grant
    • x509 Certificate: Select name of certificate generated above
    • Access Token Type: Bearer

    Scopes (Functional Areas):

    • Staffing: worker lookup, initiate home contact information changes
    • Personal Data: read personal information
    • Contact Information: read and update home addresses
    • Time Off and Leave: PTO balances, time off entries, eligible types, and time off requests
    • Absence Management: PTO balances and time off requests
    • System: WQL support and REST API routing
    • Tenant Non-configurable: global scope required for WQL and People resources
  4. Copy the API client Client ID into Client ID field.
  5. Copy the API client's Tenant URL and Tenant Name into Tenant URL and Tenant Name fields.
    Examples: https://wdN-services.myworkday.com (production) or https://wdN-impl-services.workday.com (sandbox) for tenant name acme. Use the host shown in the browser address bar after signing into Workday — production tenants typically live on .myworkday.com, sandboxes on .workday.com.

Certificate and private key

Generate a self-signed certificate and PKCS#8 private key (RSA 2048, ~10-year validity). Copy the certificate below into your Workday tenant.

Save Workday settings to enable testing.