Skip to content

Commit 08ab3db

Browse files
authored
Merge pull request #772 from crowdsecurity/nginx_bouncer/doc
docs(nginx): update documentation for configuration precedence and variables
2 parents 3d5c611 + 4e53756 commit 08ab3db

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

crowdsec-docs/unversioned/bouncers/nginx.mdx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,10 @@ SSL_VERIFY=true
197197
################
198198
```
199199

200+
Any `/etc/crowdsec/bouncers/crowdsec-nginx-bouncer.conf.local` content will take
201+
precedence over `/etc/crowdsec/bouncers/crowdsec-nginx-bouncer.conf`. All fields
202+
don't have to be present in this `.local.` file.
203+
200204
### NGINX Configuration
201205

202206
The Remediation Component NGINX configuration is located in `/etc/nginx/conf.d/crowdsec_nginx.conf` :
@@ -615,3 +619,10 @@ APPSEC_PROCESS_TIMEOUT=500 # default
615619
```
616620
617621
The timeout to process the request from the Remediation Component to the AppSec Component.
622+
623+
### Nginx variables
624+
625+
Nginx variables can be used to adapt behaviour and or more flexible configurations:
626+
* ngx.var.cs_disable_bouncer: set to 1, it will disable the bouncer
627+
* ngx.var.enable_appsec: set to 1, it will enable the appsec even if it's disabled by configuration or if bouncer is disabled
628+
* ngx.var.disable_appsec: set to 1, it will disable the appsec

0 commit comments

Comments
 (0)