- Getting started
- Data security and compliance
- Organizations
- Authentication and security
- Understanding authentication models
- Setting up the Azure AD integration
- Licensing
- Tenants and services
- Accounts and roles
- AI Trust Layer
- External applications
- Notifications
- Logging
- Troubleshooting
- Migrating to Automation Cloud™
Setting up the Azure AD integration
This feature is available on the Enterprise licensing plan.
If your organization is using Azure Active Directory (Azure AD) or Office 365, you can connect your Automation Cloud organization directly to your Azure AD tenant to see existing accounts and groups in your Automation Cloud environment.
With Azure AD integration, you can continue leveraging the local accounts model, while bootstrapping your organization with the additional benefits of using the Azure AD model. The Azure AD integration is designed such that activating it and rolling it out can happen gradually, with no disruption in production for your existing users.
If your organization has decided to use the Azure AD model, follow the instructions on this page to set up the integration.
To set up the Azure AD integration, you need:
- an organization with an Enterprise license
- Admin permissions in both Automation Cloudand Azure AD (can be different people);
- an Azure AD account with the same email address as the UiPath local account of the organization administrator who carries out the integration. Note that this Azure AD account is just for testing the integration and does not need to have admin permissions in Azure;
- UiPath Studio and UiPath Assistant version 2020.10.3 or later;
- UiPath Studio and UiPath Assistant to use the recommended deployment.
appid
query parameter in a dedicated URL, as described in Microsoft's access tokens documentation.
Your organization requires an app registration in your Azure AD tenant and some configuration so that it can view your AD members to establish account identity. The app registration details are also required to later connect your organization to your Azure AD tenant.
Permissions: You must be an administrator in Azure to perform the tasks in this section. The following Azure administrator roles have the required privileges: Global Administrator, Cloud Application Administrator, or Application Administrator.
There are two ways to set up your Azure tenant for the integration:
- Follow the instructions below to manually configure an app registration for the integration.
- Use the UiPath Azure AD scripts that we created for this task, which are available on GitHub: The
configAzureADconnection.ps1
script performs all the actions described in this section and returns the app registration details. Then you can run thetestAzureADappRegistration.ps1
script to make sure the app registration was successful.
To manually configure your Azure tenant, do the following in Azure Portal:
After Azure setup is complete, you can prepare for the integration, activate it, and then clean up old accounts. The process is broken down in stages so that there is no disruption for your users.
You must be an organization administrator in Automation Cloud to perform the tasks in this section.
When you connect Automation Cloud to Azure AD by activating the integration, accounts with matching email addresses are linked, so that the Azure AD account benefits from the same permissions as the matching UiPath local account.
If your organization practices email recycling, meaning that an email address that was used in the past could be assigned to a new user in the future, this could lead to a risk of elevated access.
john.doe@example.com
and this employee had a local account where he was an organization administrator, but has since left the company and the
email address was deactivated, but the user was not removed.
john.doe@example.com
email address. In such a case, when accounts are linked as part of the integration with Azure AD, John Doe inherits organization
administrator privileges.
To prevent such situations, make sure you remove all users who are no longer active from the Automation Cloud organization before proceeding to the next step. You can skip this step if inactive email addresses are not reused in your organization.
- make sure that Azure configuration is complete;
- obtain the Directory (tenant) ID, Application (client) ID, and Client Secret values for the Automation Cloud app registration in Azure from your Azure administrator.
Now you can work with the users and groups in the linked tenant's Azure AD. Directory accounts and groups are not listed in either the Users or Groups pages under Admin - Accounts & Groups, you can only find them through search.
To check that the integration is running, sign in as an organization administrator with an Azure AD account and try to search for Azure AD users and groups on any related page, such as the Edit Group panel in the Automation Cloud (Admin > Accounts and Groups > Groups > Edit).
If you can search for users and groups that originate in Azure AD, it means the integration is running. You can tell the type of user or group by its icon.
If you encounter an error while trying to search for users, as shown in the example below, this indicates that there is something wrong with the configuration in Azure. Reach out to your Azure administrator and ask them to check that Azure is set up as described earlier in the documentation on Configuring Azure for the Integration.
testAzureADappRegistration.ps1
, which is available on GitHub, to find and fix any configuration issues when the cause is not clear.
After the integration is active, we recommend that you follow the instructions in this section to ensure that user creation and group assignations are handed off to Azure AD. This way you can build on top of your existing identity and access management infrastructure for easier governance and access management control over your UiPath resources in Automation Cloud.
You can do this to ensure that the Azure administrator can also onboard new users with the same permissions and robot configuration you had set up prior to the integration. They can do this by adding any new users to an Azure AD group if the group has the required roles already assigned.
You can map your existing user groups from Automation Cloud to new or existing groups in Azure AD. You can do this in several ways, depending on how you use groups in Azure AD:
- If users with the same roles in Automation Cloud are already in the same groups in Azure AD, the organization administrator can add these Azure AD groups to the user groups that these users were in. This ensures that users keep the same permissions and robot setup.
- Otherwise, the Azure administrator can create new groups in Azure AD to match the ones in Automation Cloud and add the same users that are in the UiPath user groups. Then the organization administrator can add the new Azure AD groups to the existing user groups to ensure the same users have the same roles.
Ensure to verify any roles specifically assigned to users, in all instances. If feasible, remove these direct role assignments, and add these users into groups already assigned with these roles.
For example, let's say the Administrators group in Automation Cloud includes the users Anna, Tom, and John. These same users are also in a group in Azure AD called admins. The organization administrator can add the admins Azure group to the Administrators group in Automation Cloud. This way, Anna, Tom, and John, as members of the admins Azure AD group, all benefit from the roles of the Administrators group in Automation Cloud.
Because admins is now part of the Administrators group, when you need to onboard a new administrator, the Azure administrator can add the new user to the admins group in Azure, thus granting them administration permissions in Automation Cloud without having to make any changes in Automation Cloud.
Changes to Azure AD group assignments apply in the Automation Cloud when the user logs in with their Azure AD account, or if already logged in, within an hour.
For the permissions assigned to Azure AD users and groups to apply, users must sign in at least one time. We recommend that, after the integration is running, you communicate to all your users to sign out of their local account and sign in again with their Azure AD account. They can sign in with their Azure AD account by:
-
Navigating to the Automation Cloud organization-specific URL, in which case the sign in type is already selected. The URL must include the organization ID and end in a forward slash, such as
https://cloud.uipath.com/orgID/
. -
By selecting Enterprise SSO on the main login page. Make sure you provide your organization-specific URL for Automation Cloud to all your users.
Migrated users receive the combined permissions directly assigned to them in Automation Cloud along with those from their Azure AD groups.
To set up Studio and Assistant to connect with Azure AD accounts:
- In Assistant, open Preferences and select the Orchestrator Connection tab.
- Select Sign Out.
- For the connection type, select Service URL.
-
In the Service URL field, add the organization-specific URL The URL must include the organization ID and end in a forward slash, such as
https://cloud.uipath.com/orgID/
. Otherwise the connection fails saying that the user does not belong to any organization. - Sign back in with the Azure AD account.
We recommend that you remove the use of local accounts to maximize the core compliance and efficiency benefits of the complete integration between Automation Cloud and Azure AD.
After all users have been migrated, you can remove the non-admin users from the Users tab, so that your users won't be able to sign in using their local account anymore. You can find these accounts based on their user icons.
You can also clean up individual permissions in the UiPath services, such as the Orchestrator service, and remove individual users from groups so that permissions rely exclusively on Azure AD group membership.
Exceptions
If you decide to discontinue use of local accounts, keep in mind that if you have processes in place that rely on API key authentication (Admin > Tenants page) to make API calls to a service, you need a local account because the button is not available when logged in with an Azure AD account.
Support for API Key authentication will end March 2025. We recommend you switch to using OAuth or personal access tokens for authorization, in which case the information from API Access is no longer required.
Here are a few useful pointers for advanced features you can leverage now that you have the Azure AD integration set up.
Restrict access to your organization
Because the integration with Azure AD is performed at the level of the Azure tenant, by default all Azure AD users can access Automation Cloud. The first time an Azure AD user signs in to their UiPath organizaton, they are automatically included in the UiPath group Everyone, which grants them the User role in the organization which provides the basic level of access within the UiPath ecosystem.
If you want to only allow certain users to access your organization, you can activate user assignment for the UiPath app registration in Azure. This way, users need to be explicitly assigned to the app to be able to access it. For instructions, see how to restrict your app to a set of users in Microsoft's Azure AD documentation.
Restrict access to trusted networks or devices
If you want to only allow your users to access Automation Cloud from a trusted network or a trusted device, you can use the Azure AD Conditional Access feature.
Governance for groups in Azure AD
If you have created groups in Azure AD for easy UiPath onboarding directly from Azure AD, as described earlier in Configure groups for permissions and robots, you can use the advanced security options of privileged identity management (PIM) for these groups to govern access requests for UiPath groups. For details, see the Microsoft documentation on PIM.
What changes for my users after the integration is active?
Users can immediately sign in using their existing Azure AD account and benefit from the same permissions they had on their local account.
If you have not removed their local accounts, users can also continue to sign in with their local account, both methods work.
https://cloud.uipath.com/orgID/
, or select Enterprise SSO on the main login page.
Another change users might notice is that if they are already signed in to their Azure AD accounts from using another application, they are automatically signed in when they navigate to this URL.
What roles does each account have?
Azure AD account: When a user signs in with their Azure AD account, they immediately benefit from all the roles they had on their local account, plus any roles assigned within UiPath to the Azure AD account or to the Azure AD groups to which they belong. These roles can come from the Azure AD user or the Azure AD group being included in groups, or from other services where roles were assigned to the Azure AD user or Azure AD group.
Local account: With the Azure AD integration active, for local accounts, it depends:
- If the user hasn't signed in at least once with their Azure AD account, they have only the roles of the local account.
- If users login using their Azure AD account, the local account has all roles that the AAD user has within UiPath, either explicitly assigned, or inherited from group memberships.
Do I need to re-apply permissions for the Azure AD accounts?
No. Because matching accounts are automatically linked, their existing permissions apply when logged in with the Azure AD account as well. However, if you decide to discontinue use of local accounts, make sure the appropriate permissions have been set for users and groups from Azure AD beforehand.
- Prerequisites
- Configuring Azure for the integration
- Deploying the integration to Automation Cloud
- Clean up inactive users
- Activate the Azure AD integration
- Test the Azure AD integration
- Completing the transition to Azure AD
- Configure groups for permissions and robots (optional)
- Migrate existing users
- Discontinue use of UiPath local accounts (optional)
- Advanced features
- FAQs