--- title: "Configuring Application Discovery" slug: "configure-application-discovery-v7-0" description: "Explore the Discovered Apps page for insights on app usage, user access, and entitlement configurations, enhancing your application management strategy." tags: ["Optimizer", "Application Discovery", "Discovered Apps"] updated: 2026-10-28T13:14:08Z published: 2026-10-28T13:14:08Z canonical: "support.appgate.com/configure-application-discovery-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 Application Discovery The **Discovered Apps** page (Usage > Discovered Apps) displays usage data for apps defined by entitlements with broad access rights. A system supports up to 5,000 discovered apps and 5,000 users per application. Analysis runs every hour. In version 6.5 and earlier, the limit is 5,000 user groups per application. In version 6.6 and later, the limit is 200 user groups. > [!NOTE] > **NOTE** > > The **Discovered Apps** page remains empty until traffic passes through entitlements with broad host definitions and the analysis runs at 00:00 UTC. Discovered apps can take up to 15 minutes to appear because values are sent at 15-minute intervals. --- ## The Discovered Apps page The **Discovered Apps** page displays the following information: - ***Host***. The hostname of the discovered app. Because Gateway traffic is IP-based, the displayed hostname is a best guess. Zone transfer is strongly recommended for accurate Host values. When zone transfer is not enabled, the system uses the following: - A reverse DNS lookup using the Site or appliance DNS server. - The port 443 certificate name on public IPs. - ***Port/Type***. The TCP port accessed. The port name appears next to it in parentheses. - ***Users***. The number of users who have accessed this app. - ***Connected Entitlement.*** The entitlement associated with the app. - ***Last Accessed***. The date (UTC) the app was last accessed. - ***Last Modified***. The date and time (UTC) the associated policy or was last modified. Select a discovered app to open the **Discovered App Details** page. --- ## Application Discovery actions menu Use the Actions drop-down menu at the top-right of the **Discovered Apps** page to perform the following actions: - ***Configure***. Opens the **Configure Discovered Apps** window, where you can change how discovered app data is collected and presented. Configure the following: - *Custom App Types*. Enter a name and ports. - *Claim for Usage Data.* Select **Use Default** or **Override with custom claim**. If you select **Override with custom claim**, a drop-down appears from which you can select a claim. - ***Troubleshoot***. Displays when the three data sets used in the analysis were last updated. --- ## Configuring access and Discovered App Details ### Configure access On the **Discovered App Details** page, use the fields under ***Complete These Tasks to Configure Access*** to define an entitlement and add it to a policy. To create an entitlement: 1. Select **Define Entitlement**. In the **Related Apps** tab at the bottom of the page, the drop-down displays the included ports. If you need to add more ports: - In the **Related Apps** tab, select the checkbox for each port you want to add, or use the ***Add Port Range*** fields to add a port range. 2. Confirm the included ports and select **Continue**. The **Define Entitlement** window opens. 3. In the **Define Entitlement** window, select *Yes*, *create a new entitlement* or *No, add action to an existing entitlement.* 4. If you select *Yes*, complete the following fields: - ***Entitlement Name***. Enter a name for the entitlement. - ***Status***. Select *Enabled* or *Disabled.* - ***Tags***. Select **+Add** to add tags to the entitlement. 5. If you select *No, add action to existing entitlement*, use the drop-down to select an existing entitlement. 6. The ***Ports*** field is populated with the ports you previously included. 7. Select **Save**. A confirmation window indicates that the app details have been added as an action entry in the entitlement. To add the entitlement to a policy: 1. Under *Complete These Tasks to Configure Access,* select **Add to Policy**. The **Groups** tab opens. 2. In the **Groups** tab, select the checkboxes for the groups you want to have access, then select **Continue**. 3. In the **Add to Policy** window, select an existing policy from the drop-down or type a name to create a new policy. Click **Save**. 4. After you save, the **Changes Detected** window appears and recommends clearing usage data before the next analysis. This ensures that the next analysis excludes data from the groups you added to the policy. Select the checkbox and click **Confirm** to remove data from the current app and all related apps selected when the entitlement was defined. > [!NOTE] > **NOTE** > > Because the mapping to the “groups” user claim is string-based, consider which AD (or other IdP) is used in the AppGate ZTNA IdP configuration when multiple IdPs are listed. The same group name can occur in two different ADs. > [!NOTE] > **NOTE** > > The port 443 certificate name lookup on public IPs can return a glob hostname (`*.xx.yy`) if the certificate is a wildcard. You can create entitlements for these hostnames, but you must configure a DNS forwarder on the site. ### Discovered App Details The **Discovered App Details** page also displays the following additional information: - ***Rule***. The entitlement action rule that matched the traffic: *allow, allow_report, block, block_report, alert or exclude*. - ***Port/Type***. The TCP port being accessed. The port name appears next to it in parentheses. - ***Protocol***. The value is TCP but may be expanded in the future. - ***Last Modified***. The date and time the discovered app was last modified. - ***Last Accessed***. The date and time the discovered app was last accessed. The following tabs appear in the bottom half of the page: - ***Hits per Day***. A histogram showing the total number of daily connections to the discovered app. Press the Tab key to focus on the first data point. Use arrow keys to navigate between data points and view their details. - *Show as Text*. Enable this toggle to replace the chart with a descriptive list. Dates are listed with the most recent at the top. - ***Related Apps***. Lists other discovered apps on the same host. Use the **Add Port Range** chart to view accessed ports. To include additional ports in your entitlement, enter a custom range in the ***Port Range*** fields and click **Add Range**. - ***Users.*** Lists users with the following information: - *Username*. The username used to sign in to AppGate ZTNA. - *Identity Provider*. The IdP the user used to sign in to AppGate ZTNA. - *Last Accessed*. The date (UTC) the user last accessed the discovered app. - *Download as CSV*. Exports the user list. Use the exported list to verify user access and create a new AD group if needed. - ***Groups****.* Lists groups with the following information: - *Name*. The name mapped to the “groups” user claim. - *Identity Provider*. The IdP used to sign in to AppGate ZTNA. Multiple IdPs may appear if different IdPs were used to access the discovered app. - *Percentage of Accessing Users*. The percentage of users in the group who access AppGate ZTNA. - ***Additional Data***. Displays originating entitlements and IP addresses. > [!NOTE] > **NOTE** > > No groups appear in common when AD groups (or any other AD property used to group users) are mapped to a user claim other than "groups." --- ## Managing Discovered Apps ### Resetting or deleting user data 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%3A57Z&se=2026-11-21T22%3A39%3A57Z&sr=b&sp=r&sig=Bw%2BoGf%2BcUyIGUSnnixXJHmfIAgoRP3JfffHRZATsAAw%3D)) to the right of each line item—to access the following options: - ***Reset user data***. Removes all user data related to the app. The app remains listed with 0 users. - ***Delete all data***. Removes the app and related user data. ### Pinning searches You can pin searches performed with the advanced filter fields on the **Discovered Apps** page for later use. After filtering, click the pin icon on the right side of the search details. The pin icon becomes solid when the search is pinned. ![Page displaying discovered apps highlighting the pin icon to pin a filtered search.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/pinned_search_appdisco.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A57Z&se=2026-11-21T22%3A39%3A57Z&sr=b&sp=r&sig=CHfJG0WY9F2yLvE%2Fa5ZQmccF2sCC8s%2Bo4a7SGVn5vyY%3D) Once a search is pinned, those results appear each time you return to the **Discovered Apps** page.