Allow or block software

After application control is enabled and logging or alerts are configured, you might receive notification that the Deep Security Agent has detected unrecognized software changes. Then you can decide whether to allow or block that software, or simply continue monitoring.

To allow or block software, perform these basic steps:

  1. Allow or block software
  2. Allow software updates
  3. Reuse shared allow and block rules on other computers
  4. Change from shared to computer-specific allow and block rules
  5. Reset application control after too much software change

For an overview of the application control module, see Lock down software with application control.

Allow or block software

To quickly find all software changes on all computers and easily create allow or block rules for them, use the Actions tab.

Actions tab allows you to view drift away from your approved software inventory, and to allow or block unapproved software. To filter the list, choose a time period, click blue links, or type search filters.

  1. Go to Actions.
  2. There are several ways you can filter to see only specific occurrences of unrecognized software:
    • From the menu next to Application Control: Software Changes, select a time range such as Last 7 Days to omit all events that aren't in that period.
    • In the pane on the left, select Computers or Smart Folder.
      Unlike the Computers tab, this pane usually does not show all computers. If application control has not detected unauthorized software changes, or if you have already resolved them by creating allow or block rules, then this pane's computer groups and smart folders will be empty.
    • Enter search terms in the search filter field. You search for these attributes: Change By Process, Change By User, File Name, Host Name, Install Path, MD5, SHA1, and SHA256.
    • Select whether to Group by File (Hash) or Group by Computer.
    • In the pane on the right, click the file name or computer name in the details in order to add them to your search filter.
    • Click a bar in the graph that indicates a time when software changed to zoom in on that time period.

    Search results will show only incidents that match all criteria. If your search filter hides too much, remove one of the search terms by clicking the X button next to it. If you need more information to decide whether to allow or block, click the software name, then use the details panel on the right side.

    For performance reasons, if the computer has too much software change, application control will continue to enforce existing rules, but stop detecting and displaying software changes. To resolve this, see Reset application control after too much software change.
  3. Click either Allow or Block to add an allow or block rule on that computer, for that software version, in that path. Alternatively, to allow or block the software in all file system paths and computers where it was detected, click Allow All or Block All.
    When you allow or block software from the Actions tab, and you haven't done anything else yet, feedback such as "Blocked 24 files" appears at the bottom of the page. If you haven't done anything else yet, you can undo that action by clicking Undo. If you've performed other actions since then, the Undo button disappears or changes to reflect your newest allow or block rule change. If you need to edit the rules later, see Undo blocking or allowing software.
    undo application control
    When you change allow or block rules, it affects all computers that use the same ruleset.

    If you have created a block rule for a batch file or PowerShell script, you will not be able to copy, move, or rename the file when using its associated interpreter (powershell.exe for PowerShell scripts or cmd.exe for batch files).

    The next time that the agent connects with the Deep Security Manager (local ruleset) or relay (shared ruleset), it will receive the new rules. If a computer was using shared allow or block rules created via the API, the relay will also transmit those new rules to other agents that use the shared rules the next time they connect. Until it succeeds, the status will indicate that the ruleset update is pending. The time required depends on:

    If the ruleset upload does not succeed, verify that network devices between the agent and the Deep Security Manager or relay allow communications on the heartbeat port number or relay port numbers.

  4. To verify that your rule is working, try to run the software that you just blocked. To match the rule, software must be in the same location and have the same hash, path, and file name.
    If software is accidentally blocked (or allowed) because you've selected Block unrecognized software until it is explicitly allowed and the software isn't being recognized, the Reason column in app control event logs can help you to troubleshoot the cause.
  5. If blocked software is still installed, application control will still record logs and show alerts when it blocks software from running.

    To reduce your attack surface and permission error logs on the computer, uninstall the software that app control is blocking. Once that is done, if you want to dismiss related alerts, either go to Alerts or go to Dashboard, click the alert, and then click the Dismiss Alert button. Not all alerts can be dismissed. For more information, see Predefined alerts.

Example: Allow All in application control

If helloworld.py is detected on three computers with local rulesets, then when you click Allow All or Block All, this would affect only three computers. It won't affect future detections on other computers, because they have their own rulesets.

