2017-10-04 18:33:13 +00:00
# Wazuh
Wazuh is a security detection, visibility, and compliance open source project. It was born as a fork of OSSEC HIDS, later was integrated with Elastic Stack and OpenSCAP evolving into a more comprehensive solution. You can read more in https://wazuh.com/
## Wazuh - Kibana App Description
Visualize and analyze Wazuh alerts stored in Elasticsearch using our Kibana app plugin.
- Obtain statistics per agent, search alerts and filter by using the different visualizations.
- View the Wazuh manager configuration.
- File integrity monitoring.
## Documentation
* [Full documentation ](https://documentation.wazuh.com )
* [Wazuh installation guide ](https://documentation.wazuh.com/current/installation-guide/index.html )
* [Screenshots ](https://documentation.wazuh.com/current/index.html#example-screenshots )
2016-12-22 03:34:03 +00:00
## Requisites
2017-01-18 13:06:11 +00:00
- Wazuh HIDS 2.0 or superior
- Wazuh RESTful API 2.0 or superior
2017-03-03 17:06:14 +00:00
- Kibana 5.2.2 or superior
2016-12-22 03:34:03 +00:00
- Elasticsearch 5 or superior
2016-09-30 11:57:57 +00:00
2016-12-22 03:34:03 +00:00
## Installation
2016-09-30 11:57:57 +00:00
2017-07-25 18:15:12 +00:00
| Kibana version | Wazuh App version | Installation |
| :---: | :---: | :--- |
| 5.2.2 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.2.2.zip |
| 5.3.0 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.3.0.zip |
| 5.3.1 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.3.1.zip |
| 5.4.0 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.4.0.zip |
| 5.4.1 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.4.1.zip |
| 5.4.2 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.4.2.zip |
| 5.4.3 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.4.3.zip |
| 5.5.0 | 2.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.5.0.zip |
| 5.5.0 | 2.0.1 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0.1_5.5.0.zip |
| 5.5.1 | 2.0.1 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0.1_5.5.1.zip |
2017-10-04 18:33:13 +00:00
| 5.5.1 | 2.1.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.0_5.5.1.zip |
| 5.5.2 | 2.1.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.0_5.5.2.zip |
| 5.5.3 | 2.1.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.0_5.5.3.zip |
| 5.6.1 | 2.1.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.0_5.6.1.zip |
2017-10-24 17:07:51 +00:00
| 5.6.1 | 2.1.1 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.1_5.6.1.zip |
2017-10-04 18:33:13 +00:00
| 5.6.2 | 2.1.1 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.1_5.6.2.zip |
2017-10-24 17:07:51 +00:00
| 5.6.3 | 2.1.1 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.1.1_5.6.3.zip |
2017-07-25 17:06:05 +00:00
2017-03-03 17:07:34 +00:00
## Upgrade
2016-09-30 11:58:46 +00:00
2017-03-03 17:06:14 +00:00
Remove the App using kibana-plugin tool
2016-09-30 11:58:46 +00:00
```/usr/share/kibana/bin/kibana-plugin remove wazuh ```
2016-09-30 11:57:57 +00:00
2017-03-03 17:06:14 +00:00
Install the App
```/usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-2.0_5.x.x.zip ```
2016-12-22 03:34:03 +00:00
## Contribute
If you want to contribute to our project please don't hesitate to send a pull request. You can also join our users [mailing list ](https://groups.google.com/d/forum/wazuh ), by sending an email to [wazuh+subscribe@googlegroups.com ](mailto:wazuh+subscribe@googlegroups.com ), to ask questions and participate in discussions.
## Software and libraries used
* API from Elastic and Kibana (elastic.co).
* Angular Material (material.angularjs.org).
2016-12-22 03:34:30 +00:00
* Bootstrap (getbootstrap.com).
* AngularJS.
2016-12-22 03:34:03 +00:00
* Node.js (Ryan Dahl).
* NPM packages Angular animate, aria, cookies, md5, needle and cron.
## License and copyright
Wazuh App Copyright (C) 2016 Wazuh Inc. (License GPLv2)
## References
2017-01-11 11:02:25 +00:00
* [Wazuh website ](https://wazuh.com )
2017-04-27 10:54:47 +00:00
* [Wazuh documentation ](https://documentation.wazuh.com )
2017-10-24 17:07:51 +00:00
* [Elastic stack ](https://elastic.co )
