Skip to content

Commit c60b8d9

Browse files
committed
Initial WAF support for NGINXaaS for Google
Support for enabling WAF per deployment, NGINX configurations with WAF, and WAF logging.
1 parent 323b20b commit c60b8d9

5 files changed

Lines changed: 49 additions & 3 deletions

File tree

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
f5-product: NGOOGL
3+
f5-files:
4+
- content/nginxaas-google/monitoring/enable-nginx-logs.md
5+
---
6+
7+
You can enable security logs by adding **app_protect_security_log** directives to your NGINX configuration to specify the location of the logs and formats. The log path should always be configured to be inside **/var/log/app_protect**.
8+
9+
```nginx
10+
app_protect_security_log_enable on;
11+
app_protect_security_log log_default /var/log/app_protect/security.log;
12+
```
13+
14+
NGINXaaS does not support custom logging profiles and is limited to the [default logging profiles]({{< ref "/waf/logging/logs-overview.md#default-logging-profile-bundles" >}}).
15+
16+
{{< call-out "warning" >}}Keep F5 WAF for NGINX logs in the **/var/log/app_protect** directory. Otherwise, you may lose data from your logs.
17+
{{< /call-out >}}

content/nginxaas-google/changelog.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,15 @@ Learn about the latest updates, new features, and resolved bugs in F5 NGINXaaS f
1212

1313
To see a list of currently active issues, visit the [Known issues]({{< ref "/nginxaas-google/known-issues.md" >}}) page.
1414

15+
16+
## May 15, 2026
17+
18+
- {{% icon-feature %}} **NGINXaaS for Google now supports F5 WAF for NGINX (Preview)**
19+
20+
You can now deploy NGINXaaS with [F5 WAF for NGINX]({{< ref "/waf" >}}); an advanced high-performance web application firewall (WAF) to provide protection from OWASP Top 10 web application security risks.
21+
22+
**Note:** This feature is currently in Preview and free to use during the preview period. Custom security policies and custom logging profiles are not yet supported.
23+
1524
## April 16, 2026
1625

1726
- {{% icon-feature %}} **NGINXaaS for Google now supports Managed Public Endpoint deployments (Preview)**

