ADD: updated README.md

This commit is contained in:
Dominik Meyer 2019-12-20 18:31:57 +01:00
parent abb5b148eb
commit 8574790775
No known key found for this signature in database
GPG Key ID: B4C312B600606B64
1 changed files with 50 additions and 6 deletions

View File

@ -2,16 +2,60 @@
## Description
OSSEC Active Response script to send jabber messages through sendxmpp.
This is an active response script for OSSEC(https://www.ossec.net/), written in perl,
to send jabber(xmpp) messages of certain alerts.
## Requirements
- Perl
- sendxmpp program
- OSSEC Perl Module
## INSTALL
### Stable Version
The stable version can always be installed from CPAN using the *cpan*
tool of your linux distribution.
### Git install
For installing fresh from the git repository you need a perl installation including the Dist::Zilla package. The use of plenv(https://github.com/tokuhirom/plenv) is encouraged.
```{r, engine='bash', code_block_name}
git clone https://gitcloud.federationhq.de/byterazor/App-OSSEC-Jabber.git
cd App-OSSEC-Jabber
dzil build
cpanm App-OSSEC-Jaber<version>.tar.gz
```
### OSSEC specific
- Please link the script into your OSSEC active response bin directory
to be able to execute it.
- configure the command in your ossec.conf
- configure the active response for every alert leve/ rule you want the command to be triggert
- place a jabber.conf file in your ossec etc directory
#### Example jabber.conf
```{r, engine='xml'}
<config>
<options>-t</options>
<recipients>
<recipient>your@jabber.de</recipient>
</recipients>
</config>
```
### sendxmpp
Plase make sure sendxmpp is installed and you have a working configuration to send jabber messages to your recipients.
## Author
Dominik Meyer <dmeyer@federationhq.de>
## INSTALL
coming soon
### LICENSE
## LICENSE
GPLv3