Allow or Block Unrecognized Software
When you allow or block unrecognized software, an allow or block rule is automatically created and assigned to the ruleset used by the computer. Generally, use the following steps to allow or block software with Application Control:
- Use a
SoftwareChangeApi
object to obtain a list ofSoftwareChange
objects. - Decide which software changes you want to allow or block.
- Create a
SoftwareChangeReview
object and configure it with the list of software changes and the action to take on them. When you create aSoftwareChangeReview
object, use it to define the IDs of theSoftwareChange
objects you wish to allow or block and the action to take on the software changes. - Use the
SoftwareChangeApi
object to perform the software change review.
For more information about allow or block rules, see the Deep Security Help Center.
The following example searches for a list of unrecognized software on a computer and blocks the unrecognized software. (The creation of the search criteria and search filter is not shown.) See also the Review software changes operation in the API Reference.
Python
source
# Perform the search software_changes_api = api.SoftwareChangesApi(api.ApiClient(configuration)) computer_software_changes = software_changes_api.search_software_changes(api_version, search_filter=search_filter) # Block the unrecognized software # Create the software change review object and set action to block software_change_review = api.SoftwareChangeReview() software_change_review.action = "block" software_change_review.software_change_ids = [] # Add the IDs of the software changes to block for software_change in computer_software_changes.software_changes: software_change_review.software_change_ids.append(software_change.id) # Perform the software change review return software_changes_api.review_software_changes(software_change_review, api_version)
JavaScript
source
// Perform the search const softwareChangeApi = new api.SoftwareChangesApi(); softwareChangeApi.searchSoftwareChanges(apiVersion, searchOptions) .then(results => { // Block the unrecognized software // Create the software change review object and set action to block const softwareChangeReview = new api.SoftwareChangeReview(); softwareChangeReview.action = api.SoftwareChangeReview.ActionEnum.block; if (results.softwareChanges.length > 0) { // Add the IDs of the software changes to block softwareChangeReview.softwareChangeIDs = results.softwareChanges.map(softwareChange => softwareChange.ID); // Perform the software change review softwareChangeApi.reviewSoftwareChanges(softwareChangeReview, apiVersion) .then(softwareChangeReview => { resolve(softwareChangeReview.softwareChangeReviewResults); }) .catch(error => { reject(error); }); } else { resolve(results); } }) .catch(error => { reject(error); })
Java
source
// Perform the search SoftwareChangesApi softwareChangesApi = new SoftwareChangesApi(); SoftwareChanges softwareChanges = softwareChangesApi.searchSoftwareChanges(searchFilter, apiVersion); // Block the software changes SoftwareChangeReview softwareChangeReview = new SoftwareChangeReview(); softwareChangeReview.setAction(ActionEnum.BLOCK); for (SoftwareChange softwareChange : softwareChanges.getSoftwareChanges()) { softwareChangeReview.addSoftwareChangeIDsItem(softwareChange.getID()); } softwareChangeReview = softwareChangesApi.reviewSoftwareChanges(softwareChangeReview, apiVersion);