Configuring Application Discovery

Prev Next

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

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

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.

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

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

Once a search is pinned, those results appear each time you return to the Discovered Apps page.