--- title: "Admin UI access and tools" slug: "admin-ui-tools-v7-0" description: "Manage your AppGate ZTNA admin UI, ensuring secure access, role-based privileges, and efficient system navigation for optimal performance." tags: ["Search Functionality", "Admin UI"] updated: 2026-11-19T19:15:48Z published: 2026-11-19T19:15:48Z canonical: "support.appgate.com/admin-ui-tools-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. # Admin UI access and tools This section describes how to [access the admin UI](/v1/docs/admin-ui-tools-v7-0#accessing-the-admin-ui), [remove the browser security warning](/v1/docs/admin-ui-tools-v7-0#removing-the-browser-security-warning), and the [admin UI’s tools](/v1/docs/admin-ui-tools-v7-0#using-the-admin-ui). The AppGate ZTNA admin UI is an API-driven, secure web front end that provides a central point of control for the entire Collective, including across distributed networks. The information displayed in the admin UI and the admin actions available depend on the administration privileges assigned to each user. For more information about admin roles and privileges, see [Access Management](/v1/docs/access-management-v7-0). --- ## Accessing the admin UI Access the admin UI and API through the [Unique Admin Hostname](/v1/docs/adding-a-controller-v7-0#admimapi-tls-connection). Use this hostname rather than an alternative hostname or IP address, because some browsers verify the URL against the certificate and require an exact match before allowing access. > [!WARNING] > CAUTION > > Do not allow admin access directly from the internet. See [System security - best practices](/v1/docs/system-security-best-practice-v7-0). Nominate one Controller as the point where all admin tasks are performed to avoid database conflicts. Although this may appear to reduce high availability (HA), configuration changes such as adding a new entitlement are rarely time-critical. For time-critical operations—such as reading user IP tunneling addresses through the REST API—use the [profile DNS name](/v1/docs/client-profiles-v7-0) (the same name clients use, provided as part of the profile link). The profile DNS name supports multiple A records and provides HA for these read-only REST API calls. Sign in to the admin UI regularly to review [admin messages](/v1/docs/admin-ui-tools-v7-0#alerts) and [appliance health status](/v1/docs/home-dashboard-v7-0#health-appliances1). Missing these messages may cause you to overlook critical alerts such as [appliance certificate](/v1/docs/internal-certificates-v7-0) expiry. --- ## Removing the browser security warning The admin UI uses a self-signed root certificate, which causes browsers to display an "unsafe" warning. To avoid this warning, use an externally signed certificate. The following alternatives are also available if you want to continue using the root certificate. ### Add a trusted third-party certificate [Add a trusted third-party certificate](/v1/docs/addingrd-party-certificates-v7-0) for the [Admin/API TLS connection](/v1/docs/adding-a-controller-v7-0#admimapi-tls-connection) on port 8443 of your Controller appliance. You can either upload a PKCS #12 file that includes an existing wildcard certificate and private key, or generate a new private key and certificate using a certificate signing request (CSR). Use the CSR option to limit distribution of corporate wildcard certificates and private keys. > [!NOTE] > **NOTE** > > Repeat this process for each Controller, even though only one Controller is used for administration. ### Add an exception for the self-signed root certificate Add a browser exception for the self-signed certificate. The steps differ by browser: - **Safari** requires you to add an exception for the self-signed root CA. - **Firefox** uses its own Certificate Manager. Add an exception for the CA before accessing the admin UI. The browser continues to show the connection as untrusted. - **Chrome** requires you to add an exception for the root CA before accessing the admin UI. Chrome uses the native OS certificate store. After you save the root CA to the store, Chrome allows access without showing an untrusted warning. This process is the same as for the AppGate ZTNA client, which also uses native OS certificate stores. ### Trust the self-signed root certificate Add the Controller's self-signed root certificate to the local certificate store on each administrator device. 1. Obtain the certificate from the [Certificate Authority](/v1/docs/internal-certificates-v7-0#certificate-authority) page in the admin UI. The Controller produces a `.pem` or `.cer` file depending on your device. Windows does not recognize `.pem` files; rename the file to `.cer` before proceeding. Both formats use the same encoding. 2. Install the certificate: - **Windows (all users):** Run `certutil -addstore "Root" C:\AGSDPcert.cer"` with administrator privileges. This adds the certificate to the local machine root certificate store. - **Windows (current user):** Open the certificate file and select the *Current User* option, accepting the location defaults. The certificate is saved to **Certificates—Current User > Intermediate Certification Authorities > Certificates**. Open the Windows Certificate Manager (`certmgr.exe`) as administrator and move the certificate to **Trusted Root Certification Authorities > Certificates**. - **macOS (terminal):** Run `sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain <cert>.crt` - **macOS (UI):** Install the certificate into the keychain, then open the certificate and set the trust level to *Always Trust*. --- ## Using the admin UI Navigate the system using the main menu at the left of the screen. The menu will be collapsed at sign-in. Select the menu icon to expand it. The menu displays the Collective name at the bottom. | Collapsed menu | Expanded menu | | --- | --- | | ![AppGate's collapsed menu.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/collapsed_menu.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=y%2BtTyVVSzN4AK2gc3SK1icB7ON2KIc4SErBNRBOQT8E%3D) | ![AppGate's expanded menu.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/expanded_menu.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=i3Vqkdec9wBFNN5g%2FzoYdkzT53NtvgkdgaHVXSjHLjY%3D) | ### Jump to To navigate quickly through the admin UI, select **Jump to** or press `CMD+K`. Enter a keyword in the field that appears. Matching destinations appear as you type. Select a destination to go to that location. ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/jump_to_field.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=gNieFIJ9mNDNf16NJd5Tdglo%2FW02EPxz6irmFS7rRD4%3D) ### Search The search bar appears at the top of the page. ![AppGate Policies page showing a search bar for finding policies and navigation controls.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/search-bar-post-7-0.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=GqOYaSqXLFHMq0wMVTsDREL1hN4Jvzkb4BpITLhXb30%3D) Enter a search term and the system performs a contextual search. On the home page, search covers all categories. On a specific page—such as **Appliances**—results are automatically filtered to the context of that page. To clear the search field, select the **x** icon. #### Search History Click the search field to display your search history. The history stores up to 100 items and can be cleared at any time. ![Search bar displaying options for policies including 'connector' and 'AWS'.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/search_bar_open.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=%2BfQQsBDT9cBel74tt00HrE5Oiqcl%2BZbEPLAKkv9hBrw%3D) #### Search Filter Select the filter icon on the right of the search field to add search terms that filter results by criteria such as name, health, site, status, or tags. Available criteria vary by page. ![Search interface for policies with fields for keywords, name, type, status, and tags.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/search_filters_new.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=ZuQPTPjbT3XGNEA5HvpD%2F%2BHiBiqXUpPROBWkS7K0438%3D) #### Search Syntax The following table describes the syntax you can use in search: | Syntax | Example | Description | | --- | --- | --- | | Normal text | `pac` | Returns records that contain "pac" anywhere in the record. | | IP based | `fd00:ffff:a::/48` or `172.17.93.0/24` | Returns records that contain an IP address within the specified range. | | Exclusion | `-pac` | Returns records that do not contain "pac". | | Qualified | `name: pac` | Returns records where the Name field contains "pac". | | Qualified with multiple words | `name: {pac pac2}` | Returns records where the Name field contains both "pac" and "pac2" in any order. | | Exact string | `name: "pac pac2”` | Returns records where the Name field contains "pac pac2" in that exact order, including whitespace. | #### Search Settings ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag62-cog.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=YsFcq7NoXKyH%2FvTWBT7uwJCciFQ649X88WOJjUPf%2FkU%3D) The number of results displayed per page defaults to 30 items. You can extend the page length to 100, 300, or 1,000 items using the page settings. ### Alerts Select the alert (bell) icon to view new messages for system administrators. Admin messages relate to system function, settings, or configuration and do not typically include appliance health status. Messages are categorized as Info, Warning, or Error. The Appendix [lists all possible messages](/v1/docs/admin-messages-v7-0) and includes suggestions for each. ![Warning message indicating administrative API requests are being made to the system.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/alert_bell_admin_msg.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=CiKr1noxX9a3Oo2p3jvQl2mmJ04A08uRdRg6qdqENHI%3D) The following retention limits apply to messages: - Messages older than 30 days are deleted. A copy remains in the audit logs. - A maximum of 100 messages of the same type are retained. Further occurrences are counted and displayed as a total. Each displayed message: - Shows a badge when it is new. - Can be marked as resolved. - Can be deleted after it is resolved. ### Help menu Select the question mark icon at the top-right to open the **Help** menu. The following options appear: - ***Show help.*** Appears when you are in a form. Displays the inline help for each field. Selecting the question mark icon inside a modal window will display inline help for that window. - ***Keyboard Shortcuts***. Opens a window listing keyboard shortcuts for navigating the admin UI. You can also disable and enable keyboard shortcuts from this window. - ***About AppGate***. Displays your current version of AppGate ZTNA and a link to the release notes. - ***Admin Guide***. Opens the Admin Guide. ### User menu Select the avatar at the bottom of the left-hand menu to access the following options: - ***Preferences.*** Contains the light/dark theme selection. - ***Unpin menu.*** Hides the left-hand menu. When unpinned, the menu reappears only when you select the menu icon. It disappears again when you make a selection or click outside the menu. - ***Sign out.*** Signs you out of the admin UI and revokes admin tokens. Use this option rather than closing the browser tab to ensure tokens are properly revoked. ### Actions On certain pages, you can import items and perform bulk actions. #### Import You can export individual items such as entitlements and policies, then import them into another Collective using this action. #### Bulk Actions Bulk actions let you perform operations on multiple items at once. Available bulk actions vary depending on the page. To select items for a bulk action: - **Individual items:** Select the checkbox for each item. - **All items:** Select the checkbox in the header bar. - **Search results:** Search for the items, then select the checkboxes for all returned items. ### Refresh On certain pages, a refresh button is available. The *Auto-refresh (every minute)* configuration is available in the List Settings (cog icon) menu. The dial icon indicates when the page is about to refresh. ![Appliances page displaying sessions, CPU usage, and auto-refresh options for data analysis.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/auto_refresh_options.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=hOgdGt1RpNDALuwuD2fKBgjp7NuFzPoOQvyBCHpg%2BSY%3D) ### Details View On certain pages, you can switch to details view by selecting the settings icon. Details view expands each item to show additional information. Select *Details* again to return to the standard list view. ![AppGate policies list showing enabled DNS and access configurations with details.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/details_view_policies.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=TV5iZv%2BDaT4LB3RR6u11QN8fGNtUI30zizsn3OtNrcM%3D) ### Action Buttons Some pages include action buttons for individual items. Access action buttons by selecting 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%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=WhocqqWjJvUiA5YuxJLqlMYdUzo65q530GUGEHFgeL8%3D)) to the right of a line item. Action buttons are contextual and change based on the item type and state. ![Menu options for downloading profile links and email templates displayed on a screen.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/actions_button_example.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A46Z&se=2026-11-21T22%3A39%3A46Z&sr=b&sp=r&sig=usiov%2FePy%2BQkbI%2BgwTg7EhLbAn8BRDENCvmWDr30IDs%3D)