Configuring admin roles

Prev Next

In addition to fine-grained control over user access to protected hosts, AppGate ZTNA provides fine-grained control over access to the admin UI. Use admin roles to delegate administration rights or to grant specific privileges for areas of the admin UI. Admin roles are assigned to users using policies.


Before configuring admin roles

Before you configure admin roles, confirm the following:

  • System administration privileges. Confirm which admin privileges you will delegate and which targets they apply to. For more information, see Admin user access.

  • Tags. Confirm which tags you will use to restrict the scope of admin privileges.

  • Create local database account. If you need to create a local user account to add an additional administrator, see Local users.

For security best practices, see the section related to admin roles in System security - best practices.

NOTE

To configure MFA for an administrator, see MFA for admins.


Admin role templates

Preset admin role templates provide an easy way to configure access to pages such as the Dashboard. These pages work differently from single-function pages because they can contain Target Items. If the required privileges are not configured, the administrator has only partial access to the information. For the Dashboard View, the preset template provides the following privileges:

  • <View> privileges on <AdminMessage>

  • <CheckStatus> privileges on <Appliance>

  • <View> privileges on <SessionInfo>

  • <View> privileges on <TokenRecord> (for user-sign-ins)

  • <View> privileges on <RegisteredDevice>

  • <View> privileges on <User License>


Creating an admin role

To create an admin role:

  1. Go to Admin Roles (Access > Admin Roles)  and select +Add. You can start from a preset template, or create your own role by selecting Generic.

NOTE

An admin user cannot create a role with more privileges than they currently have. The roles they create can include only a subset of their current privileges.

  1. Complete the following fields:

  • Name. Enter a name that is alphanumeric and may include spaces, underscores, and dashes.

  • Notes. Optional. Enter notes for the role.

  • Tags. Select +Add to add tags to the role.

  • Privileges. Privileges define the rights assigned to an admin role. You can add multiple privileges to one role, such as view/edit/delete policies tagged with CustomerA.

By default, admin roles use <All> privilege types on <All> target items, which grants full system administration privileges across all entities. When you delegate administration, change these settings to control permitted access and actions with the same granularity used to control user access to network resources.

You can apply privileges as <All> or as a specific privilege type to a target type (such as appliances or entitlements) or to a specific target (such as a named appliance or entitlements tagged with <admin1-tag>).

To add a privilege to an admin role, select +Add to open the Privileges settings:

Edit privileges for identity provider settings, including name and tag options.

  • Privilege Type. Select the action the administrator can perform, such as Delete or Export. The default is All actions, which can be applied to all target items.

  • Target Item. Select the feature the action applies to, such as Condition or License. The list of target items in the drop-down list depends on the selected privilege type. See the Privilege-Target Combinations table below. You can further restrict target items using the optional Limit Scope of Privilege settings.

  • Limit Scope of Privilege by Name. Restrict the target further to features with the specified names.

  • Limit Scope of Privilege by Tag. Restrict the target further to features with the specified tags. In the example above, an admin role is created to allow an administrator to edit the local database. In the example below, the privilege will be restricted to policies tagged mobile.

Settings for privileges including view type and mobile policy tag options.

  • Default tags. These tags are added by default when creating a new instance of the specified target. Changing default tags requires edit rights on the target.

  1. Save the admin role.

Assigning admin roles

For the system administrator user account, the Builtin Administrator Policy assigns the system administration role to that account.

For new administrator accounts, you will create additional admin policies to assign these admin roles.


Managing admin roles

On the Admin Roles page, use the action button—the three dots icon (Three circular shapes stacked vertically on a dark background, selected to access a menu.) to the right of each line item—to access the following option:

  • View Linked Policies. Displays the policies linked to that admin role.


Privilege-Target combinations

Privilege Type

Target Item

All

Assign Function

Backup

Check Status

Create

Delete

Download Logs

Edit

Export

Get User Attributes

Reboot

Renew Certificate

Reevaluate

Revoke

Tag

Test

Upgrade

View

Admin Role

yes

yes

yes

yes

yes

yes

Admin Message

yes

yes

yes

yes

Allocated IP

yes

yes

Appliance

yes

yes

yes

yes

yes

yes

yes

yes (excludes assign function)

yes

yes

yes

yes

yes (for appliance commands)

yes

yes

Appliance Customization

yes

yes

yes

yes

yes

yes

Audit Log

yes

yes

Auto Update

yes

yes

yes

Denylist

yes

yes

yes

yes

CA Certificate

yes

yes

yes

yes

yes

Client Profile

yes

yes

yes

yes

yes

yes

yes

Condition

yes

yes

yes

yes

yes

yes

yes

Criteria Script

yes

yes

yes

yes

yes

yes

yes

Device Claims Script

yes

yes

yes

yes

yes

yes

Discovered App

yes

yes

yes

Entitlement

yes

yes

yes

yes

yes

yes

Entitlement Script

yes

yes

yes

yes

yes

yes

FIDO2 Device

yes

yes

yes

File

yes

yes

yes

yes

Global Setting

yes

yes

yes

yes

Identity Provider

yes

yes

yes

yes

yes

yes

yes

yes

IP Pool

yes

yes

yes

yes

yes

yes

License

yes

yes

yes

yes

Local User

yes

yes

yes

yes

yes

yes

MFA Provider

yes

yes

yes

yes

yes

yes

yes

OTP Seed

yes

yes

yes

Policy

yes

yes

yes

yes

yes

yes

Registered Device

yes

yes

yes

yes

yes

Ringfence Rule

yes

yes

yes

yes

yes

yes

Secret

yes

yes

yes

yes

yes

yes

Service User

yes

yes

yes

yes

yes

yes

Session Info

yes

yes

Site

yes

yes

yes

yes

yes

yes

Token Record (Deprecated)

yes

yes

yes

yes

Trusted Certificate

yes

yes

yes

yes

yes

User Claim Script

yes

yes

yes

yes

yes

yes

User License

yes

yes

yes

ZTP

yes

yes

yes

yes

yes