But if helloworld.py is detected on three computers with three different shared rulesets, and 297 other computers also use the same three rulesets, then when you click Allow All or Block All, Deep Security Manager would upload the rule change to a total of 300 computers. It would also affect future computers that use the same shared rulesets.

Allow software updates

When you install patches, upgrade software, or deploy web applications, application control will detect them. Depending on your setting for how to handle unrecognized software, this could block that software until you use the Actions tab to create allow rules. For mission-critical software, this service interruption might not be acceptable. You also might not want to receive many alerts during expected, scheduled software updates such as operating system updates.

If you selected Block unrecognized software until it is explicitly allowed, you must enable Maintenance Mode before you update the computer's operating system. This includes when you perform an "update and restart" action on a computer running Windows. Failure to do this could break the computer: application control would block execution of updated files in the OS until you create the allow rules. Depending on which OS file was updated, you might need to use an OS recovery mode or external tool to recover from this misconfiguration.

To avoid extra down time and alerts during deployment and maintenance windows, you can put application control into a mode designed for maintenance windows. While maintenance mode is enabled, application control continue to enforce rules that block software, but it will allow new or updated software to run and automatically add it to the computer's inventory.

You can enable or disable maintenance mode either through actions on the Computers tab or (if only for a few computers) in each computer's Computer editor.

  1. In Deep Security Manager, go to Computers.
  2. Select one or more computers, then click Actions > Turn On Maintenance Mode.
  3. Select the duration of your maintenance window.

    Maintenance mode will automatically disable itself when your maintenance window is scheduled to end. Alternatively, if you'd prefer to manually disable maintenance mode when updates are finished, select Stay on indefinitely.

    If maintenance mode is set to Stay on indefinitely, make sure that you manually disable it when updates are complete. Failure to do this could allow users or attackers to install and run new software, including zero-day malware, and it will be added automatically to your allow rules.

    Deep Security Manager will immediately try to send the command to the agent. You don't need to click Save. The status and maintenance mode dashboard widget indicate whether the command has succeeded.

  4. Install or upgrade software.

    If that computer was using shared allow or block rules, then the next time that the agent connects with Deep Security Manager, it will upload the new rules. Deep Security Manager will transmit those new rules to the other agents the next time they connect. The time required depends on:

  5. If you chose to disable maintenance mode manually, remember to disable Maintenance Mode in order to start to detect software changes again.
  6. If you made a security update, verify that all computers were updated so none have the old, insecure software.

    If the computer uses a shared ruleset, go to Policies > Rules > Application Control Rulesets and double-click the ruleset. Find the allow rules for the old, insecure software and change their action to Block. This will prevent the insecure software from running if it is accidentally re-installed.

Reuse shared allow and block rules on other computers

If you have used the API to create shared allow or block rules, you can apply those rulesets to other computers. This can be useful if you have many identical computers (such as a load balanced web server farm).

  1. Use the API to build a computer's shared allow and block rules. For more information, see the API documentation. If you want to examine the shared ruleset before you deploy it, see View application control rulesets.
  2. Go to Computer or Policy editorClosedYou can change these settings for a policy or for a specific computer. To change the settings for a policy, go to the Polices page and double-click the policy that you want to edit (or select the policy and click Details). To change the settings for a computer, go to the Computers page and double-click the computer that you want to edit (or select the computer and click Details). > Application Control.
  3. In the ruleset section, make sure Inherit settings is not selected and then select Use a shared ruleset. Indicate which shared rules to use.

    These settings are hidden until you use the API to create at least one shared ruleset. If you haven't created any shared rulesets, or if you keep the default settings, each computer will keep its own allow and block rules locally. Changes to local rules don't affect other computers.

  4. Click Save.

    The next time that the Deep Security Agent on the computer connects with Deep Security Manager, the agent will apply those rules. The time required depends on:

    If the ruleset upload does not succeed, verify that network devices between the agent and relay allow communications on the heartbeat port number and relay port numbers.

Change from shared to computer-specific allow and block rules

If the computer is currently using shared allow or block rules created via the API, you can change it to use local rules. Application control will scan the file system for all currently installed software and create an initial ruleset for it, similarly to when you first enabled application control.

Before you start, verify that unwanted software is not currently installed. Rebuilding the ruleset will allow all currently installed software, even if it is insecure or malware. If you are not sure what is installed, the safest approach is to make a clean install and then enable application control.

