Code Monkey home page Code Monkey logo

wazuh-demo-server's Introduction

Wazuh Demo Server

About Wazuh

Wazuh is a security platform that provides unified XDR and SIEM protection for endpoints and cloud workloads. The solution is composed of a single universal agent and three central components: the Wazuh server, the Wazuh indexer, and the Wazuh dashboard.

Wazuh is free and open source. Its components abide by the GNU General Public License, version 2, and the Apache License, Version 2.0 (ALv2).

Learn more about Wazuh

Intended usage of this script

This script is for demo purposes only. It deploys a bare minimum, single-node Docker host and Wazuh stack running as a docker-compose stack.

Prerequisites

  • Ubuntu 20.04+ Server
  • Minimum Recommended 8vCPU and 8GB (16GB may be better if you want to monitor a large number of agents workloads) of RAM (Try Hetzner or DigitalOcean)
  • DNS or Hosts file entry pointing to server IP

Installed as part of script

  • Docker
  • Docker-Compose
  • Wazuh 4.3 Docker Stack

Full Server Setup

  1. git clone https://github.com/AlphaBravoCompany/wazuh-demo-server.git
  2. cd wazuh-demo-server
  3. chmod +x install-wazuh.sh
  4. ./install-wazuh.sh subdomain.yourdomain.tld
  5. Install will take approximately 2 minutes and will output links and login information for Wazuh.
  6. Details for accessing Wazuh will be printed to the screen once the script completes and saved to server-details.txt

Add Agents

Wazuh Agent Enrollment: https://documentation.wazuh.com/current/user-manual/agent-enrollment/index.html

Wazuh Agent Management: https://documentation.wazuh.com/current/user-manual/agents/index.html

  1. Login to the Wazuh UI
  2. Select the "v" arrow next to the Wazuh logo in the upper left and select "Agents"
  3. Select "Deploy New Agents" and define the target system using the following variables:
    • Target Operating System
    • Architecture
    • Wazuh Server Address - The IP or DNS Name (if you created one) of the Wazuh server
    • Agent Group - Out of the box, only the "Default" group exists, but you can add additional groups under the dropdown "Management -> Administration -> Groups"
  4. Copy the agent enrollment command and run against the agents you want to join the Wazuh server
  5. Copy the agent start command and run against your agents
  6. Navigate back to the "Modules Directory" and you should see your agent count reflecting the new agents you joined.

Enable Additional Scans

To enable additional agent scanning for Rootkits, OSQuery, CIS Benchmarks and others as well as custom agent configs, you need to edit the /var/ossec/etc/ossec.conf or /var/ossec/etc/shared/default/agent.conf files on the manager. Since this is running in Docker, follow the instructions below to locate and modify these files.

Manager File

The Wazuh Manager config file is mapped to file wazuh-demo-server/wazuh-docker/single-node/config/wazuh_cluster/wazuh_manager.conf in the docker-compose file.

Make the required changes to the file, thens in the wazuh-demo-server/wazuh-docker/single-node folder run docker-compose restart.

Agent Files

Agent files in the Docker installation need to be modified inside the container.

Follow the instructions here to exec into the container with a bash shell: https://documentation.wazuh.com/current/deployment-options/docker/container-usage.html

Then modify the centralized agent files per the instruction here: https://documentation.wazuh.com/current/user-manual/reference/centralized-configuration.html?highlight=agent.conf

Recommended manager and agent file changes.

Next Steps

Follow some of the Proof-of-Concept guides provided by Wazuh to learn more about the platform capabilities: https://documentation.wazuh.com/current/proof-of-concept-guide/index.html

If you like the platform and want to scale Wazuh better, follow the production installation steps: https://wazuh.com/install/

Uninstall Methods

  1. From within the wazuh-demo-server/wazuh-docker/single-node/ directory, run docker-compose down -v (removes all Wazuh components and volumes).

About Alphabravo

AlphaBravo provides products, services, and training for Cybersecurity, Kubernetes, Cloud, and DevSecOps.

Contact AB today to learn how we can help you.

wazuh-demo-server's People

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.