--- title: "Configuring admin roles" slug: "configure-admin-roles-v7-0" description: "Manage admin roles effectively with fine-grained access control, ensuring secure delegation of privileges in the admin UI for enhanced security." tags: ["Admin Roles", "Admins"] updated: 2026-10-13T18:06:04Z published: 2026-10-13T18:06:04Z canonical: "support.appgate.com/configure-admin-roles-v7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring admin roles 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](/v1/docs/admin-user-access-v7-0). - ***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](/v1/docs/local-users-v7-0). For security best practices, see the section related to admin roles in [System security - best practices](/v1/docs/system-security-best-practices-v7-0#7-admin-roles1). > [!NOTE] > **NOTE** > > To configure MFA for an administrator, see [MFA for admins.](/v1/docs/mfa-for-admins-v7-0) --- ## 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: - privileges on - privileges on - privileges on - privileges on (for user-sign-ins) - privileges on - privileges on ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/image(109).png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A51Z&se=2026-11-21T22%3A39%3A51Z&sr=b&sp=r&sig=DOqbueBm6N%2BmX0FWnUYielYwH%2B50tDHe9klOVeGGqDs%3D) --- ## 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] > 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.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/admin_role_privileges.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A51Z&se=2026-11-21T22%3A39%3A51Z&sr=b&sp=r&sig=y3AErnDbjbett9bTzyGFpt7mM8z8AyivqfzrMtnxGP0%3D) - *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](/v1/docs/admin-roles-v7-0#privilegetarget-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.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/privilege_by_tag_policy.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A51Z&se=2026-11-21T22%3A39%3A51Z&sr=b&sp=r&sig=bIHsAELARetAetEj3A5gvIeqsEBvPMOiIRP3Fm%2BzULo%3D) - *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](/v1/docs/configuring-policies-v7-0#admin-policy) 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.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/three_dots.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A51Z&se=2026-11-21T22%3A39%3A51Z&sr=b&sp=r&sig=WBMmZghm1ocU%2BGTiwJ4OfWmOtlug2INRV07EBChUdMA%3D)) 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 |