The steps below configure a computer's agent to use a local ruleset. If you want all computers (such as a data center, where each server hosts different applications) to use local rules, edit the setting in the Policies tab instead.

  1. Go to Computer editorClosedTo open the Computer editor, go to the Computers page and double-click the computer that you want to edit (or select the computer and click Details). > Application Control.
  2. In the ruleset section, deselect Inherit settings (if necessary), and then select Use local ruleset initially based on installed software.
  3. Click Save.

    To verify the change, the next time the agent and Deep Security Manager connect, look for event log messages about building the application control ruleset. The time required depends on:

Globally block by hash

You can block specific software everywhere — regardless of file path, policy, or computer group, and regardless of whether application control has detected the software before.

Global rulesets take priority over all other application control rules. They apply to all computers where application control is enabled.

Global rulesets require Deep Security Agent 10.2 or newer. The manager will not send the global ruleset to older agents.

To add, view or delete a global rule, use the REST API.

Global rulesets identify software using its SHA-256 hash only — not the path or file size. Unlike local and shared ruleset changes, you can't "undo" global rule changes in the GUI. Instead, use the API to delete global rules. Like usual, though, changes are distributed via the Deep Security Manager or relays. Global rulesets will record system events, security events, and alerts.

In a multi-tenant deployment, each tenant has a separate global ruleset. To block software for all tenants, create the same global rules for each tenant.

Reset application control after too much software change

Application control is designed to assist your software change management process — not for unregulated computers with continuous, large numbers of software changes.

Too many changes make large rulesets that consume more RAM (unless you remove old rules each time). If you don't use maintenance mode during authorized software updates, too many changes can also result in high administrator workload because they must manually create allow rules.

If unrecognized software changes exceed the maximum, application control will stop detecting and displaying all of the computer's software changes. This prevents accidental or malicious stability and performance impacts: consuming too much memory, disk space, and (for shared rulesets) network bandwidth.

If that happens, Deep Security Manager will notify you via alert and an event log. You must resolve the issue to continue detecting software changes.

  1. Examine the computer's processes and security events. Verify that the computer has not been compromised. If you are not sure, or do not have enough time, the safest and fastest way is to restore the system from a backup or VM snapshot.
    If you don't remove any unauthorized software (including zero-day malware), application control will ignore it when you reset application control. It won't appear on the Actions tab anymore and if its process has already executed and it is in RAM, application control won't log any events or alerts about it until you reboot the computer.
  2. If the computer was running software updates, including auto-updates such as browser, Adobe Reader, or yum updates, disable them or schedule them so that they occur only when you have enabled application control's maintenance mode.
  3. Reset application control. To do this, disable application control. Once the agent has acknowledged it and cleared the error status, enable application control again.

    Local rulesets will be rebuilt; shared rulesets will be downloaded again.

Reset application control after too much software change

Application control is designed to assist your software change management process — not for unregulated computers with continuous, large numbers of software changes.

Too many changes make large rulesets that consume more RAM (unless you remove old rules each time). If you don't use maintenance mode during authorized software updates, too many changes can also result in high administrator workload because they must manually create allow rules.

If unrecognized software changes exceed the maximum, application control will stop detecting and displaying all of the computer's software changes. This prevents accidental or malicious stability and performance impacts: consuming too much memory, disk space, and (for shared rulesets) network bandwidth.

If that happens, Deep Security Manager will notify you via alert and an event log. You must resolve the issue to continue detecting software changes.

  1. Examine the computer's processes and security events. Verify that the computer has not been compromised. If you are not sure, or do not have enough time, the safest and fastest way is to restore the system from a backup or VM snapshot.
    If you don't remove any unauthorized software (including zero-day malware), application control will ignore it when you reset application control. It won't appear on the Actions tab anymore and if its process has already executed and it is in RAM, application control won't log any events or alerts about it until you reboot the computer.
  2. If the computer was running software updates, including auto-updates such as browser, Adobe Reader, or yum updates, disable them or schedule them so that they occur only when you have enabled application control's maintenance mode.
  3. Reset application control. To do this, disable application control. Once the agent has acknowledged it and cleared the error status, enable application control again.

    Local rulesets will be rebuilt; shared rulesets will be downloaded again.