Skip to content

Commit d4d46c3

Browse files
committed
feat: Add JWT step using includes
1 parent 1445026 commit d4d46c3

File tree

2 files changed

+45
-36
lines changed

2 files changed

+45
-36
lines changed
Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,17 @@
11
1. Add the NGINX Plus apk repository to `/etc/apk/repositories` file:
22

3-
```shell
4-
printf "https://pkgs.nginx.com/plus/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
5-
```
3+
```shell
4+
printf "https://pkgs.nginx.com/plus/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
5+
```
66

77
2. Add the NGINX App Protect WAF v5 repository:
88

9-
```shell
10-
printf "https://pkgs.nginx.com/app-protect-x-plus/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
11-
```
9+
```shell
10+
printf "https://pkgs.nginx.com/app-protect-x-plus/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
11+
```
12+
13+
3. Install the NGINX App Protect WAF v5 package:
14+
15+
```shell
16+
sudo apk add app-protect-module-plus
17+
```

content/nap-waf/v5/admin-guide/install.md

Lines changed: 33 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ docs: DOCS-1363
1111

1212
- Active F5 NGINX App Protect WAF subscription in [MyF5](https://my.f5.com/) (purchased or trial).
1313
- Docker (with Docker Compose) is [installed and running](https://docs.docker.com/engine/install/).
14-
- A [supported operating system]({{< relref "/nginx/technical-specs.md#appprotect" >}}) (OS).
14+
- A [supported operating system]({{< relref "/nap-waf/v5/admin-guide/overview.md#technical-specifications" >}}).
1515

1616
## Install NGINX and NGINX App Protect WAF Module
1717

18-
If you already have NGINX packages in your system, back up your configs and logs:
18+
If you already have NGINX packages in your system, back up your configuration and log files:
1919

2020
```shell
2121
sudo cp -a /etc/nginx /etc/nginx-plus-backup
@@ -56,7 +56,7 @@ Please follow these steps before you install either NGINX Open Source or NGINX P
5656

5757
{{%/tab%}}
5858

59-
{{%tab name="Oracle Linux 8.1+"%}}
59+
{{%tab name="Oracle Linux"%}}
6060

6161
{{< include "nap-waf/config/v5/host-based-nginx-instructions/common-steps-with-dnf.md" >}}
6262

@@ -175,7 +175,7 @@ sudo apt-get install nginx=1.25.5-1~`lsb_release -cs` app-protect-module-oss
175175

176176
{{%/tab%}}
177177

178-
{{%tab name="Oracle Linux 8.1+"%}}
178+
{{%tab name="Oracle Linux"%}}
179179

180180
{{< include "nap-waf/config/v5/host-based-nginx-instructions/nginx-oss-centos-7.md" >}}
181181

@@ -198,50 +198,45 @@ sudo apt-get install nginx=1.25.5-1~`lsb_release -cs` app-protect-module-oss
198198
---
199199

200200
### For NGINX Plus
201-
{{<tabs name="for_nginx_plus">}}
202201

203-
{{%tab name="Alpine Linux 3.16/3.17/3.19"%}}
202+
To use NGINX Plus, you will need to download the the JWT license file associated with your NGINX Plus subscription from the MyF5 Customer Portal:
204203

205-
{{< include "nap-waf/config/v5/host-based-nginx-instructions/nginx-plus-alpine.md" >}}
204+
{{< include "licensing-and-reporting/download-jwt-from-myf5.md" >}}
206205

207-
3. Install the NGINX App Protect WAF v5 package:
206+
Once you have the license file:
208207

209-
```shell
210-
sudo apk add app-protect-module-plus
211-
```
208+
{{< include "licensing-and-reporting/apply-jwt.md" >}}
209+
210+
Then you can move onto the next step, depending on your chosen operating system.
211+
212+
{{<tabs name="for_nginx_plus">}}
213+
214+
{{%tab name="Alpine Linux"%}}
215+
216+
{{< include "nap-waf/config/v5/host-based-nginx-instructions/nginx-plus-alpine.md" >}}
212217

213218
{{%/tab%}}
214219

215-
{{%tab name="Amazon Linux 2"%}}
220+
{{%tab name="Amazon Linux"%}}
216221

217-
1. Download the NGINX Plus repository file [nginx-plus-amazon2.repo](https://cs.nginx.com/static/files/nginx-plus-amazon2.repo) to `/etc/yum.repos.d`:
222+
1. Download the NGINX Plus repository file [plus-amazonlinux2023.repo](https://cs.nginx.com/static/files/plus-amazonlinux2023.repo) to `/etc/yum.repos.d`:
218223

219224
```shell
220-
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nginx-plus-amazon2.repo
225+
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-amazonlinux2023.repo
221226
```
222227

223-
2. Create NGINX App Protect WAF v5 repository file, named `/etc/yum.repos.d/app-protect-x-plus.repo` with the following contents:
228+
1. Create NGINX App Protect WAF v5 repository file, named `/etc/yum.repos.d/app-protect-x-plus.repo` with the following contents:
224229

225230
```none
226231
[app-protect-x-plus]
227232
name=nginx-app-protect repo
228-
baseurl=https://pkgs.nginx.com/app-protect-x-plus/centos/7/$basearch/
233+
baseurl=https://pkgs.nginx.com/app-protect-x-plus/amzn/2023/$basearch/
229234
sslclientcert=/etc/ssl/nginx/nginx-repo.crt
230235
sslclientkey=/etc/ssl/nginx/nginx-repo.key
231236
gpgcheck=0
232237
enabled=1
233238
```
234239

235-
3. Install the NGINX App Protect WAF v5 package:
236-
237-
```shell
238-
sudo yum install app-protect-module-plus
239-
```
240-
241-
{{%/tab%}}
242-
{{%tab name="Amazon Linux 2023"%}}
243-
244-
{{< include "nap-waf/config/v5/host-based-nginx-instructions/nginx-plus-amzn2023.md" >}}
245240

246241
3. Install the NGINX App Protect WAF v5 package:
247242

@@ -250,11 +245,7 @@ sudo apt-get install nginx=1.25.5-1~`lsb_release -cs` app-protect-module-oss
250245
```
251246

252247
{{%/tab%}}
253-
{{%tab name="Centos 7.4+"%}}
254-
255-
{{< include "nap-waf/config/v5/host-based-nginx-instructions/nginx-plus-centos-7.md" >}}
256248

257-
{{%/tab%}}
258249
{{%tab name="Debian 11"%}}
259250

260251
{{< include "nap-waf/config/v5/host-based-nginx-instructions/nginx-plus-debian.md" >}}
@@ -357,6 +348,8 @@ sudo apt-get install nginx=1.25.5-1~`lsb_release -cs` app-protect-module-oss
357348
{{%/tab%}}
358349
{{</tabs>}}
359350

351+
---
352+
360353
## NGINX Configuration
361354

362355
In your nginx configuration:
@@ -794,6 +787,16 @@ Please follow these steps before you install either NGINX Open Source or NGINX P
794787
795788
### For NGINX Plus
796789
790+
To use NGINX Plus, you will need to download the the JWT license file associated with your NGINX Plus subscription from the MyF5 Customer Portal:
791+
792+
{{< include "licensing-and-reporting/download-jwt-from-myf5.md" >}}
793+
794+
Once you have the license file:
795+
796+
{{< include "licensing-and-reporting/apply-jwt.md" >}}
797+
798+
Then you can move onto the next step, depending on your chosen operating system.
799+
797800
{{<tabs name="offline_for_nginx_plus">}}
798801
799802
{{%tab name="Alpine Linux 3.16/3.17/3.19"%}}

0 commit comments

Comments
 (0)