Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
IL:External Directory Prerequisites V21
IL:External Directory Prerequisites V21
nopaneltrue

Expand
titlePrerequisites

In order to connect EmpowerID to Workday, the following prerequisites need to be met:

  1. Workday needs to be configured to allow SOAP API access

  2. The Workday API user needs to have access to read worker and contingent worker attributes (excluding things like compensation)

Step 1 – Generate a self-signed certificate in EmpowerID

  1. On the navbar of the EmpowerID Web interface, expand Apps and Authentication > SSO Connections and select SSO Components.

  2. Select the Certificates tab and then click the Add button in the grid header.

    Image Modified

     

  3. Select Generate Self-Signed Certificate.

    Image Modified

     

  4. Enter the following information:

    • Certificate Owner – Leave empty

    • Prefer Local Machine Store – Leave empty

    • Subject Name – Enter something suitable to the purpose of the certificate, such as CN=AzureCertificate

    • Requires Password – Select this option; this adds a private key to the certificate

    • Certificate Password – Enter a password for the certificate

  5. Click Save to create the certificate.

    Image Modified

 

Step 2 – Download the certificate in Base64 format

  1. From the Certificate Details page, return to the SSO Components page by clicking the Find Certificates breadcrumb.

  2. On the SSO Components page, select the Certificates tab and search for the certificate you just created.

    Image Modified

     

  3. Click the Name link for the certificate to navigate to the View page for the certificate.

  4. On the View page for the certificate, click Export Certificate.

    Image Modified

     

  5. Select the desired location in which to save the certificate and click Save.

Step 3 – Register a service principal application in Azure

  1. Log in to your Azure portal as a user with the necessary permissions to create an application in Azure AD.

  2. In Azure, navigate to your Azure Active Directory.

  3. On the Azure navbar, click App registrations.

  4. On the App registrations page, click New registration.

    Image Modified

     

  5. Name the application, select the scope for the application (single or multitenant) and click Register.

  6. Once the application is registered, copy the Application (client) ID and Directory (tenant) ID from the Overview page. These values are used when configuring the SCIM app service.

    Image Modified


  7. Navigate to the Certificates & secrets blade for the application and click Upload certificate.

    Image Modified

     

  8. Select the base-64 encoded certificate you downloaded from EmpowerID and click Add.

    Image Modified
Note

The public key certificate that you upload to Azure must have a corresponding private key in the EmpowerID certificate store; otherwise, an error will occur when calling Azure’s API.

Step 4 – Create an app service to host the Workday SCIM microservice

  1. Log in to your Azure portal as a user with the necessary permissions to create an App Service.

  2. In Azure, navigate to All Services > App Services and create a new App service.

  3. Under Project Details, select a Subscription and then create a Resource Group for the App Service.

  4. Under Instance Details, do the following:

    • Name – Enter a name.

    • Publish – Select Code.

    • Runtime Stack – Select .Net Core 3.1 (LTS).

    • Operating System – Select Linux.

    • Region – Select the appropriate region.

  5. Click Review + Create.

  6. Click Create.

  7. After the deployment of the app service completes, click Go to resource.

  8. Change the platform for the app service to 64 Bit by doing the following:

    1. On the app service navbar, under Settings, click Configuration.

    2. On the Configuration blade, select the General settings tab.

    3. Under Platform settings, change the Platform to 64 Bit and click Save.

    4. Click Continue to confirm you want to save the changes.

  9. On the Overview page for the app service, copy and save the URL. You will need this when you configure Azure AD Auth for the app service.

    Image Modified

Step 5 – Configure authentication for the app service

  1. Navigate to the Authentication blade for the app service and click Add identity provider.

    Image Modified

  2. Select Microsoft.

    Image Modified

  3. Add the following identity provider information:

    1. App registration type – Select Pick an existing app registration in this directory.

    2. Name or app ID – Select the service principal you created to provide Azure AD authentication for the microservice.

    3. Issuer URL – Replace the default value with https://login.microsoftonline.com/<Your Tenant ID>

    4. Restrict access – Select Require authentication.

    5. Unauthenticated requests – Select HTTP 401 Unauthorized: recommended for APIs.

    6. Token Store – Leave selected.

    7. Click Add.

      Image Modified

  4. After adding the Identity provider, click the Edit link for it.

    Image Modified

  5. Set the Issuer URL to https://login.microsoftonline.com/<Your Tenant ID>.

  6. Under Allowed token audiences enter the URL for the app service.

    Image Modified

  7. Click Save.

  8. Under Settings, select Identity.

  9. Turn on system assigned managed identity and click Save.

    Image Modified

  10. Click Yes to confirm you want to enable system assigned managed identity and register the App Service with Azure Active Directory.

    Image Modified

  11. Back in the Overview page for the App Service, click Get Publish Profile. You will need this file when you publish the Workday microservice to Azure.

    Image Modified