content/nginxaas-google/getting-started/create-deployment/deploy-console.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,7 @@ Next, create a new NGINXaaS deployment using the NGINXaaS Console:
6060
- Add an optional description for your deployment.
6161
- Change the **NCU Capacity** if needed.
6262
- The default value of `20 NCU` should be adequate for most scenarios.
63+
- Enable **WAF** if you want [F5 WAF for NGINX]({{< ref "/waf" >}}) enabled for your deployment.
6364
- In the Apply Configuration section, select an NGINX configuration [you created earlier](#create-or-import-an-nginx-configuration) from the **Choose Configuration** list.
6465
- Select a **Configuration Version** from the list.
6566
- In the Cloud Details section, enter the network attachment ID that [you created earlier](#create-a-network-attachment) or select it in the **Network attachment** list.
@@ -78,7 +79,7 @@ In the NGINXaaS Console,
7879

7980
1. To open the details of your deployment, select its name from the list of deployments.
8081
- You can view the details of your deployment, including the status, region, network attachment, NGINX configuration, and more.
81-
1. Select **Edit** to modify the deployment description, and NCU Capacity.
82+
1. Select **Edit** to modify the deployment description, NCU Capacity, and WAF enablement.
8283
- You can also configure monitoring from here. Detailed instructions can be found in [Enable Monitoring]({{< ref "/nginxaas-google/monitoring/enable-monitoring.md" >}})
8384
1. Select **Update** to save your changes.
8485
1. Select the Configuration tab to view the current NGINX configuration associated with the deployment.

content/nginxaas-google/getting-started/nginx-configuration/overview.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,9 @@ For connection and request rate limiting, consider using these NGINX modules:
7878

7979
## Configuration directives list
8080

81-
NGINXaaS supports a limited set of NGINX directives.
81+
NGINXaaS supports a limited set of NGINX directives. The directives with the "app_protect" prefix require [F5 WAF for NGINX]({{< ref "/waf" >}}) to be enabled for the deployment.
82+
83+
NGINXaaS does not yet support F5 WAF for NGINX custom security policies or logging profiles. Support is limited to the [prebuilt policies]({{< ref "/waf/policies/configuration.md#default-policy" >}}) and the [default logging profiles]({{< ref "/waf/logging/logs-overview.md#default-logging-profile-bundles" >}}).
8284

8385
{{< details summary="Alphabetical index of directives">}}
8486

@@ -99,6 +101,19 @@ NGINXaaS supports a limited set of NGINX directives.
99101
[allow (ngx_stream_access_module)](https://nginx.org/en/docs/stream/ngx_stream_access_module.html#allow)\
100102
[ancient_browser](https://nginx.org/en/docs/http/ngx_http_browser_module.html#ancient_browser)\
101103
[ancient_browser_value](https://nginx.org/en/docs/http/ngx_http_browser_module.html#ancient_browser_value)\
104+
[app_protect_compressed_requests_action]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_compressed_requests_action" >}})\
105+
[app_protect_cookie_seed]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_cookie_seed" >}})\
106+
[app_protect_cpu_thresholds]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_cpu_thresholds" >}})\
107+
[app_protect_custom_log_attribute]({{< ref "/waf/policies/directives/#f5-waf-for-nginx-directives:~:text=app_protect_custom_log_attribute" >}})\
108+
[app_protect_enable]({{< ref "/waf/policies/directives/#f5-waf-for-nginx-directives:~:text=modules/ngx_http_app_protect_module.so-,app_protect_enable" >}})\
109+
[app_protect_failure_mode_action]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_failure_mode_action" >}})\
110+
[app_protect_physical_memory_util_thresholds]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_physical_memory_util_thresholds" >}})\
111+
[app_protect_policy_file](<{{< ref "/waf/policies/directives/#f5-waf-for-nginx-directives:~:text=app_protect_enable%20on-%2Capp_protect_policy_file" >}}>)\
112+
[app_protect_reconnect_period_seconds]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_reconnect_period_seconds" >}})\
113+
[app_protect_request_buffer_overflow_action]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_request_buffer_overflow_action" >}})\
114+
[app_protect_security_log]({{< ref "/waf/policies/directives/#f5-waf-for-nginx-directives:~:text=app_protect_security_log" >}})\
115+
[app_protect_security_log_enable]({{< ref "/waf/policies/directives/#f5-waf-for-nginx-directives:~:text=app_protect_security_log_enable" >}})\
116+
[app_protect_user_defined_signatures]({{< ref "/waf/policies/directives/#global-directives:~:text=app_protect_user_defined_signatures" >}})\
102117
[auth_basic](https://nginx.org/en/docs/http/ngx_http_auth_basic_module.html#auth_basic)\
103118
[auth_basic_user_file](https://nginx.org/en/docs/http/ngx_http_auth_basic_module.html#auth_basic_user_file)\
104119
[auth_delay](https://nginx.org/en/docs/http/ngx_http_core_module.html#auth_delay)\

content/nginxaas-google/monitoring/enable-nginx-logs.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ f5-content-type: how-to
88
f5-product: NGOOGL
99
---
1010

11-
F5 NGINXaaS for Google (NGINXaaS) supports integrating with Google Cloud services to collect NGINX error and access logs.
11+
F5 NGINXaaS for Google (NGINXaaS) supports integrating with Google Cloud services to collect NGINX error and access logs, and F5 WAF for NGINX security logs.
1212

1313
## Prerequisites
1414

@@ -24,6 +24,10 @@ F5 NGINXaaS for Google (NGINXaaS) supports integrating with Google Cloud service
2424

2525
{{< include "/nginxaas-google/logging-config-access-logs.md" >}}
2626

27+
## Setting up F5 WAF for NGINX security logs
28+
29+
{{< include "/nginxaas-google/logging-config-security-logs.md" >}}
30+
2731
## Export NGINX logs to a Google Cloud Project
2832

2933
To enable sending logs to your desired Google Cloud project, you must specify the project ID when creating or updating a deployment. To create a deployment, see [our documentation on creating an NGINXaaS deployment]({{< ref "/nginxaas-google/getting-started/create-deployment/" >}}) for a step-by-step guide. To update the deployment, in the NGINXaaS console,

0 commit comments

Comments
 (0)