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>
.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A29%3A24Z&se=2026-11-21T21%3A42%3A24Z&sr=b&sp=r&sig=IPFGlE3UBNhREUIHRnpQ3FR8rjcZptB4kFl0bl0k58U%3D)
Creating an admin role
To create an admin role:
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.
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:

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.

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.
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 (
) 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 | |||||||||||||