Step 4 – Publish the Workday Microservice to Azure

  1. Log in to EmpowerID as a person with the necessary access to initiate the SCIM Microservice Publishing workflow.

  2. On the navbar, expand Azure Manager and click Configuration.

  3. Select the Tenants tab and then click the Publish Azure AD SCIM App Service action link.

Image Removed
  1. Image Added

     

  2. For Application Type select Microservices and then click SUBMIT.

Image Removed
  1. Image Added

     

  2. For Microservice Application select Workday SCIM Microservice and then click SUBMIT.

    Image Modified

     

  3. Click Choose File and browse for the browse for the Workday SCIM App Service Publisher Profile Settings file you downloaded from Azure. 

  4. Once you have selected the file, click Submit

  5. Click Yes to confirm that you want to publish the Workday SCIM Microservice. 

  6. Click OK to close the publish results message.

Step 5 – Create a key vault with secrets to store Workday credentials

  1. In Azure, create a key vault if you do not already have one or want to create a new one.

  2. Navigate to the Key Vault blade for the appropriate key vault.

  3. On the Secrets page, click Generate/Import.

     

    Image Modified

  4. On the Create a secret blade, do the following to create the secret:

    1. Name – Enter userName.

    2. Value – Enter the username of the user account accessing the user data in your Workday instance.

    3. Click Create

  5. Back on the Secrets blade, click Generate/Import again.

  6. On the Create a secret blade, do the following to create the second secret:

    1. Name – Enter Password.

    2. Value – Enter the password of the user account accessing the user data your Workday instance.

    3. Click Create.

  7. Back on the Secrets blade, click Generate/Import again.

  8. On the Create a secret blade, do the following to create the third secret:

    1. Name – Enter tenantUrl.

    2. Value – Enter the tenant URL of your Workday instance.

    3. Click Create

  9. Back on the Secrets blade, click Generate/Import again.

  10. On the Create a secret blade, do the following to create the fourth and final secret:

    1. Name – Enter tenantid.

    2. Value – Enter the tenant of your Workday instance.

    3. Click Create
      You should now have the following secrets in the key vault:

      Image Modified

  11. Next, navigate to the Workday SCIM App Service you created earlier.

  12. On the navbar for the App Service, under Settings, click Configuration.

  13. Under Application settings, click New application setting.

     

    Image Modified

  14. In the Add/Edit application setting pane, add the following:

    1. Name – Enter WORKDAY_VAULTED_CREDS.

    2. Value – Enter the name of the vaulted creds you created for your Workday secrets.

    3. Click OK.

      Image Modified

       

  15. Click Save on the Configuration blade.

  16. Click Continue to confirm that you want to save changes.

Step 6 – Create an account store for Workday

Image Removed
  1. On the navbar, expand Admin > Applications and Directories and select Account Stores and Systems.

  2. Select the Actions tab and then click Create Account Store.

     On the navbar, expand Admin > Applications and Directories and select Account Stores and Systems.

  3. Select the Actions tab and then click Create Account Store.




  1. Insert excerpt
    IL:Common Images
    IL:Common Images
    nameCreateAccountStoreAction
    nopaneltrue

     

  2. Under System Types, search for Workday.

  3. Click the record for Workday to select the type and then click Submit.

     

    Image Modified

  4. Enter the following information in the Azure Microservice Configuration form:

    • Name – Name of the account store

    • Microservice URL – The URL to the app service hosting the Workday SCIM microservice

    • Azure AppID – The ID of the application you registered in Azure AD for EmpowerID

    • Azure Directory (Tenant) ID – The ID of your Azure tenant

    • Certificate Thumbprint – Thumbprint of the certificate you uploaded to your Azure tenant

  5. When ready, click Submit to create the account store.

    Image Modified

Step 7 – Verify Workday resource system parameters

  1. Return to the Find Account Stores page and search for the Workday account store you just created.

  2. Click the Account Store link.

    Image Modified

  3. Select the Resource System tab and then expand the Configuration Parameters accordion at the bottom of the page.

  4. Verify the following parameters have the correct value:

    • AzureAppID

    • AzureTenantID

    • certificateThumbprint

    • GetNewOrUpdatedUsersUrl

    • MicroserviceUrl

