mirror of
https://github.com/valitydev/wazuh-kibana-app.git
synced 2024-11-06 09:55:18 +00:00
76 lines
3.1 KiB
Markdown
76 lines
3.1 KiB
Markdown
# Wazuh Kibana App
|
|
|
|
[![Slack](https://img.shields.io/badge/slack-join-blue.svg)](https://goo.gl/forms/M2AoZC4b2R9A9Zy12)
|
|
[![Email](https://img.shields.io/badge/email-join-blue.svg)](https://groups.google.com/forum/#!forum/wazuh)
|
|
[![Documentation](https://img.shields.io/badge/docs-view-green.svg)](https://documentation.wazuh.com)
|
|
[![Documentation](https://img.shields.io/badge/web-view-green.svg)](https://wazuh.com)
|
|
|
|
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/
|
|
|
|
## 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)
|
|
|
|
![Overview](https://wazuh.com/wp-content/uploads/2017/01/Overview_general.png)
|
|
|
|
## Requisites
|
|
|
|
- Wazuh HIDS 3.0.0 or superior
|
|
- Wazuh RESTful API 3.0.0 or superior
|
|
- Kibana 6.0.0 or superior
|
|
- Elasticsearch 6.0.0 or superior
|
|
|
|
## Installation
|
|
|
|
| Kibana version | Wazuh App version | Installation |
|
|
| :---: | :---: | :--- |
|
|
| 6.0.0 | 3.0.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-3.0.0_6.0.0.zip |
|
|
| 6.0.1 | 3.0.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-3.0.0_6.0.1.zip |
|
|
| 6.1.0 | 3.0.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-3.0.0_6.1.0.zip |
|
|
| 6.1.0 | 3.1.0 | /usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-3.1.0_6.1.0.zip |
|
|
|
|
## Upgrade
|
|
|
|
Remove the App using kibana-plugin tool
|
|
|
|
```/usr/share/kibana/bin/kibana-plugin remove wazuh ```
|
|
|
|
Install the App
|
|
|
|
```/usr/share/kibana/bin/kibana-plugin install https://packages.wazuh.com/wazuhapp/wazuhapp-3.x.x_6.x.x.zip ```
|
|
|
|
## 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).
|
|
* Bootstrap (getbootstrap.com).
|
|
* AngularJS.
|
|
* Node.js (Ryan Dahl).
|
|
* NPM packages Angular animate, aria, cookies, md5, needle and cron.
|
|
|
|
## License and copyright
|
|
|
|
Wazuh App Copyright (C) 2017 Wazuh Inc. (License GPLv2)
|
|
|
|
## References
|
|
|
|
* [Wazuh website](https://wazuh.com)
|
|
* [Wazuh documentation](https://documentation.wazuh.com)
|
|
* [Elastic stack](https://elastic.co)
|