Active response

The Wazuh Active Response module performs autonomous actions on endpoints to mitigate security threats. Wazuh can execute scripts automatically when it generates specific findings. These scripts execute actions, such as a firewall block or drop, and account lockout.

The Wazuh Active Response module assists in meeting the following NIST 800-53 controls:

  • IR-4 Incident handling: "Organizations recognize that incident response capabilities are dependent on the capabilities of organizational systems and the mission and business processes being supported by those systems. Organizations consider incident response as part of the definition, design, and development of mission and business processes and systems. Incident-related information can be obtained from a variety of sources, including audit monitoring, physical access monitoring, and network monitoring; user or administrator reports; and reported supply chain events. An effective incident handling capability includes coordination among many organizational entities (e.g., mission or business owners, system owners, authorizing officials, human resources offices, physical security offices, personnel security offices, legal departments, risk executive [function], operations personnel, procurement offices). Suspected security incidents include the receipt of suspicious email communications that can contain malicious code. Suspected supply chain incidents include the insertion of counterfeit hardware or malicious code into organizational systems or system components. For federal agencies, an incident that involves personally identifiable information is considered a breach. A breach results in unauthorized disclosure, the loss of control, unauthorized acquisition, compromise, or a similar occurrence where a person other than an authorized user accesses or potentially accesses personally identifiable information or an authorized user accesses or potentially accesses such information for other than authorized purposes."

  • SI-4 System monitoring: "System monitoring includes external and internal monitoring. External monitoring includes the observation of events occurring at external interfaces to the system. Internal monitoring includes the observation of events occurring within the system. Organizations monitor systems by observing audit activities in real-time or by observing other system aspects such as access patterns, characteristics of access, and other actions. The monitoring objectives guide and inform the determination of the events. System monitoring capabilities are achieved through a variety of tools and techniques, including intrusion detection and prevention systems, malicious code protection software, scanning tools, audit record monitoring software, and network monitoring software."

The Wazuh Active Response module assists in meeting the above controls by responding to malicious sources. Wazuh includes out-of-the-box active response commands that drop traffic from a malicious IP address or disable a user account that is a victim of brute forcing.

Use case

Block web attacks with Active Response

Wazuh helps meet the IR-4 Incident handling and SI-4 System monitoring requirements by detecting web-based attacks through web server log analysis and automatically blocking the attacking source.

In this scenario, we initiate a Cross-Site Scripting (XSS) attack from a host with HTTP access to a monitored Ubuntu 24.04 endpoint. Active response automatically blocks an attacker's IP address after detecting an XSS attack. You can then track the findings for these events and actions on the Wazuh dashboard.

Configure the Ubuntu endpoint

Perform the following steps to install an Apache web server and monitor its logs with the Wazuh agent.

  1. Update local packages and install the Apache web server:

    $ sudo apt update
    $ sudo apt install apache2
    
  2. If a firewall is enabled, modify it to allow external access to web ports:

    $ sudo ufw app list
    $ sudo ufw allow 'Apache'
    $ sudo ufw status
    
  3. Check that the Apache web server is running:

    $ sudo systemctl status apache2
    
  4. Add the following lines to the Wazuh agent /var/ossec/etc/ossec.conf configuration file.

    This sets the Wazuh agent to monitor the access logs of your Apache server:

    <localfile>
      <log_format>syslog</log_format>
      <location>/var/log/apache2/access.log</location>
    </localfile>
    
  5. Restart the Wazuh agent to apply the configuration changes:

    $ sudo systemctl restart wazuh-agent
    

Configure the Wazuh dashboard

Follow these steps to configure an active response that blocks the source IP address of a detected web attack.

  1. From the Wazuh dashboard main menu, navigate to Explore > Active Responses.

  2. Click Create active response and complete the configuration form with the following details. The block-ip executable is an out-of-the-box script that adds firewall rules to drop traffic from the source IP address of the finding. The Local location runs the script on the endpoint that generated the finding. The Stateless type runs the script once and never reverts it, so the block lasts until you remove the firewall rules. A Stateful active response reverts its action after a timeout. See Active response for more details.

    Field

    Value

    Name

    web_attack_ar

    Executable

    block-ip

    Location

    Local

    Type

    Stateless

    Create active response
  3. Click Create to save the active response.

  4. Navigate to Explore > Alerting.

  5. Switch to the Monitors tab, then click Create Monitor.

    Fill in the following parameters. The Active Response monitor type runs the active response that you select in the Actions subsection when the trigger condition is met. The value b04f7630-f428-5209-89f6-d640238bceac is the ID of the Cross site scripting strings rule. You can find rule IDs in Ruleset Management > Rules.

    Field

    Value

    Monitor name

    web_attack_ar_monitor

    Monitor type

    Active Response monitor

    Monitor defining method

    Visual editor

    Frequency

    By interval

    Run every

    1 Minute(s)

    Index

    wazuh-findings-v5-applications

    Query name

    web_attack_ar_query

    Field

    wazuh.rule.id

    Operator

    is

    Value

    b04f7630-f428-5209-89f6-d640238bceac

    Create an Active Response monitor
  6. In the Triggers section, click Add trigger and fill in the following parameters.

    Field

    Value

    Trigger name

    web_attack_ar_trigger

    Severity level

    1 (Highest)

    Specify queries or tags

    web_attack_ar_query

    Create an Active Response monitor trigger
  7. In the Actions subsection, click Add active response and fill in the following parameters.

    Field

    Value

    Action name

    web_attack_ar_action

    Active response

    web_attack_ar

    Create an Active Response monitor action
  8. Click Create to save the monitor.

Simulate the attack

Perform the following steps from another endpoint.

  1. Replace <WEBSERVER_IP_ADDRESS> with the Ubuntu IP address and execute the following command from the attacker endpoint:

    $ curl -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" "http://<WEBSERVER_IP_ADDRESS>/index.html?q=<script>document.cookie</script>"
    

    The attacker endpoint connects to the victim's web server the first time. This triggers a web attack finding and then triggers the block-ip active response to block any successive connections.

  2. Wait three minutes, then run the attack command again to confirm that the attacker IP is blocked:

    $ curl -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" "http://<WEBSERVER_IP_ADDRESS>/index.html?q=<script>document.cookie</script>"
    

    The command output looks similar to this:

    curl: (28) Failed to connect to <WEBSERVER_IP_ADDRESS> port 80 after 134781 ms: Couldn't connect to server
    

    On the Ubuntu endpoint, run sudo iptables -S INPUT | grep <ATTACKER_IP> to check the block. Replace <ATTACKER_IP> with the IP address of the attacker endpoint. The output shows the DROP rule that the block-ip active response added to the INPUT chain.

Visualize the findings

You can visualize the findings in the Wazuh dashboard. Click the upper-left menu icon (☰) and go to Threat intelligence > Threat Hunting. Add the following filter in the search bar.

  • event.dataset:apache-access

Apache access findings in Threat Hunting

The block-ip active response triggers to block the attacker IP. Navigate to Security operations > Incident Response. Switch to the Responses tab to see details about the triggered Active response.

Triggered active response in Incident Response

After you finish this use case, remove the firewall rules on the Ubuntu endpoint so that the attacker endpoint can connect again. The active response type is Stateless, so the block-ip active response never removes them:

$ sudo iptables -D INPUT -s <ATTACKER_IP> -j DROP
$ sudo iptables -D FORWARD -s <ATTACKER_IP> -j DROP