@@ -202,7 +202,118 @@ sudo apt-get install app-protect
202202
203203## Update configuration files
204204
205- {{< include "waf/install-update-configuration.md" >}}
205+ Once you have installed F5 WAF for NGINX, you must load it as a module in the main context of your NGINX configuration.
206+
207+ ``` nginx
208+ load_module modules/ngx_http_app_protect_module.so;
209+ ```
210+
211+ And finally, F5 WAF for NGINX can enabled on a _ http_ , _ server_ or _ location_ context:
212+
213+ ``` nginx
214+ app_protect_enable on;
215+ ```
216+
217+ {{< call-out "warning" >}}
218+
219+ You should only enable F5 WAF for NGINX on _ proxy_pass_ and _ grpc_pass_ locations.
220+
221+ {{< /call-out >}}
222+
223+ Here are two examples of how these additions could look in configuration files:
224+
225+ {{< tabs name="configuration-examples" >}}
226+
227+ {{% tab name="nginx.conf" %}}
228+
229+ The default path for this file is ` /etc/nginx/nginx.conf ` .
230+
231+ ``` nginx {hl_lines=[5]}
232+ user nginx;
233+ worker_processes auto;
234+
235+ # F5 WAF for NGINX
236+ load_module modules/ngx_http_app_protect_module.so;
237+
238+ error_log /var/log/nginx/error.log notice;
239+ pid /var/run/nginx.pid;
240+
241+
242+ events {
243+ worker_connections 1024;
244+ }
245+
246+ http {
247+ include /etc/nginx/mime.types;
248+ default_type application/octet-stream;
249+
250+ log_format main '$remote_addr - $remote_user [$time_local] "$request" '
251+ '$status $body_bytes_sent "$http_referer" '
252+ '"$http_user_agent" "$http_x_forwarded_for"';
253+
254+ access_log /var/log/nginx/access.log main;
255+
256+ sendfile on;
257+ #tcp_nopush on;
258+
259+ keepalive_timeout 65;
260+
261+ #gzip on;
262+
263+ include /etc/nginx/conf.d/*.conf;
264+ }
265+ ```
266+
267+ {{% /tab %}}
268+
269+ {{% tab name="default.conf" %}}
270+
271+ The default path for this file is ` /etc/nginx/conf.d/default.conf ` .
272+
273+ ``` nginx {hl_lines=[9]}
274+ server {
275+ listen 80;
276+ server_name domain.com;
277+
278+
279+ location / {
280+
281+ # F5 WAF for NGINX
282+ app_protect_enable on;
283+
284+ client_max_body_size 0;
285+ default_type text/html;
286+ proxy_pass http://127.0.0.1:8080/;
287+ }
288+ }
289+
290+ server {
291+ listen 8080;
292+ server_name localhost;
293+
294+
295+ location / {
296+ root /usr/share/nginx/html;
297+ index index.html index.htm;
298+ }
299+
300+ # redirect server error pages to the static page /50x.html
301+ #
302+ error_page 500 502 503 504 /50x.html;
303+ location = /50x.html {
304+ root /usr/share/nginx/html;
305+ }
306+ }
307+ ```
308+
309+ {{% /tab %}}
310+
311+ {{< /tabs >}}
312+
313+ Once you have updated your configuration files, you can reload NGINX to apply the changes. You have two options depending on your environment:
314+
315+ - ` nginx -s reload `
316+ - ` sudo systemctl reload nginx `
206317
207318## Post-installation checks
208319
0 commit comments