Configure groups

In Citrix ADM, a group can have both feature-level and resource-level access. For example, one group of users might have access to only selected Citrix ADC instances; another group with only a selected few applications, and so on.

When you create a group, you can assign roles to the group, provide application-level access to the group, and assign users to the group. All users in that group are assigned the same access rights in Citrix ADM.

You can manage a user access in Citrix ADM at the individual level of network function entities. You can dynamically assign specific permissions to the user or group at the entity level.

Citrix ADM treats virtual server, services, service groups, and servers as network function entities.

  • Virtual server (Applications) - Load Balancing(lb), GSLB, Context Switching (CS), Cache Redirection (CR), Authentication (Auth), and Citrix Gateway (vpn)

  • Services - Load balancing and GSLB services
  • Service Group - Load balancing and GSLB Service groups
  • Servers - Load balancing Servers

Create a user group

  1. In Citrix ADM, navigate to System > User Administration > Groups.

  2. Click Add.

    The Create System Group page is displayed.

  3. In the Group Name field, enter the name of the group.

  4. In the Group Description field, type in a description of your group. Providing a good description of the group helps you to understand the role and function of the group in a better way at a later point.  

  5. In the Roles section, add or move one or more roles to the Configured list.

    Note Under the Available list, you can click New or Edit and create or modify roles. Alternatively, you can navigate to System > User Administration > Users and create or modify users.

    localized image

  6. Click Next. On the Authorization Settings tab, you can provide authorization settings for the following resources:

    • Autoscale Groups
    • Instances
    • Applications
    • Configuration Templates
    • StyleBooks
    • Domain Names

    Categories in authorization settings

    You might want to select specific resources from the categories to which users can have access.

    Autoscale Groups:

    If you want to select the specific autoscale groups that user can view or manage, perform the following steps:

    1. Clear the All AutoScale Groups check box and click Add AutoScale Groups.

    2. Select the required autoscale groups from the list and click OK.

    Instances:

    If you want to select the specific instances that user can view or manage, perform the following steps:

    1. Clear the All Instances check box and click Select Instances.

    2. Select the required instances from the list and click OK.

      localized image

    Applications:

    The Choose Applications list allows you to grant access to a user for the required applications. This list provides you the following options:

    • All Applications: This option is selected by default. It adds all applications that are present in the Citrix ADM.

    • All Applications of selected instances: This option appears only if you select instances from the All Instances category. It adds all the applications present on the selected instance.

    • Specific Applications: This option allows you to add the required applications that you want users to access. Click Add Applications and select the required applications from the list.

    • Select Individual Entity Type: This option allows you to select specific type of network function entity and corresponding entities.

      You can either add individual entities or select all entities under the required entity type to grant access to a user.

      The Apply on bound entities also option authorizes the entities that are bound to the selected entity type. For example, if you select an application and select Apply on bound entities also , Citrix ADM authorizes all the entities that are bound to the selected application.

      Note

      Ensure you have selected only one entity type if you want to authorize bound entities.

    You can use regular expressions to search and add the network function entities that meet the regex criteria for the groups. The specified regex expression is persisted in Citrix ADM. To add regular expression, perform the following steps:

    1. Click Add Regular Expression.

    2. Specify the regular expression in the text box.

      The following image explains how to use regular expression to add an application when you select the Specific Applications option:

      localized image

      The following image explains how to use regular expression to add network function entities when you choose the Select the Individual Entity Type option:

      Network function entity types

    If you want to add more regular expressions, click the + icon.

    Note

    The regular expression only matches the server name for the Servers entity type and not the server IP address.

    If you select the Apply on bound entities also option for a discovered entity, user can automatically access the entities that are bound to the discovered entity.

    The regular expression is stored in the system to update the authorization scope. When the new entities match the regular expression of their entity type, Citrix ADM updates the authorization scope to the new entities.

    Configuration Templates:

    If you want to select the specific configuration template that user can view or manage, perform the following steps:

    1. Clear the All Configuration templates check box and click Add Configuration Template.

    2. Select the required template from the list and click OK.

      localized image

    StyleBooks:

    If you want to select the specific StyleBook that user can view or manage, perform the following steps:

    1. Clear the All StyleBooks check box and click Add StyleBook to Group.

    2. Select the required StyleBooks from the list and click OK.

      localized image

      You can select the required StyleBooks when you create groups and add users to that group. When your user selects the permitted StyleBook, all dependent StyleBooks are also selected. The config packs of that StyleBook are also included in what the user has access to.

    Domain Names:

    If you want to select the specific domain name that user can view or manage, perform the following steps:

    1. Clear the All Domain Names check box and click Add Domain Name.

    2. Select the required domain names from the list and click OK.

  7. Click Create Group.

  8.  In the Assign Users section, select the user in the Available list, and add the user to the Configured list.

    Note

    You can also add new users by clicking New.

    localized image

  9. Click Finish.

