Test Wazuh Agent with Mock Server Using Docker and Imposter

[vikman90]

Description

To thoroughly test the Wazuh Agent’s interaction with a server, we need to set up a mock server capable of handling several key use cases. Specifically, this includes:

1. Agent Registration – Testing the process of registering a new agent with the server.
2. Stateless Message Sending – Verifying the agent’s ability to send messages without expecting a response or maintaining a session.
3. Stateful Message Sending – Testing the agent’s capacity to send messages while maintaining state (e.g., sessions).

To implement this, we will create a Docker container using Imposter as the mock server, which will facilitate these tests in a controlled environment.

Requirements

• The Wazuh Agent requires SSL to communicate with the server, so SSL support must be enabled in the mock server configuration.
• The mock server should be configured to handle both stateless and stateful interactions as per the use cases above.

Tasks

1. Set up a Docker environment with Imposter as the mock server.
2. Configure Imposter to support SSL connections.
3. Define mock endpoints for:
   • Agent registration
   • Stateless message handling
   • Stateful message handling
4. Document the setup and configuration steps to replicate the testing environment.
5. Implement test cases to verify that the Wazuh Agent can successfully communicate with the mock server in each of the defined scenarios.

[vikman90]

Work progress

November 7

• We have a Dockerfile that runs the mock server:

  docker build -t mock .
  docker run --rm -P mock

November 11

• Implemented the basic mocks for login, registration, message posting and command querying.
• Script to build and run the Docker container.

November 15

• Implemented api/v1/authentication: return a JWT token.
  • ES256 JWT implementation in Groovy.
• Implemented /stateful and /stateless responses with body logging.

November 18

• Implemented CLI options to selectively enable Stateless and Stateful request body logging.

November 19

• Registration mock updated according to:

  • 312

  • 318

November 20

• Moved lib into config.
• Removed Dockerfile: just use the Imposter image.
• Self SSL certificate generation with OpenJDK's keytool.
• https://github.com/wazuh/wazuh-agent/pull/323