Step 8 – Configure Attribute Flow

  1. On the Account Store Details page for the Workday account store, select the Attribute Flow Rules tab.

  2. Review the attribute flow and revise as needed. EmpowerID translates the attributes in Workday to SCIM for use with the connector and represents those attributes in EmpowerID as External Directory Attributes. You map these attributes to EmpowerID Person attributes to ensure that any changes occurring to user attributes in Workday flow to the EmpowerID Person, as well as any other user accounts owned by the Person.

  3. To change the score for any of the available CRUD operations (Create, Update and Delete), enter the new score in the appropriate field. By default, scores are weighted evenly, which means that a change to an attribute originating in one connected external directory has the same authority as a change to an attribute occurring in another connected external directory.

Step 9 – Create Dynamic Hierarchy policies to generate roles and location (Optional)

If desired, you can use Dynamic Hierarchy policies to generate external roles and locations based on specific user attributes, such as Job Title and Department. The external roles and locations can then be used to map corresponding EmpowerID logical locations. Please see Use Dynamic Hierarchy Policies to Create External Roles and Locations for information on setting this up. When completed, return to this article and complete steps 10 and 11.

Step 10 – Configure the Workday account store

  1. On the navbar, expand Admin > Applications and Directories and select Account Stores and Systems.

  2. Search for the Workday account store and click the Account Store link for it.

    Image Modified

  3. On the Account Store Details page, click the Edit link to put the account store in edit mode.

    Image Modified


    This opens the edit page for the account store. This page allows you to specify the account proxy used to connect EmpowerID to your Workday instance as well as how you want EmpowerID to handle the user information it discovers in Workday during inventory. Settings that are relevant to Workday are described in the table below the image

    Image Modified


    Insert excerpt
    IL:Account Store Settings (Workday) V21
    IL:Account Store Settings (Workday) V21
    nopaneltrue

  4. Edit the account store settings as needed and then enable inventory as shown below.

Step 11 – Enable Inventory on the account store

By default, EmpowerID inventories account stores once every 10 minutes. However, Workday updates user data once every 24 hours. As this is the case, EmpowerID recommends that you set the interval level to once every 12 hours or once every 24 hours. If you do not change the default, inventory still occurs, but the data in the account store will not update until Workday updates.

  1. On the Account Store Settings page, select the Inventory tab.

  2. Under Inventory Schedule Interval, do the following:

    1. Optionally, select a Start and End date for inventory to occur

    2. Select Hour Interval

    3. Interval – Enter either 12 or 24.

  3. Inventory Enabled – Toggle to enable EmpowerID to inventory Workday.

  4. Click Save to save your changes to the account store.

Now that inventory is enabled for the account store, the next step is to turn on the Account Inbox permanent workflow. This workflow is responsible for fetching and processing new user accounts.

Step 12 – Enable the Account Inbox Permanent Workflow

Insert excerpt
IL:Enable Account Inbox PW - V21
IL:Enable Account Inbox PW - V21
nopaneltrue

Step 13 - Map Role and Locations

  1. On the navbar, expand Identity Lifecycle and select Role and Location Mapper.

  2. Select the Role Mapper tab.

  3. In the External Source Business Role pane of the Role Mapper tab, do the following:

    1. In the first (upper) field - Search for and select the external directory containing the role you want to map, and

    2. In the second (lower) field - Enter the name of the external role you want to map and press ENTER to load the role.

    3. Select the role from the tree.

  4. Select the Location Mapper tab.

  5. In the External Source Location pane of the Location Mapper tab, do the following:

    1. In the first (upper) field - Search for and select the external directory containing the location you want to map and

    2. In the second (lower) field - Enter the name of the external location you want to map and press ENTER to load the location.

    3. Select the location from the tree.

      Image Modified

       

  6. In the Internal Destination Location pane, enter the name of the EmpowerID location to which you want to map the external directory location and then select the location from the tree.

    Image Modified

     

  7. Click Save to save the mapping.

  8. Repeat for any other mappings you wish to create.

Info

If you select an external role or an external location that is a parent role or location, the children of that role or location will be mapped to the selected EmpowerID location.

 

Macrosuite divider macro
dividerWidth80
dividerTypetext-with-icon
emoji{"id":"smile","name":"Smiling Face with Open Mouth and Smiling Eyes","short_names":["smile"],"colons":":smile:","emoticons":["C:","c:",":D",":-D"],"unified":"1f604","skin":null,"native":"😄"}
textColor#000000
dividerWeight3
labelPositionmiddle
textAlignmentcenter
iconColor#0052CC
fontSizemedium
textRelated
emojiEnabledfalse
dividerColor#DFE1E6
dividerIconbootstrap/CloudsFill

Use Dynamic Hierarchy Policies to Create External Roles and Locations

Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue

Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue
Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue

Div
stylefloat:left; position:fixed;
idarticleNav

IN THIS ARTICLE

Table of Contents
maxLevel4
minLevel2
stylenone
printablefalse

Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue