From 8d36ff92261e62de4366852497ffb3f3d748f8b4 Mon Sep 17 00:00:00 2001 From: Kafeel Hasan Date: Mon, 1 Sep 2025 14:32:21 +0530 Subject: [PATCH 1/5] =?UTF-8?q?Update=20NAP=20Docs=20This=20commit=20updat?= =?UTF-8?q?es=20the=20NAP=20user=20facing=20documentation=20with=20the=20f?= =?UTF-8?q?ollowing=20change:=20Based=20on=20this=20issue=20:=20https://gi?= =?UTF-8?q?thub.com/nginxinc/nalb-shared/issues/1695,=20updated=20the=20Co?= =?UTF-8?q?nfigure=20App=20Protect=20WAF=20with=20the=20following=20text?= =?UTF-8?q?=20-=20The=20File=20path=20is=20not=20optional=20and=20is=20aut?= =?UTF-8?q?omatically=20generated=20in=20the=20portal,=20defaulting=20to?= =?UTF-8?q?=20the=20path=20=E2=80=9C/etc/app=5Fprotect/conf/=E2=80=9D=20pl?= =?UTF-8?q?us=20the=20policy=20Name=20with=20a=20=E2=80=9C.json=E2=80=9D?= =?UTF-8?q?=20extension?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/nginxaas-azure/app-protect/configure-waf.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/nginxaas-azure/app-protect/configure-waf.md b/content/nginxaas-azure/app-protect/configure-waf.md index 8a461317c..77690f99c 100644 --- a/content/nginxaas-azure/app-protect/configure-waf.md +++ b/content/nginxaas-azure/app-protect/configure-waf.md @@ -114,7 +114,7 @@ To create a custom security policy in the Azure Portal: 3. Select **Custom Policies** 4. Select **Add Custom Security Policy** to open the policy editor -In the policy editor, enter the **Name**, **File path**, your policy content, and then select **Save**. The **File path** is optional and will default to the path "/etc/app_protect/conf/" plus the policy **Name** with a ".json" extension. After your policy has been saved, you can then reference it in your NGINX configuration. For more information on policy configuration and syntax, refer to the NGINX App Protect [configuration guide](https://docs.nginx.com/nginx-app-protect-waf/v5/configuration-guide/configuration/). +In the policy editor, enter the **Name**, **File path**, your policy content, and then select **Save**. The **File path** is not optional and is automatically generated in the portal, defaulting to the path "/etc/app_protect/conf/" plus the policy **Name** with a ".json" extension. After your policy has been saved, you can then reference it in your NGINX configuration. For more information on policy configuration and syntax, refer to the NGINX App Protect [configuration guide](https://docs.nginx.com/nginx-app-protect-waf/v5/configuration-guide/configuration/). {{< call-out "note" >}}The **name** field within the security policy must be unique among the policies referenced in your NGINX configuration.{{< /call-out >}} @@ -129,3 +129,4 @@ It is highly recommended to use logging to monitor the performance of NGINX App ## What's next [Enable App Protect WAF Logs]({{< ref "/nginxaas-azure/app-protect/enable-logging.md" >}}) + \ No newline at end of file From 03f121d19f79532ca9fb7404f527b8c6d151b4b7 Mon Sep 17 00:00:00 2001 From: Kafeel Hasan Date: Mon, 1 Sep 2025 14:35:38 +0530 Subject: [PATCH 2/5] Removed Extra Space --- content/nginxaas-azure/app-protect/configure-waf.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/nginxaas-azure/app-protect/configure-waf.md b/content/nginxaas-azure/app-protect/configure-waf.md index 77690f99c..bf40ad67e 100644 --- a/content/nginxaas-azure/app-protect/configure-waf.md +++ b/content/nginxaas-azure/app-protect/configure-waf.md @@ -128,5 +128,4 @@ It is highly recommended to use logging to monitor the performance of NGINX App ## What's next -[Enable App Protect WAF Logs]({{< ref "/nginxaas-azure/app-protect/enable-logging.md" >}}) - \ No newline at end of file +[Enable App Protect WAF Logs]({{< ref "/nginxaas-azure/app-protect/enable-logging.md" >}}) \ No newline at end of file From 311ab3783954494f8480d68f94a56f6789396d7a Mon Sep 17 00:00:00 2001 From: Kafeel Hasan Date: Mon, 22 Sep 2025 12:12:52 +0530 Subject: [PATCH 3/5] NLB-7008: Update Module Changelog Removed static content from Module Changelog Simplify API instreuctions and remove outdated module tables Enhanced readibility andf user experience for accessing module versions. --- content/nginxaas-azure/module-changelog.md | 115 +++++---------------- 1 file changed, 28 insertions(+), 87 deletions(-) diff --git a/content/nginxaas-azure/module-changelog.md b/content/nginxaas-azure/module-changelog.md index 7bd572aab..cced28621 100644 --- a/content/nginxaas-azure/module-changelog.md +++ b/content/nginxaas-azure/module-changelog.md @@ -7,47 +7,25 @@ url: /nginxaas/azure/module-changelog/ Learn about the modules supported by the latest versions of F5 NGINXaaS for Azure. -## September 18, 2025 - -### Preview - - {{}} - -| Name | Version | Description | -|------------------------------------------|--------------------------|------------------------------------------------------------------------| -| nginx-plus | 1.29.0 (nginx-plus-r35) | NGINX Plus, provided by Nginx, Inc. | -| nginx-agent | 1.20.16-2026591880 | NGINX Agent - Management for NGINXaaS | -| Operating System | Ubuntu 22.04.5 | Jammy Jellyfish, provided by Canonical Ltd. | -| nginx-plus-module-geoip2 | 35+3.4-1 | NGINX Plus 3rd-party GeoIP2 dynamic modules | -| nginx-plus-module-headers-more | 35+0.37-1 | NGINX Plus 3rd-party headers-more dynamic module | -| nginx-plus-module-image-filter | 35-1 | NGINX Plus image filter dynamic module | -| nginx-plus-module-lua | 35+0.10.28-1 | NGINX Plus 3rd-party Lua dynamic modules | -| nginx-plus-module-ndk | 35+0.3.3-1 | NGINX Plus 3rd-party NDK dynamic module | -| nginx-plus-module-njs | 35+0.9.1-1 | NGINX Plus njs dynamic modules | -| nginx-plus-module-otel | 35+0.1.2-1 | NGINX Plus OpenTelemetry dynamic module | -| nginx-plus-module-xslt | 35-1 | NGINX Plus xslt dynamic module | -| nginx-plus-module-appprotect | 35+5.498.0-1 | NGINX Plus app protect dynamic module version 5.498.0 | -| app-protect-module-plus | 35+5.498.0-1 | App-Protect package for Nginx Plus, includes all of the default files and examples. NGINX App Protect provides web application firewall (WAF) security protection for your web applications, including OWASP Top 10 attacks. | -| app-protect-plugin | 6.20.0-1 | NGINX App Protect plugin | -{{}} - ## Access module versions using data plane API: -To access available module versions from the data plane API, follow these steps: -- View Your API Endpoints and Create an API Key - - Follow the [NGINXaaS data plane API endpoint]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#nginxaas-data-plane-api-endpoint" >}}) and [Create an NGINXaaS data plane API key]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#create-an-nginxaas-data-plane-api-key" >}}) to locate your dataplane API endpoint and create an API key. +To view the versions of the NGINX Plus modules that are part of your deployment, follow these steps: +- Retrieve your [data plane API endpoint]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#nginxaas-data-plane-api-endpoint" >}}) -- Construct the Request URL - - Add `/packages` to your data plane API endpoint, for example `https:///packages`. +- Create an [API key]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#create-an-nginxaas-data-plane-api-key" >}}) if you do not already have one. -- Authenticate API requests - - Encode your API key to Base64 and add the prefix `ApiKey` to the encoded string. - - Set the `Authorization` HTTP header to: - `ApiKey ` +- Construct the package request URL. + - Add **/packages** to your data plane API endpoint. + - For example: `https://my-deployment-b7e43dfb7e26.eastus.nginxaas.net/packages` +- Authenticate the API requests using the **Authorization** HTTP header. + - Encode your API key to **base64** and add the prefix **ApiKey** to the encoded string. + - For example: + - Authorization: ApiKey ZjkzY2ZlYWItZjAxNS01MDAwLTgyM2UtNjBmNjY5ZTUwOWF2 +Request Example: ```shell - curl -H "Authorization: ApiKey " https:///packages + curl -H "Authorization: ApiKey " https:///packages ``` Response Example: @@ -55,63 +33,26 @@ Response Example: { "packages": [ { - "name": "nginx-plus-module-headers-more", - "version":"35+0.37-1~jammy" + "name": "nginx-plus", + "version": "33-4~jammy" + }, + { + "name": "nginx-agent", + "version": "1.20.15-2010533110" + }, + { + "name": "nginx-plus-module-appprotect", + "version": "33+5.264.0-1~jammy" + }, + { + "name": "nginx-plus-module-ndk", + "version": "33+0.3.3-1~jammy" }, { - "name": "nginx-plus-module-otel", - "version": "35+0.1.2-1~jammy" + "name": "nginx-plus-module-njs", + "version": "33+0.8.9-1~jammy" }, ... ] } ``` - - -## July 03, 2025 - -### Stable - - {{< table >}} - -| Name | Version | Description | -|------------------------------------------|--------------------------|------------------------------------------------------------------------| -| nginx-plus | 1.27.2 (nginx-plus-r33-p2) | NGINX Plus, provided by Nginx, Inc. | -| nginx-agent | 1.19.15-1795423089 | NGINX Agent - Management for NGINXaaS | -| Operating System | Ubuntu 22.04.5 | Jammy Jellyfish, provided by Canonical Ltd. | -| nginx-plus-module-geoip2 | 33+3.4-1 | NGINX Plus 3rd-party GeoIP2 dynamic modules | -| nginx-plus-module-headers-more | 33+0.37-1 | NGINX Plus 3rd-party headers-more dynamic module | -| nginx-plus-module-image-filter | 33-1 | NGINX Plus image filter dynamic module | -| nginx-plus-module-lua | 33+0.10.27-1 | NGINX Plus 3rd-party Lua dynamic modules | -| nginx-plus-module-ndk | 33+0.3.3-1 | NGINX Plus 3rd-party NDK dynamic module | -| nginx-plus-module-njs | 33+0.8.9-1 | NGINX Plus njs dynamic modules | -| nginx-plus-module-otel | 33+0.1.0-1 | NGINX Plus OpenTelemetry dynamic module | -| nginx-plus-module-xslt | 33-1 | NGINX Plus xslt dynamic module | -| nginx-plus-module-appprotect | 33+5.264.0-1 | NGINX Plus app protect dynamic module version 5.264.0 | -| app-protect-module-plus | 33+5.264.0-1 | App-Protect package for Nginx Plus, includes all of the default files and examples. NGINX App Protect provides web application firewall (WAF) security protection for your web applications, including OWASP Top 10 attacks. | -| app-protect-plugin | 6.9.0-1 | NGINX App Protect plugin | -{{< /table >}} - - - -### Preview - - {{< table >}} - -| Name | Version | Description | -|------------------------------------------|--------------------------|------------------------------------------------------------------------| -| nginx-plus | 1.27.2 (nginx-plus-r33-p2) | NGINX Plus, provided by Nginx, Inc. | -| nginx-agent | 1.19.15-1795423089 | NGINX Agent - Management for NGINXaaS | -| Operating System | Ubuntu 22.04.5 | Jammy Jellyfish, provided by Canonical Ltd. | -| nginx-plus-module-geoip2 | 33+3.4-1 | NGINX Plus 3rd-party GeoIP2 dynamic modules | -| nginx-plus-module-headers-more | 33+0.37-1 | NGINX Plus 3rd-party headers-more dynamic module | -| nginx-plus-module-image-filter | 33-1 | NGINX Plus image filter dynamic module | -| nginx-plus-module-lua | 33+0.10.27-1 | NGINX Plus 3rd-party Lua dynamic modules | -| nginx-plus-module-ndk | 33+0.3.3-1 | NGINX Plus 3rd-party NDK dynamic module | -| nginx-plus-module-njs | 33+0.8.9-1 | NGINX Plus njs dynamic modules | -| nginx-plus-module-otel | 33+0.1.0-1 | NGINX Plus OpenTelemetry dynamic module | -| nginx-plus-module-xslt | 33-1 | NGINX Plus xslt dynamic module | -| nginx-plus-module-appprotect | 33+5.264.0-1 | NGINX Plus app protect dynamic module version 5.264.0 | -| app-protect-module-plus | 33+5.264.0-1 | App-Protect package for Nginx Plus, includes all of the default files and examples. NGINX App Protect provides web application firewall (WAF) security protection for your web applications, including OWASP Top 10 attacks. | -| app-protect-plugin | 6.9.0-1 | NGINX App Protect plugin | -{{< /table >}} From 335ae556060e69b9cb49a859d2d93720a60b1eb9 Mon Sep 17 00:00:00 2001 From: Kafeel Hasan Date: Mon, 22 Sep 2025 22:08:06 +0530 Subject: [PATCH 4/5] Add missing period --- content/nginxaas-azure/module-changelog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/nginxaas-azure/module-changelog.md b/content/nginxaas-azure/module-changelog.md index cced28621..557c5d7fe 100644 --- a/content/nginxaas-azure/module-changelog.md +++ b/content/nginxaas-azure/module-changelog.md @@ -10,7 +10,7 @@ Learn about the modules supported by the latest versions of F5 NGINXaaS for Azur ## Access module versions using data plane API: To view the versions of the NGINX Plus modules that are part of your deployment, follow these steps: -- Retrieve your [data plane API endpoint]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#nginxaas-data-plane-api-endpoint" >}}) +- Retrieve your [data plane API endpoint]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#nginxaas-data-plane-api-endpoint" >}}). - Create an [API key]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#create-an-nginxaas-data-plane-api-key" >}}) if you do not already have one. From 898b3c0d690752a775f51a05085200c9f37d9c3b Mon Sep 17 00:00:00 2001 From: Kafeel Hasan Date: Tue, 23 Sep 2025 11:31:06 +0530 Subject: [PATCH 5/5] update module-changelog.md --- content/nginxaas-azure/module-changelog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/nginxaas-azure/module-changelog.md b/content/nginxaas-azure/module-changelog.md index 557c5d7fe..76bc8c357 100644 --- a/content/nginxaas-azure/module-changelog.md +++ b/content/nginxaas-azure/module-changelog.md @@ -9,7 +9,7 @@ Learn about the modules supported by the latest versions of F5 NGINXaaS for Azur ## Access module versions using data plane API: -To view the versions of the NGINX Plus modules that are part of your deployment, follow these steps: +To view the version of the NGINX Plus modules that are part of your deployment, follow these steps: - Retrieve your [data plane API endpoint]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#nginxaas-data-plane-api-endpoint" >}}). - Create an [API key]({{< ref "/nginxaas-azure/loadbalancer-kubernetes.md#create-an-nginxaas-data-plane-api-key" >}}) if you do not already have one.