| name | implementing-endpoint-detection-with-wazuh |
| description | Deploy and configure Wazuh SIEM/XDR for endpoint detection including agent management, custom decoder and rule XML creation, alert querying via the Wazuh REST API, and automated response actions. |
| domain | cybersecurity |
| subdomain | security-operations |
| tags | ["siem","xdr","wazuh","endpoint-detection","custom-rules","incident-response"] |
| version | 1.0 |
| author | mahipal |
| license | Apache-2.0 |
Implementing Endpoint Detection with Wazuh
Overview
Wazuh is an open-source SIEM and XDR platform for endpoint monitoring, threat detection, and compliance. This skill covers managing agents via the Wazuh REST API, creating custom decoders and rules in XML for organization-specific detections, querying alerts, and testing rule logic using the logtest endpoint.
Prerequisites
- Wazuh Manager 4.x deployed with API enabled
- Python 3.9+ with
requests library
- API credentials (username/password for JWT authentication)
- Understanding of Wazuh decoder and rule XML syntax
Steps
Step 1: Authenticate to Wazuh API
Obtain JWT token via POST to /security/user/authenticate.
Step 2: List and Monitor Agents
Query agent status, versions, and last keep-alive via /agents endpoint.
Step 3: Query Security Alerts
Search alerts by rule ID, severity, agent, or time range.
Step 4: Test Custom Rules with Logtest
Use the /logtest endpoint to validate decoder and rule logic against sample log lines.
Expected Output
JSON report with agent inventory, alert statistics, rule coverage, and logtest validation results.
