Citrix Provisioning

Administrative roles

The administrative role assigned to a group of users controls viewing and managing objects within a Citrix Provisioning server implementation. Citrix Provisioning uses groups that exist within the network, Windows, or Active Directory Groups. All members within a group have the same administrative privileges within a farm. An administrator has multiple roles if they belong to more than one group.

The following administrative roles can be assigned to a group:

  • Farm administrator
  • Site administrator
  • Device administrator
  • Device operator

After a group is assigned an administrative role using the Citrix Provisioning console, certain requirements are required. If a member of that group attempts to connect to a different farm, a dialog displays requesting that you identify a provisioning server within that farm. Use either the Windows credentials you are currently logged in with, the default setting, or enter your Active Directory credentials. Citrix Provisioning does not support using both domain and workgroups simultaneously.

The role associated with the group determines your administrative privileges within this farm. Group role assignments can vary from farm to farm.

Managing farm administrators

Farm administrators view and manage all objects within a farm, and also create sites and manage role memberships throughout the entire farm. In the Citrix Provisioning console, administrators perform farm-level tasks.

Image of the farm architecture

When the farm is first configured using the Configuration Wizard, the administrator that creates the farm is automatically assigned the Farm Administrator role. While configuring the farm, that administrator selects the option to use either Windows or Active Directory credentials for user authorization within the farm. After an administrator runs the Configuration Wizard, more groups can be assigned the farm administrator role in the console.

To assign more farm administrators

  1. In the console, right-click on the farm to which the administrator role is assigned, then select Properties. The Farm Properties dialog appears.
  2. On the Groups tab, highlight all the groups assigned administrative roles in this farm, then click Add.
  3. On the Security tab, highlight all groups to which the farm administrator role is assigned, then click Add.
  4. Click OK to close the dialog box.

Note:

The authorization method displays to indicate if Windows or Active Directory credentials are used for user authorization in this farm. The groups for administrative roles are limited to groups in the native domain and domains with a two-way trust to the native domain.

Managing site administrators

Site administrators have full management access to all the objects within a site. For example, the site administrator manages provisioning servers, site properties, target devices, device collections, virtual disk assignments pools.

Image of the site and collections

If a farm administrator assigns a site as the owner of a particular store, the site administrator can also manage that store. Managing a store includes adding and removing virtual disks from shared storage or assigning provisioning servers to the store. The site administrator can also manage device administrator and device operator memberships.

To assign the site administrator role to one or more groups and its members

  1. In the console, right-click on the site for which the administrator role is assigned, then select Properties. The Site Properties dialog appears.
  2. Click the Security tab, then click the Add button. The Add Security Group dialog appears.
  3. From the menu, select each group to associate with the site administrator role, then click OK.
  4. Optionally, repeat steps 2 and 3 to continue assigning more site administrators.
  5. Click OK to close the dialog.

Managing device administrators

Device administrators manage device collections to which they have privileges. Management tasks include assigning and removing a virtual disk from a device, editing device properties and viewing read-only virtual disk properties. Device collections consist of a logical grouping of devices. For example, a device collection might represent a physical location, a subnet range, or a logical grouping of target devices. A target device can only be a member of one device collection.

To assign the device administrator role to one or more groups and its members

  1. In the console, expand the site where the device collection exists, then expand the Device Collections folder.
  2. Right-click on the device collection that you want to add device administrators to, then select Properties. The Device Collection Properties dialog appears.
  3. On the Security tab, under the Groups with Device Administrator access list, click Add. The Add Security Group dialog appears.
  4. To assign a group with the device administrator role, select each system group that requires device administrator privileges, then click OK.
  5. Click OK to close the dialog box.

Managing device operators

A device operator has administrator privileges to perform the following tasks within a device collection for which they have privileges:

  • Boot and reboot a target device
  • Shut down a target device

To assign the device operator role to one or more groups

  1. In the console, expand the site where the device collection exists, then expand the Device Collections folder.
  2. Right-click on the device collection that you want to add device operators to, then select Properties. The Device Collection Properties dialog appears.
  3. On the Security tab, under the Groups with Device Operator access list, click Add. The Add Security Group dialog appears.
  4. To assign a group the Device Operator role, select each system group that requires device operator privileges, then click OK.
  5. Click OK to close the dialog box.

Modifying the search approach for AD environments

For some AD environments containing configurations with complex nested groups and domains with many trust associations, the default method might be unable to find the user’s expected administrative memberships. To resolve such scenarios, use a registry setting to change the search approach:

  1. In the registry setting, locate HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ProvisioningServices.
  2. Create a DWORD named “DomainSelectOption”.
  3. In the DomainSelectOption DWORD, set one of the following values (in decimal format) for the desired search approach:
  • 0 – The default search. This method searches the user’s domain followed by administrative group domains.
  • 1 – Search in the user’s domain and in the administrative group domain, followed by other trusted domains within a user’s domain.
  • 2 – Obsolete.
  • 3 – Search in the user’s domain followed by administrative group domains. The groups that are discovered are further enumerated over the parent’s domain.
  • 4 – Search the user’s domain and in the administrative group domain, followed by other trusted domains within a user’s domain. The groups that are discovered are further enumerated over the parent’s domain.
  • 5 - Search the user’s group membership from token groups in the user’s domain and in the administrative group domain.
  • 6 - Search the user’s group membership from token groups in the user’s domain and in the administrative group domain, followed by other trusted domains within a user’s domain.
  • 7 - Search the user’s group membership directly from authorization groups.
  • 8 - Search the user’s group membership directly as “Member Of” groups.

About whitelist methods

Use the information in this section for diagnostic purposes only. Sometimes, it may helpful to specify a specific domain for a user group to search against. To perform this task, update the registry and provide a JSON file for the white list domain. Use only the default search option. If you are providing a black list domain, it is excluded from the white list domains. No search occurs when the end list is empty.

In the registry:

  1. Locate HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ProvisioningServices.
  2. Create a DWORD entry WhitelistOnly. Set the value to 1 to enable white list search.