Note

As a Citrix ADM admin, you can provide either “view-only” permission or “view and edit” permission to your users for individual ADM module UIs based on access policy settings in RBAC. If the user is assigned to two or more groups, that is, if the user is internally mapped to more than one authorization scope and more than one access policy, ADM takes a union of all those groups’ permissions and authorizes the user accordingly.

For example, consider that User1 is assigned to a group that has two access policies, P1 and P2. Each policy has a different type of permission. P1 has “read-only” permission, while P2 has “view and edit” permission. You want your user to view a set of applications as part of the P1 policy, and edit a different set of applications as part of the P2 policy. But as a default behavior, Citrix ADM combines the two permission types and assigns the “view and edit” permission to the user. So your user will now be able to view and edit all the applications.

ADM doesn’t support such use cases where you can assign different types of permissions to the same user. You can assign only one type of permission to your users. ADM can either allow User1 to view all apps or a selected set of apps, or allow User1 to view and edit all apps or selected set of apps.

Manage user access across multiple network function entities

As an administrator, you can manage user access at the individual level of network function entities in Citrix ADM. And, you can dynamically assign specific permissions to the user or a group at the entity level by using regular expression filter.

This document describes how to define user authorization at the entity level.

Before you begin, create a group. See Configure groups on Citrix ADM for more information.

Usage scenario:

Consider a scenario where one or more applications (virtual servers) are hosted on the same server. A super administrator (George) wants to grant Steve (an application administrator) access only to App1 and not to the hosting server.

The following table illustrates this environment, where Server-A hosts applications App-1 and App-2.

Host Server Application (virtual server) Service Service group
Server A App1 App-service-1 App-service-group-1
Server A App2 App-service-2 App-service-group-2

Note

Citrix ADM treats virtual server, services, service groups, and servers as network function entities. The entity type virtual server is referred as application.

To assign user permissions to network function entities, George defines the user authorization as follows:

  1. Navigate to Account > User Administration > Groups and add a group.

  2. In the Authorization Settings tab, select Choose Applications.

  3. Choose Select Individual Entity Type.

  4. Select the All Applications entity type and add App-1 entity from the available list.

  5. Click Create Group.

  6. In Assign users, select the users who require the permission. For this scenario, George selects Steve’s user profile.

  7. Click Finish.

With this authorization setting, Steve can manage only App-1 and not other network function entities.

Note

Ensure the Apply on bound entities also option is cleared. Otherwise, Citrix ADM grants access to all network function entities that are bound to App-1. As a result, grants access to the hosting server as well.

A super administrator can specify the regular expressions (regex) for each entity type. The regular expression is stored in the system to update the user authorization scope. When new entities match the regular expression of their entity type, Citrix ADM can dynamically grant users access to the specific network function entities.

To grant user permissions dynamically, the super administrator can add regular expressions in the Authorization Settings tab.

In this scenario, George adds App* as a regular expression for the Applications entity type and the applications that match the regex criteria appear in the list. With this authorization setting, Steve can access all the applications that match the App* regex. However, his access is limited only to the applications not to the hosted server.

Mapping of RBAC when upgrading Citrix ADM from 12.0 to later releases

When you upgrade Citrix ADM from 12.0 to 13.0, you do not see the options to provide “read-write” or “read” permissions while creating groups. These permissions have been replaced by “roles and access policies,” which give you more flexibility to provide role-based permissions to the users. The following table shows how the permissions in release 12.0 are mapped to release 13.0:

12.0 Allow Applications Only 13.0
admin read-write False admin
admin read-write True appAdmin
admin read-only False readonly
admin read-only True appReadonly