订阅

UiPath Orchestrator

UiPath Orchestrator 指南

Accounts and roles

On the Manage Access page you can define and assign roles. In Orchestrator, you use roles to control the level of access an account should have.
On this page we go over the notions you need to understand to effectively plan and implement your access control strategy.

The level of access and the actions that your users can perform is controlled using two elements:

  • accounts, which establish the identity of a user and are used to log in to your UiPath applications
  • roles, which are assigned to accounts in order to grant them certain permissions within the UiPath ecosystem.

Accounts are not created or managed in Orchestrator, only roles and their assignments are.

About accounts in Orchestrator


An account is a UiPath platform entity with access-dependent capabilities and whose view and control of Orchestrator rely on the assigned roles.

Accounts can be:

  • created and managed locally (local accounts) from the:
  • created and managed in an external directory (directory accounts and directory groups). See the section AD Integration for a better understanding of directory integration.

More information:
Learn more about the types of accounts.
Learn about Orchestrator's access-control model, which relies on role assignations.

Accounts are only available within the one organization.
Once an account has been successfully added, there are two ways of granting them rights to Orchestrator:

  • by adding the account to a group so that it inherits the roles of the group or
  • by assigning roles to the account at the service level.

You can use both methods for granular control over the access an account has in your organization.

Directory integration

An active directory (AD) referenced in Orchestrator makes its members potential Orchestrator users. The level of access for a directory account is configured in Orchestrator, either at the group level (directory group) or at the user level (directory user).

You can integrate with:

📘

Using a directory integration together with attended robots auto-provisioning and hierarchical folders allow for effortlessly setting up large deployments. See Managing large deployments for details.

先决条件

  • The authentication option through which you connect to the external directory is enabled.
  • A valid domain was specified during authentication configuration. All domains and subdomains from forests 2-way trusted with the specified domain are available when adding users/groups.
  • The machine on which Orchestrator is installed is joined to the specified domain. To check whether the device is joined to the domain, run dsregcmd /status from the Command Prompt, and navigate to the Device State section.
  • The identity under which the Orchestrator application pool is running must be a part of the Windows Authorization Access group (WAA).

行为

  • Adding a directory group creates an entity in Orchestrator called a directory group, for which you configure access rights as desired. This entry serves as a reference to the group as found in AD.
  • When logging in, Orchestrator checks your group membership against the AD database and UiPath Identity Server. If confirmed, it automatically provisions your user as a directory user, and then associates it to the access rights inherited from the Directory Group (step 1). Inherited rights are only kept for the duration of the user session.
  • Auto-provisioning takes place the first time a user logs in. An auto-provisioned user account doesn't get deleted at log out as you might need the entry for audit purposes.
  • Changes made to group membership in the directory are synced with Orchestrator at every log-in or once every hour for active user sessions. This value can be changed using the WindowsAuth.GroupMembershipCacheExpireHours. If you are a member of X group, what happens is this:
    You log in, Orchestrator checks your group membership, then confirms your identity against the AD database and Identity Server. You are then granted access rights according to your Orchestrator configuration. If your system administrator changes your group membership from group X to group Y while you have an active session, the changes are interrogated by Orchestrator once every hour or the next time you log in.
  • The only way to configure access rights that persist between sessions, regardless of how group membership changes, is to assign a role to the user account directly and not through group membership.
  • AD users whose inherited access-rights (from group memberships) cannot be determined behave like local users, meaning they rely solely on roles assigned to the user account.
  • Groups in AD sync with Orchestrator, but changes made in Orchestrator do not affect user configuration in AD.

已知问题

  • Due to various networking or configuration issues, there is a chance that not all domains displayed in the Domain Name drop-down list are accessible.
  • Changes made to user or group names in AD are not propagated to Orchestrator.
  • 使用新添加的双向信任域更新域列表最多可能需要一个小时。
  • GetOrganizationUnits(Id)GetRoles(Id) 请求仅返回为自动配置的用户显式设置的文件夹和角色。从组配置继承的文件夹和角色可通过 /api/DirectoryService/GetDirectoryPermissions?userId={userId} 端点检索。
  • 用户界面也是如此,“用户”页面上仅显示显式设置的文件夹和角色。相反,继承的文件夹和角色具有新的专用位置,即“用户权限”窗口(“用户”>“更多操作”>“查看权限”)。
  • Users do not inherit alert subscription settings from the parent group, nor do they receive any alerts by default. To have access to alerts, you are required to grant the corresponding permissions to the user explicitly.
  • 删除目录组并不会删除相关目录用户的许可证,即使删除组后取消了从任何文件夹中分配用户。释放许可证的唯一方法是关闭机器人托盘。
  • 在某些浏览器上,使用您的 AD 凭据登录 Orchestrator 时仅需要用户名。无需同时指定域。因此,如果 domain\username 语法不起作用,请尝试仅填写用户名。

Audit considerations

  • 用户成员身份:用户 [用户名] 已分配到以下目录组 [用户在当前会话中继承访问权限的目录组]。
  • 自动配置:从以下目录组 [用户在当前会话中继承访问权限的目录组] 自动配置用户 [用户名]。

Disabling concurrent execution


Optimizing resource consumption and maximizing execution capacity in modern folders involves little to no control over how users are allocated to jobs. For scenarios where a credential cannot be used more than once at a time (for example, with SAP), you can limit concurrent execution for unattended processes. This helps modulate the job allocation algorithm by restricting a user from simultaneously executing multiple jobs.

Users permissions


要能够在“用户”和“个人资料”页面上执行各种操作,需要获得相应的权限:

  • Users - View - Displaying the Users and Profile pages.
  • Users - Edit - Editing user details and settings on the Profile page, and activating/deactivating users on the Users page.
  • Users - View and Roles - View - Displaying user permissions in the User Permissions window.
  • Users - Edit and Roles - View - Editing role assignments on the Manage Access > Assign Roles page.
  • Users - Create and Roles - View - Creating a user.
  • Users - View and Roles - Edit - Managing roles in the Manage Users window, opened from the Manage Access > Roles page.
  • Users - Delete - Removing a user from Orchestrator.

阅读有关角色的更多信息。

未生效的权限


尽管您可以为任何权限选择所有可用权限(查看编辑创建删除),但以下权限对所列权限无效:

Permission

Category

Edit

Audit
Execution Media
Logs

Create

Audit
License
Settings
Monitoring

Delete

Alerts
Audit
Settings
Logs
Monitoring

例如,这是因为无法编辑系统生成的日志。

Security considerations


Basic authentication

By default, Orchestrator does not allow user access via basic authentication. This functionality can be enabled by adding and configuring the Auth.RestrictBasicAuthentication setting. This enables you to create local accounts that can access Orchestrator using their basic authentication credentials, allowing you to maintain existing integrations that relied on basic authentication when calling Orchestrator API.

Enabling basic authentication can be done when creating and editing accounts.

Account lockout

By default, after 10 failed login attempts, you are locked out for 5 minutes.

System administrators can customize the Account Lockout settings from the host Management portal.

Logging in with the same account on a different machine disconnects the user from the first machine.

Updated 13 days ago


Accounts and roles


On the Manage Access page you can define and assign roles. In Orchestrator, you use roles to control the level of access an account should have.
On this page we go over the notions you need to understand to effectively plan and implement your access control strategy.

建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。