This section describes the tools in the admin UI to help you manage your AppGate ZTNA system.
Navigating the Admin UI tools
You can navigate the system using the main menu at the top of the screen where the Collective name is displayed (PURPLE-2 in this instance) and the search bar can be found.
Search
Search is available at the top of every page. Simply enter a search term (see syntax below) and the system performs a contextual search. The search can include “All Categories” when on the home page. When on a specific page, such as Appliances, search results will automatically change to filter on the context of that page.
To clear the search field, click the “x” icon.
Search History
Clicking on the Search field will display the search history with up to 100 items. Search history can be cleared if required.
Search Filter
By clicking on the filter icon on the right, you can include additional search terms to filter the results to match specific criteria such as name, health, site, status, or tags, depending on the page you are on.
Search Syntax
The following table provides specific syntax that can be used in your search:
Normal text search | pac | pac exists somewhere in the record(s) |
IP based search | fd00:ffff:a::/48 or 172.17.93.0/24 | An IP address exists in the range specified |
Not search | -pac | pac does not exist somewhere in the record(s) |
Qualified search | name: pac | The Name field contains the word pac |
Qualifier with several words (curly brackets) | name: {pac pac2} | The Name field contains both the word pac and pac2, in any order. |
Exact string (double quotes) | name: "pac pac2” | The Name field contains the words pac pac2 in that exact order including whitespace. |
Search Settings 
The number of search results shown is determined by the page settings which has a default of 30 items. If they do not fit on the current page, then the page length can be extended to 100, 300, or 1000 lines.
Alerts
Clicking on the alert (bell) icon displays new messages for the administrators of the system. Admin messages relate to the function, settings, or configuration of the system and typically do not include the health status of an appliance. Messages are shown as Info, Warning, or Error. There is a list of all the different messages you are likely to encounter in the Appendix and includes suggested actions to resolve messages.
Only 30 days of messages are kept; older ones are deleted. There will still be a copy in the audit logs.
Only 100 messages of the same type will be kept; 100+ occurrences will be shown thereafter.
The displayed messages:
Have a badge to show if they are new.
Can be marked as resolved.
Can be deleted (if resolved).
Avatar
The Avatar provides access to:
Preferences. Contains the Verbose Menu control and light/dark theme selection.
Admin Guide. Takes you to this admin guide.
About AppGate ZTNA. Displays the system version number and a link to Release Notes.
Sign out. Logs you out of the admin UI at which point admin tokens are revoked. Therefore using the Sign out option is a better way to leave the admin UI than to simply close it.
Actions
On certain pages it is possible to Import items and to perform bulk actions.
Import
Individual items such as Entitlements and Policies can be exported. It is then possible to import these items into another Collective using this action.
Bulk Actions
Bulk Actions allow operations to be performed on multiple items at once.
Selecting items
Bulk actions are performed on all the selected items that are visible on the current page. You can select items in the following ways:
Select individual items: Select the box for each item line by line.
Select all items: Select the box in the header bar.
Perform a search for the items: Then select the boxes for all items in the search.
Performing bulk actions
The following bulk actions can be taken:
Add/Remove Tag. Adds or removes tags from selected items.
Delete. Deletes selected items.
Enable. Enables selected items, such as Policies or Entitlements.
Disable. Disables selected items, such as Policies or Entitlements.
Export. Exports selected items.
Change Site. Changes the Site for selected Entitlements.
Split Mixed Policy. Available in the Policies page. In version 5.5, Mixed policies were replaced by three separate policy types: Access, Admin, and Device. Split Mixed Policy will analyze selected mixed policies and create the renamed, separate policies. The mixed policy will be disabled.
Assign to Policy. Available in the Entitlements page. When assigning Entitlements to a policy, create the Policy before trying to perform this bulk action. Only DNS and Access policy types are shown in the suggestions.
Apply Condition. Available in the Entitlements page. This will always impose a single Condition on selected Entitlements. Previously applied Conditions will be gone after this action.
If you want to always allow the action: Select Always from the Condition list. This is effectively the bulk remove option.
If you want risk-based access: Create a Condition based on risk first and use that (this bulk action does not set the middle option).
If you want a specific Condition: Select it from the list (use the list exactly as it is now).
If you want to use multiple Conditions in the Entitlement, either:
Use the bulk action to add the first Condition, then add the next Condition manually, or
Create a more complex Condition and add that
Merge. Available in the Entitlements page. Merging is possible only when all Entitlements are assigned to the same Site. When you merge, several things will happen:
A new, disabled “Named” Entitlement is created
All Actions from the selected (merged) Entitlements are added to the new Entitlement
Conditions are also merged using all below are true (AND logic). This ensures security requirements are maintained, however the Conditions will likely need editing before they are used.
The selected (merged) Entitlements are tagged so they are easy to disable or delete.
Configure from source. Available in the Appliances page. First select all the targets that will receive these settings, then select Bulk Actions > Configure from source. In the Configure from Source – Bulk Action modal, select the Source Appliance and Fields to Replace. These settings are then copied from the source to all the selected target appliances.
Refresh
On certain pages, there is a refresh button and an option to set Auto-Refresh (1 minute).
The dial icon shows you when the form is about to refresh.
Details View
On certain pages, once the page contains the visible items of interest, it is possible to use Details view. Select the settings icon to change to the Details view. This expands each item to show you more of the detail contained within.
.png?sv=2022-11-02&spr=https&st=2026-04-16T22%3A51%3A23Z&se=2026-04-16T23%3A06%3A23Z&sr=c&sp=r&sig=LoiSAyvpnx%2FMGnTuOO675Gc0858YyZeMzaPv07f1mp0%3D)
You can click Details again to go back to normal list view.
Action Buttons
Some pages include action buttons for individual items. Action buttons are accessed by clicking the three dots icon (
) to the right of each line item <Actions> button within the item. They are contextual, changing depending on the type of item and the state of the item.
