Starting Wazuh v4.2.0, the active response capability provides the Wazuh agent with the complete alert information in JSON format via STDIN. This improvement removes the previous limitation of only sending specific fields. This change increases the scope of the capability by easily allowing custom active responses to be triggered by any alert regardless of the format of the original event.
The default Active Response scripts are all adapted to benefit from this capability.
For Wazuh agents with a version older than 4.2.0, active responses will continue working normally.
For Wazuh agents version v4.2.0 or higher some changes may be necessary. The default commands should be edited to remove the
expect field. For Linux servers, the
.sh should also be removed and, for Windows servers, you need to change the
.cmd script extension to
.exe. There is no need to change the default active response scripts as they are automatically replaced with the new ones during the agent upgrade.
<command> <name>win_route-null</name> <executable>route-null.exe</executable> <timeout_allowed>yes</timeout_allowed> </command> <command> <name>win_route-null-legacy</name> <executable>route-null.cmd</executable> <expect>srcip</expect> <timeout_allowed>yes</timeout_allowed> </command>
In environments with both older and newer agent versions, the command configuration should be duplicated to include both scripts.
<command> <name>firewall-drop</name> <executable>firewall-drop</executable> <timeout_allowed>yes</timeout_allowed> </command> <command> <name>firewall-drop-legacy</name> <executable>firewall-drop.sh</executable> <expect>srcip</expect> <timeout_allowed>yes</timeout_allowed> </command> <active-response> <command>firewall-drop</command> <location>local</location> <rules_id>5712</rules_id> <timeout>1800</timeout> </active-response> <active-response> <command>firewall-drop-legacy</command> <location>local</location> <rules_id>5712</rules_id> <timeout>1800</timeout> </active-response>
The custom active response executables must be able to read JSON input from STDIN, and the command's configuration no longer needs to specify a specific
expect field. For more information, see custom active response.
No. New rules are included for the new active response capability. You can check them under the active response rules. Alerts generated on older agents to version 4.2.0 remain the same, while newer agents now have new alert IDs. For example, rule 601 "Host Blocked by firewall-drop Active Response" is now rule 651 for new agents. If you have email notifications, rules, and integrations set with the old active response rules, make sure to include the new ones.
Yes, using the location option. More information: Active Response options
Yes, using the
<timeout_allowed> tag on the command and the
<timeout> tag on the active response. More information: Example