Manage Applications

Overview

Contrast users can manage applications based on their organization or application role. Manage individual applications in the grid, or use the action bar to make changes in bulk.

Change Application Names

To change an application name, click on the the application's name in the grid to go to its Overview page. Click on the name at the top of the page to update the text, or click on the Settings icon and update the name in the Application Defaults dialog. Each application within an organization must have an unique name.

Note: SuperAdmins can also edit application names by clicking on the name in the grid.

Tag Applications

Tag one or more applications to improve search functionality in the Contrast UI. You can also add custom metadata fields during onboarding, which you can use the same way. (It's also very different from merging applications.)

To tag a single application, hover over the grid row and select the tag icon. To tag multiple applications at the same time, use the check marks to select the appropriate grid rows, and select the tag icon in the bottom action bar. Enter the tag name in the dialog that appears and select the button to Save your changes.

Sort and Filter Applications

There are a few way to narrow down the number of applications in the grid:

  • To see all application in the a certain category - such as merged, unlicensed or archived applications - use the dropdown menu by the application count above the grid to choose the appropriate quick view. The grid defaults to All.

  • To find specific applications, click on the search tool above the grid, and type the name of the application or application tag you want to locate.

  • To sort the applications in the grid, use the dropdown menu to the upper-right side of the grid to sort by name, importance or language in ascending or descending order.

  • To filter applications in your current view of the grid, select the filter (funnel) icon for the Application or Open Vulnerabilities columns. In the dropdown menu, select the filter(s) that you want to apply. To remove the selected filters, select the Clear link beside the filter icon.

Archive Applications

If an application should longer collect vulnerabilities, but you want to keep it in your organization for historical purposes, the best solution is to archive the application. Archiving an application maintains the integrity of past application data, such as vulnerabilities and libraries, but the agent no longer reports vulnerabilities to the Contrast application; the application is essentially turned off. Archived applications also improve your overall portfolio score, as they don't count against the total score.

To archive an individual application, hover over the application's grid row, and select the archive (box) icon. To archive multiple applications, use the check marks to select the appropriate rows, and select the archive icon from the action bar. In the dialog that appears, select the Archive button to confirm your choice.

To see all archived applications, go to the Archived quick view in the Applications grid. From this view, you can restore or delete applications.

Note: Archiving an application doesn't free up a license in Contrast. The only way to return a license back to the pool of available licenses is to archive, reset and then fully delete the application. (See the sections below to Reset and Delete Applications.)

Unarchive applications

Once an application is archived, an administrator can restore the application. The application becomes visible by default, and all vulnerabilities and issues immediately impact the portfolio score.

Note: If an application was reset, there is no way to restore the purged data.

To unarchive an application, go the Archived quick view in the grid. To unarchive an individual application, hover over the application's grid row, and select the unarchive (arrow) icon. To unarchive multiple applications, use the check marks to select the appropriate rows, and select the unarchive icon from the bottom menu. In the dialog that appears, select the Unarchive button to confirm your choice.

Reset Applications

Resetting an application purges all of the data associated with it, but doesn't remove the application. (Users often reset applications to clear all history and findings associated with a specific application.)

To reset an application, hover over the grid row and select the reset icon. (This must be done individually.) In the dialog that appears, select the Reset button to confirm your choice.

Delete Applications

You must archive an application before you can fully delete it. You aren't required to reset the application, as the deletion process truncates any associated data; however, Contrast recommends that you review the data and reset the application before you delete it.

For step-by-step instructions, go to the Delete Applications article.

Merge Applications

Merging two or more applications into a single application is a common operation performed by Organization Administrators responsible for bringing applications online. The main purpose of merging is to present a single application view for the purposes of scoring, discovered vulnerabilities and remediation. Applications can be made up of components, which may show up individually in the application list. Merging also allows you to logically organize all of an application's components into one entity in Contrast.

Create a Master Application

To merge applications, go to the Applications grid, and use the check marks to select the applications to merge. Select the Merge icon from the menu at the bottom of the grid.

In the dialog that appears, use the dropdown menu to choose one of the merged applications to represent the master application.

Once your applications are merged, you'll see a crown icon beside the name of the master application. To see the application modules represented by the master, click on the icon. To see all merged applications, go to the Merged quick view in the grid.

Unmerge Applications

To unmerge either all or specific application modules from the master application, click on the crown icon in the application's grid row or Overview page. In the dialog that appears, select any number of the modules, and click the button to Unmerge Selected applications.

Delete Applications

Deleting an application returns the application's enterprise license back into the license pool, making the license available for use by other applications. It also removes findings associated with the application, like vulnerabilities and libraries, that you no longer need or want.

Step 1: Select an application

In the Applications grid, click on the application you would like to delete.

Step 2: Stop reporting agents

From the application Overview page, verify that no servers are reporting to the application. If any servers are reporting, manually disable the servers in each environment by clicking the green On button for Assess or Protect. In the dialog that appears, use the toggle to switch off the server, and click Save. Repeat this process for servers with Assess and/or Protect enabled in each environment, as needed.

If you don't disable all agents reporting on behalf of the application, leftover agents may continue to report findings, even after the application is deleted. As a result, the application would be recreated and continue to consume the license.

Step 3: Reset the application

It's best practice to reset the application to make sure that all associated vulnerabilities, URLs and components are cleared properly. Click the Settings (gear) icon in the top right of the application Overview page. At the bottom of the Application Settings dialog, select the link to Reset Application.

You can also reset from the Applications page by clicking the Reset button in the application's grid row.

Step 4: Archive the application

Return to the Application Settings dialog from the Overview page, and select the link to Archive Application. Or, you can archive applications from the Applications page by selecting the appropriate applications in the grid and clicking the Archive button.

Once archived, applications don't appear in the Applications grid by default. To view archived applications in the grid, use the dropdown menu to switch to the Archived quick view. The applications then appears in the grid; however, you must restore them to view details beyond the grid.

To learn how to restore an archived application, go the application management Overview.

Step 5: Delete the application

When you delete an application, all of its associated findings - i.e., vulnerabilities and libraries - are removed permanently. To complete the deletion process, and select the delete (trashcan) icon in the archived application's grid row. In the dialog that appears, select the Delete button to confirm your choice.