WCPISU is the legacy Integration System User authentication type for Workday Extend. Workday recommends the simplified ISU type instead. Existing apps may keep WCPISU, but new apps must use simplified ISU. Extend apps created after October 4, 2024, including apps created from a copy, must use simplified ISU. Orchestration Builder ISU credentials already use the simplified scheme.
What changes between WCPISU and simplified ISU
| Area | Legacy WCPISU | Simplified ISU |
|---|---|---|
| AreaSMD scheme | Legacy WCPISUWCPISU with appId, tokenHolder, optional checkEnvironment |
Simplified ISUISU with username matching App Manager |
| AreaAPI client | Legacy WCPISUExisting WCPISU client | Simplified ISUNew client created when you assign the ISU in App Manager |
| AreaReuse | Legacy WCPISU— | Simplified ISUYou cannot configure simplified ISU with the old WCPISU API client |
| AreaNew apps after 2024-10-04 | Legacy WCPISUNot allowed for new presentation-component apps | Simplified ISURequired |
| AreaISU to app mapping | Legacy WCPISULegacy association | Simplified ISUMultiple ISUs per app; each ISU belongs to only one app |
Migration steps
Workday points migrators at Configure ISU Authentication in Presentation Components and Create Orchestration Credentials. The practical sequence is:
- Create or confirm the Integration System User with Create Integration System User. Keep Session Timeout Minutes at zero. Put the ISU in an Integration System Security Group (Unconstrained) and grant the View/Modify and Get/Put domains the app needs. Activate Pending Security Policy Changes.
- In App Manager, assign the ISU to the app so Workday creates the API client for that ISU. You need the WCP Integration System User Security domain for the Add Integration System User button, and Company Administrator consent on the Developer Site for non-Development tenants.
- Open the Site Metadata (SMD) in Code mode. Replace or add an
authTypesentry withschemeset toISU(case-sensitive) andusernameset to the System User name from App Manager:
"siteAuth": {
"authTypes": [
{
"id": "isuAuth",
"scheme": "ISU",
"username": "Default_ISU"
}
]
}- On every PMD endpoint that used the old WCPISU auth id, set
authTypeto the newid(isuAuthin the sample). Deploy the app. - For orchestrations, create ISU credentials in Orchestration Settings rather than leaving a legacy WCPISU path. Workday’s Create Orchestration Credentials page lists ISU as its own type, with the ISU name in the Username expression.
- Do not point simplified ISU at the old WCPISU API client. Workday says that combination is not supported. Delete unused API clients only after the ISU association is removed in App Manager or the app is deleted.
Promote and refresh after the cutover
Promoting a simplified-ISU app past Development requires the same ISU assignment and API client setup on the non-Development tenant, plus Company Administrator consent that lists those tenants on the API client. After a Production refresh into Implementation or Sandbox, those tenants associate with the Production API client. Add consent for Implementation and Sandbox on that Production client in the Console. With simplified ISU, Workday says you no longer need to worry about Implementation or Sandbox using Production credentials after refresh the way legacy WCPISU required.
Studio integrations should not borrow the simplified ISU API client. Create a separate API client and use Client Credentials for Studio.
Failure modes
- New app still declares
scheme: "WCPISU". After October 4, 2024 that is not valid for new presentation-component apps. Switch toISU. - SMD says
ISUbut App Manager never assigned the username. Theusernamemust match the System User configured in App Manager. - You reused the WCPISU API client. Create the client through App Manager assignment instead.
- Orchestration still authenticates with a credential that expects the old scheme. Recreate the ISU credential after the App Manager assignment.
- Non-Development promote fails consent. Company Administrator must authorize the tenant list on the API client.
Frequently asked questions
Can I keep WCPISU on an old app forever?
Existing apps can continue on WCPISU. Workday strongly recommends migrating. New apps and copies created after October 4, 2024 must use simplified ISU.
Can one ISU serve two apps?
No. You can add multiple ISUs to one app, but an ISU can be associated with only a single app.
Does simplified ISU remove the need for page security?
No. Workday says ISU access often does not match end-user tenant security. Prefer securing pages with security domains. If a page must use ISU authentication, add application checks against the current user’s roles and groups.