---
sourceDocument: Yokohama Data and Automation
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Data and Automation

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Configurations to use Workday SOAP Basic Auth with WS-Security

# Configurations to use Workday SOAP
Basic Auth with WS-Security {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Configure your ServiceNow instance to perform actions that
use the Workday SOAP
Basic Auth with WS-Security.

## Before you begin

Role required: admin.

## About this task

This is the most traditional Workday SOAP authentication setup.  
Note:  
These configurations are needed to use the SOAP-based spoke actions. For information about the SOAP-based spoke actions, see the Spoke actions that use Workday SOAP APIs section in [Workday HR Spoke](https://www.servicenow.com/docs/h7Oh0b1mTSQc29oogX5RCw "The Workday HR spoke is built by Bristlecone, Inc. Manage staffing, resources, payroll, benefits, and so on in the system from your ServiceNow instance.").

## Provide the Workday HR base
URL {#ariaid-title2}

Provide the base URL of your Workday HR instance in
the Connection Details \[connection_details\] table. Spoke actions based on the SOAP API, use
these details for the action execution.

### Before you begin

Role required: admin.

### Procedure

1. Navigate to AllWorkday HR SpokeConnection Details.
2. Click the Show List related list.
3. Click New.
4. On the form, fill these values.  
   {#base-url-workday-hr__table_sxd_l2g_pmb__entry__2}

   | Field | Description |
   |-|-|
   | Base URL | Base URL of the Workday instance or tenant name. Enter the base URL in this format <kbd class="ph userinput">https://&lt;workday_host_url&gt;/ccx/service/&lt;workday_tenant_name&gt;</kbd> |
   | Version | Version of the API. For example, enter <kbd class="ph userinput">v33.2</kbd>. |
   | Webservice Type | Type of web service. Select <kbd class="ph userinput">SOAP</kbd>. |
   [Table 1. Connection Details form]

   {#base-url-workday-hr__table_sxd_l2g_pmb}
5. Click Save.
{#base-url-workday-hr__steps_qfq_qph_pmb}

## Create a WS-Security Username Profile for the Workday HR
spoke {#ariaid-title3}

Create a WS-Security Username Profile to provide your Workday credentials to
authenticate requests from ServiceNow.

### Before you begin

Role required: admin.

### Procedure

1. Navigate to AllIntegrationHubSOAP IntegrationsWS-Security Username Profiles.
2. Click New.
3. On the form, fill these values.  
   {#create-sec-profile-wd-hr__table_x4x_ngg_pmb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name to uniquely identify this credential. For example, enter <kbd class="ph userinput">WorkdayHR User</kbd>. |
   | Application | Application in which the record is applicable. Select Workday HR Spoke. |
   | Username | Workday user who has integration rights using Workday Web Services. |
   | Password | Password of the Workday user. |
   [ ]

   {#create-sec-profile-wd-hr__table_x4x_ngg_pmb}
4. Click Save.
{#create-sec-profile-wd-hr__steps_mpk_frd_rmb}

## Configure the SOAP security policy for the Workday HR
spoke {#ariaid-title4}

Configure the SOAP security profile by adding the security user name profile you had
created to authenticate requests from ServiceNow.

### Before you begin

Role required: admin.

### Procedure

1. Navigate to AllIntegrationHubSOAP IntegrationsSOAP Security Policies.
2. Open the record for the Workday HR spoke, for example, WorkdayHR.  
   Note:  
   If you intend to use another SOAP security policy record and not the default record, you must ensure that you select that record in all the actions that use Workday SOAP web services.  

   Except these listed actions, all other actions use Workday SOAP web services:
3. For WS-Security Username Profile, select the security username profile you had created for the Workday HR spoke.  
   See [Create a WS-Security Username Profile for the Workday HR spoke](https://www.servicenow.com/docs/_1P7Tir~w9nEV0A88q8uDw#create-sec-profile-wd-hr "Create a WS-Security Username Profile to provide your Workday credentials to authenticate requests from ServiceNow.") for more information.
4. Do not provide a value in WS-Security X.509 Profile.
5. Right-click the form header and click Save.
{#conf-soap-sec-policy-wdhr__steps_h3p_qrd_rmb}

*[\>]: and then