96 lines
3.0 KiB
Markdown
96 lines
3.0 KiB
Markdown
# Wazuh-Ansible
|
|
|
|
[](https://wazuh.com/community/join-us-on-slack/)
|
|
[](https://groups.google.com/forum/#!forum/wazuh)
|
|
[](https://documentation.wazuh.com)
|
|
[](https://wazuh.com)
|
|
|
|
These playbooks install and configure Wazuh agent, manager and Elastic Stack.
|
|
|
|
## Documentation
|
|
|
|
* [Wazuh Ansible documentation](https://documentation.wazuh.com/current/deploying-with-ansible/index.html)
|
|
* [Full documentation](http://documentation.wazuh.com)
|
|
|
|
## Directory structure
|
|
|
|
├── wazuh-ansible
|
|
│ ├── roles
|
|
│ │ ├── elastic-stack
|
|
│ │ │ ├── ansible-elasticsearch
|
|
│ │ │ ├── ansible-kibana
|
|
│ │
|
|
│ │ ├── wazuh
|
|
│ │ │ ├── ansible-filebeat
|
|
│ │ │ ├── ansible-wazuh-manager
|
|
│ │ │ ├── ansible-wazuh-agent
|
|
│ │
|
|
│ │ ├── ansible-galaxy
|
|
│ │ │ ├── meta
|
|
│
|
|
│ ├── playbooks
|
|
│ │ ├── wazuh-agent.yml
|
|
│ │ ├── wazuh-elastic.yml
|
|
│ │ ├── wazuh-elastic_stack-distributed.yml
|
|
│ │ ├── wazuh-elastic_stack-single.yml
|
|
│ │ ├── wazuh-kibana.yml
|
|
│ │ ├── wazuh-manager.yml
|
|
│
|
|
│ ├── README.md
|
|
│ ├── VERSION
|
|
│ ├── CHANGELOG.md
|
|
|
|
|
|
## Branches
|
|
|
|
* `stable` branch on correspond to the last Wazuh-Ansible stable version.
|
|
* `master` branch contains the latest code, be aware of possible bugs on this branch.
|
|
|
|
## Testing
|
|
|
|
1. Get the `wazuh-ansible` folder from the `wazuh-qa` [repository](https://github.com/wazuh/wazuh-qa/tree/master/ansible/wazuh-ansible).
|
|
|
|
```
|
|
git clone https://github.com/wazuh/wazuh-qa
|
|
```
|
|
|
|
2. Copy the `Pipfile` and the `molecule` folder into the root wazuh-ansible directory:
|
|
|
|
```
|
|
cp wazuh-qa/ansible/wazuh-ansible/* . -R
|
|
```
|
|
|
|
3. Follow these steps for launching the tests. Check the Pipfile for running different scenarios:
|
|
|
|
```
|
|
pip install pipenv
|
|
sudo pipenv install
|
|
pipenv run test
|
|
pipenv run agent
|
|
```
|
|
|
|
## Contribute
|
|
|
|
If you want to contribute to our repository, please fork our Github repository and submit a pull request.
|
|
|
|
If you are not familiar with Github, you can also share them through [our users mailing list](https://groups.google.com/d/forum/wazuh), to which you can subscribe by sending an email to `wazuh+subscribe@googlegroups.com`.
|
|
|
|
### Modified by Wazuh
|
|
|
|
The playbooks have been modified by Wazuh, including some specific requirements, templates and configuration to improve integration with Wazuh ecosystem.
|
|
|
|
## Credits and Thank you
|
|
|
|
Based on previous work from dj-wasabi.
|
|
|
|
https://github.com/dj-wasabi/ansible-ossec-server
|
|
|
|
## License and copyright
|
|
|
|
WAZUH
|
|
Copyright (C) 2016-2020 Wazuh Inc. (License GPLv2)
|
|
|
|
## Web references
|
|
|
|
* [Wazuh website](http://wazuh.com)
|