--- title: "Workday Report" slug: "workday-report" description: "Learn how to connect Clarity Security to Workday Report to automate your identity life cycle management and user access reviews." updated: 2024-03-20T22:11:58Z published: 2024-03-20T22:11:58Z canonical: "help.claritysecurity.com/workday-report" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Workday Report This guide will teach you how to set up the connector between Workday Report (as a Service) and Clarity Security. **Estimated time to complete:** 30-60 minutes If you run into any problems, please contact your support team or [support@claritysecurity.io](mailto:support@claritysecurity.io). ## How to Setup the Connector ### **Step 1: Create a Workday Integration System User (ISU)** It is recommended to create a dedicated ISU in Workday to be the report owner and provide access to the report for Clarity. You may already have a suitable ISU that you may wish to use, and that's okay. If you need to create one: 1. Go to your Workday tenant and search for "create integration system user" 2. Under **Tasks & Reports**, click **Create Integration System User** 3. Enter a username & password. You'll need to input these later on during Application setup in Clarity. 4. Leave the **Require New Password at Next Sign In** option unchecked 5. Enter 0 for **Session Timeout Minutes** 6. Check **Do Not Allow UI Sessions** to ensure this user cannot sign into your Workday 7. Click **OK** **NOTE:** The ISU must be part of an Unconstrained Integration System Security Group with a series of "Get Only" Domain Security Policies granted to it to access the appropriate worker data. ### **Step 2: Create the Custom Report in Workday** Enter the following properties: - **Report Type** = Advanced - **Data Source** = All Active and Terminated Workers. Your decision to include pre-hires should depend on whether or not Clarity is doing life-cycle management and if you want those pre-hires to be provisioned into other downstream applications before their hire date. - **Data Source Type** = Standard - **Primary Business Object** = Worker Add the following Columns to the report, making note of which are Required by Clarity: 1. **user_id** (required) 2. **first_name** (required if not using a nickname or preferred name) 3. **last_name** (required) 4. **nickname** (optional in place of first_name, so long as your organization never leaves this blank) 5. **email** (required) 6. **active** (required) 7. **super_ref** (this is Manager ID, Clarity only matches on ID and not name for Manager/Supervisors) 8. **business_title** 9. **position_title** 10. **division** 11. **category** Go to the Advanced tab and set **Enable As Web Service = Yes** **![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1710824109442.png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=SgHdtTtQgs52MsH2kuR7vtAFL%2Fyk9ykMQSk%2FXFBXoqk%3D)** **Go to the Share tab and make sure your ISU is the owner of the report** **![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1710824232818.png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=VK6nbAO7x3ClMeVnB0hgUUM%2FPmbZtiOUnNyvEl%2FrMGw%3D)** ### **Step 3: Copy the Report URL in JSON format** You'll need this for your Clarity setup to go along with the username & password of your ISU Go to the Workday Report Console to open the list of Report URLs. Copy the JSON URL link ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1710824390631.png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=GMg9lCWBtDjoc9YWL0n1kMH%2F%2Fnah%2FZTozgDuEkaNSzg%3D) ### **Step 4: Login to your Clarity Security tenant** > https://your-tenant.claritysecurity.io/ ### **Step 5: Click on Applications, then Marketplace** ![Applications > Marketplace](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679588491503.png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=SKh0U6KU1mzRJnCJ%2BKDq0S8Y5La20plKQuFcsZfvDuo%3D) ### **Step 6: Find Workday Report** Scroll to or search for Workday Report in the list of applications from the marketplace, then click **Connect**. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1710824530844.png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=E2wZ13nHjWFi1ZJIISMM6openjV8yWo5Cbahvx88LY0%3D) ### **Step 7: Connect App** Complete the App Settings form. Details for fields common to all applications can be found at the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-1-connect-app) - Enter the username & password for the ISU on the first tab and click Validate ### Step 8: App Settings Part 1 - Add a Report Choose Report Type: Identities Enter the full URL that you copied in Step 3 Give the report a simple Name/Description then click Add New Report. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1710825049886.png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=Hz7KA6Ro1v1z%2BeATz1%2FfzGSxUQ2liJLn26w3ssS0s44%3D) Clarity will connect and import the report so that you can map the fields from the report to Clarity fields Mapping the fields should be pretty straightforward for most of them. Use "Attribute" for any fields such as business_title or division in order to use those fields in your Org Units/Roles in Clarity ### Step 9: App Settings Part 2 Complete the App Settings form. Details for each field can be found at the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-2-app-settings) ![Configure App Step 2 - App Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%202(3).png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=zmWOuEAOwn%2F6ShKLmf%2FhbK1OMEh%2F%2FI%2FqWPp5LElyuRs%3D) ### Step 10: User Settings Complete the User Settings form, and check the table at the top to see if any features are unsupported. Details for each field can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-3-user-settings) ![Configure App Step 3 - User Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%203(2).png?sv=2026-02-06&spr=https&st=2026-11-22T21%3A53%3A59Z&se=2026-11-22T22%3A53%3A59Z&sr=b&sp=r&sig=3C%2F373rcN9g2GgxM0EcgmZ%2FdfSav9Bi4SSwM%2BMHcoIA%3D) ### Step 11: Validate Your Selections and Save Save Clicking the Save button will trigger the first full sync for your application (even if you selected Manual syncing). This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes. ## Need Help? If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST. A Service User is a user, or service account, discovered by Clarity in a downstream application. An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies. Service User Entitlements are the pairings of users and active entitlement access in downstream applications. An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.