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. To archive, restore, reset or delete applications, see the step-by-step instructions in the Delete Applications article.

Change Application Names

To change an application name, go to the application's 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: Super Admins can also edit application names by clicking on the name in the Applications page grid.

Archive Applications

You can archive applications that should no longer collect traces, but that you want to keep for historical purposes. Archiving an application maintains the integrity of application data, such as traces and libraries, but essentially turns the application "off". When an application is archived, the agent is informed of the application status and no longer sends traces to the Contrast application. Archived applications also improve your overall portfolio score, as they don't count against the total score.

A small gray box appears to the right of the application name when it's in an archived state. By default, these applications don't show up in the Applications grid. However, you can check the Show Archived option in Advanced Settings to view and interact with an archived application.

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

Restore (unarchive) applications

Once an application is archived, an administrator can restore the application. (Restoring an application is the inverse of archiving an 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.

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

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.

Group Applications

Grouping is a simple way to tag or label one or more applications so that you can use the group attribute to improve search functionality in the Contrast interface. (It's also very different from merging applications.)

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, complete the following steps in the Contrast interface:

  • Go to the Applications page.
  • Find the applications that you want to merge, and use the checkboxes in the grid to select them.
  • Select the Merge icon from the batch action menu at the top right of the grid.

  • Choose one of the merged applications to represent the master application.

Once your applications are merged, you'll see the master application name accompanied by a crown icon. To see the application modules represented by the master, click the icon, or choose Show child applications from the Advanced filter options. To quickly get to any merged applications, use the Merged filter available from the search bar.

Unmerge Applications

There are a couple of ways to unmerge either all or specific application modules from the master application.

From the Applications page, click the Unmerge action in the row menu of any master application. By default, this will unmerge all application modules represented; however, there is also an option to specifically define which modules are unmerged.

Click the crown icon in the application row or Details page to view each module in the Application Modules dialog. Select one, many or all 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 page, 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 Application Settings (gear) icon in the top right of the application Overview page. At the bottom of the dialog that appears, select the link to Reset Application.

You can also reset from the Applications page by selecting one or more applications, and clicking the Reset batch action button.

Step 4: Archive the application

Return to the Application Defaults dialog 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 batch action button.

Once archived, applications don't appear in the Applications page grid by default. To view archived applications in the grid, check the Show archived filter in Advanced Settings. The applications then appears in the grid; however, you must restore them to view details beyond the grid.

Restore an application

You can restore (unarchive) an application by selecting it in the grid, and choosing Unarchive in the row menu.

You can also restore one or more applications from the Applications page by selecting the appropriate applications in the grid, and clicking the Unarchive Applications batch action button.

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, close the Advanced filter panel, and select Fully Delete in the application's row menu. You can also select one or more archived applications in the grid, and click Delete applications in the batch action menu.

Note: The application must be archived for this option to appear.