diff --git a/crowdsec-docs/unversioned/bouncers/apache.mdx b/crowdsec-docs/unversioned/bouncers/apache.mdx index ec0537d9b..fc42a1c98 100644 --- a/crowdsec-docs/unversioned/bouncers/apache.mdx +++ b/crowdsec-docs/unversioned/bouncers/apache.mdx @@ -47,33 +47,45 @@ At the back, this component uses `mod_proxy`, `mod_ssl` for requests to LAPI, an :::warning -There is not yet publicly available packages or this Remediation Component. +Packages are only available for debian and ubuntu systems. -We are providing ways to build your own while we're working on packaging. +The module can be built and installed on other platform as well. -::: - -Clone or download directly [from our GitHub repository](https://github.com/crowdsecurity/cs-apache2-bouncer). +Please keep in mind that this bouncer only supports live mode. +::: - + + +### Repository configuration + +:::warning +Please note that the repository for this package is not the same as the one holding CrowdSec's binary packages, +::: + +```bash +curl -s https://packagecloud.io/install/repositories/crowdsec/crowdsec-apache/script.deb.sh | sudo bash +``` + +### Installation ```bash -dpkg-buildpackage -us -uc -sudo dpkg -i ../crowdsec-apache2-bouncer_1.0.0_amd64.deb +sudo apt-get install crowdsec-apache2-bouncer ``` +Clone or download directly [from our GitHub repository](https://github.com/crowdsecurity/cs-apache2-bouncer). + ```bash aclocal autoconf @@ -87,10 +99,6 @@ sudo mkdir -p /etc/crowdsec/bouncers/ sudo cp ./config/crowdsec-apache2-bouncer.conf /etc/crowdsec/bouncers/ ``` - - - - ### Initial Configuration Enable the mod_crowdsec module: @@ -110,7 +118,6 @@ Remediation Component config's is located in `/etc/crowdsec/bouncers/crowdsec-ap ```bash ## Replace the API key with the newly generated one [1] CrowdsecAPIKey this_is_a_bad_password -... ``` :::info @@ -121,8 +128,14 @@ If needed, edit `CrowdsecURL` (and other parameters) sudo systemctl restart apache2 ``` + + + + ## Configuration directives +The configuration file is stored in `/etc/crowdsec/bouncers/crowdsec-apache2-bouncer.conf` by default. + ### `Crowdsec` > on|off @@ -138,9 +151,9 @@ Behavior can be overriden in any location. > fail|block|allow How to respond if the Crowdsec API is not available: - - `fail` (**default**) returns a 500 Internal Server Error. + - `fail` returns a 500 Internal Server Error. - `block` returns a 302 Redirect (or 429 Too Many Requests if CrowdsecLocation is unset). - - `allow` will allow the request through. + - `allow` (**default**) will allow the request through. ### `CrowdsecBlockedHTTPCode`