Skip to content

Commit 50a7fc0

Browse files
committed
update per production UI
Clarify steps
1 parent d97eb53 commit 50a7fc0

File tree

4 files changed

+17
-18
lines changed

4 files changed

+17
-18
lines changed

content/includes/nginx-one/how-to/generate-data-plane-key.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,13 @@ files:
77

88
A data plane key is a security token that ensures only trusted NGINX instances can register and communicate with NGINX One.
99

10-
To generate a data plane key:
10+
To generate a data plane key, select **Manage > Instances > Add Instance**:
1111

1212
- **For a new key:** In the **Add Instance** pane, select **Generate Data Plane Key**.
1313
- **To reuse an existing key:** If you already have a data plane key and want to use it again, select **Use existing key**. Then, enter the key's value in the **Data Plane Key** box.
1414

1515
{{<call-out "caution" "Data plane key guidelines" "fas fa-key" >}}
1616
Data plane keys are displayed only once and cannot be retrieved later. Be sure to copy and store this key securely.
1717

18-
Data plane keys expire after one year. You can change this expiration date later by [editing the key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#change-expiration-date" >}}).
19-
20-
If you [Revoke a data plane key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#revoke-data-plane-key" >}}) you disconnect all instances registered with that key.
18+
Data plane keys expire after one year. You can change this expiration date later by [editing the key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#change-expiration-date" >}}). If you [revoke a data plane key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#revoke-data-plane-key" >}}) you disconnect all instances registered with that key.
2119
{{</call-out>}}

content/includes/nginx-one/how-to/install-nginx-agent.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,16 @@ files:
55
- content/nginx-one/getting-started.md
66
---
77

8-
After entering your data plane key, you'll see a `curl` command similar to the one below. Copy and run this command on each NGINX instance to install NGINX Agent. Once installed, NGINX Agent typically registers with NGINX One within a few seconds.
8+
After entering your data plane key, you'll see a `curl` command to install NGINX Agent, similar to the one below. Copy and run this command on each NGINX instance. Once installed, NGINX Agent typically registers with NGINX One within a few seconds.
99

1010
{{<call-out "important" "Connecting to NGINX One" >}}
11-
NGINX Agent must be able to establish a connection to NGINX One Console's Agent endpoint (`agent.connect.nginx.com`). Ensure that any firewall rules you have in place for your NGINX hosts allows network traffic to port `443` for all of the following IPs:
11+
Ensure that any firewall rules you have in place for your NGINX hosts allows network traffic to port `443` for all of the following IPs:
1212

1313
- `3.135.72.139`
1414
- `3.133.232.50`
1515
- `52.14.85.249`
16+
17+
NGINX Agent must be able to establish a connection to NGINX One Console's Agent endpoint (`agent.connect.nginx.com`).
1618
{{</call-out>}}
1719

1820
To install NGINX Agent on an NGINX instance:

content/nginx-one/_index.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,9 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
4040
{{<card title="Manage your NGINX instances" titleUrl="/nginx-one/nginx-configs/" >}}
4141
Manage one instance or groups of instances. Monitor certificates. Set up metrics.
4242
{{</card>}}
43-
{{<card title="Secure with NGINX App Protect" titleUrl="/nginx-one/nap-integration/" >}}
44-
Manage one instance or groups of instances. Monitor certificates. Set up metrics.
45-
{{</card>}}
43+
{{<card title="Connect Kubernetes deployments" titleUrl="/nginx-one/k8s/">}}
44+
Monitor deployments for CVEs and certificates
45+
{{</ card >}}
4646
{{</card-section>}}
4747
{{</card-layout>}}
4848

@@ -53,9 +53,6 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
5353
{{<card title="Secure with NGINX App Protect" titleUrl="/nginx-one/nap-integration/" >}}
5454
Set up security policies by instance and group
5555
{{</card>}}
56-
{{<card title="Connect Kubernetes deployments" titleUrl="/nginx-one/k8s/">}}
57-
Monitor deployments for CVEs and certificates
58-
{{</ card >}}
5956
{{<card title="Organize users with RBAC" titleUrl="/nginx-one/rbac/" >}}
6057
Assign responsibilities with role-based access control
6158
{{</card>}}

content/nginx-one/secure-your-fleet/secure.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ If you already have accessed F5 Distributed Cloud and have NGINX instances avail
2727

2828
### Confirm access to the F5 Distributed Cloud
2929

30-
Confirm an F5 Distributed Cloud tenant has been provisioned for you. Log in to MyF5 and review your subscriptions. You should see within one of your subscriptions "Distributed Cloud". This could be in either an NGINX subscription or a Distributed Cloud. If the above does not appear in any of your subscriptions, reach out to either your F5 Account Team or Customer Success Manager.
30+
Confirm an F5 Distributed Cloud tenant has been provisioned for you. Log in to the [MyF5](https://my.f5.com) customer portal and review your subscriptions. You should see within one of your subscriptions "Distributed Cloud". This could be in either an NGINX subscription or a Distributed Cloud. If the above does not appear in any of your subscriptions, reach out to either your F5 Account Team or Customer Success Manager.
3131

3232
With access, you or someone in your organization should have an email from [email protected] asking you to update your password when the tenant was created. The account name referenced in the email in bold is the tenant name.
3333

@@ -48,7 +48,7 @@ Alternatively, we also have instructions for [Deploying NGINX and NGINX Plus wit
4848
## Connect at least one NGINX instance to the NGINX One Console
4949

5050
If you already have connected instances to the NGINX One Console, you can start to [Configure an active alert policy]({{< ref "/nginx-one/secure-your-fleet/secure.md#configure-an-active-alert-policy" >}}).
51-
Otherwise, you need to generate a data plane key, add an instance, and install NGINX Agent. We assume this is the first time you are connecting an instance.
51+
Otherwise, you need to add an instance, generate a data plane key, and install NGINX Agent. We assume this is the first time you are connecting an instance.
5252

5353
### Add an instance
5454

@@ -85,8 +85,8 @@ To configure security-related alerts, follow these steps:
8585
1. (Optional) Specify a label and description.
8686
1. Under **Receiver**, select **Email** and enter your email address.
8787
1. Select **Add Alert Receiver**
88-
1. Your email receiver should now appear on the list of Alert Receivers.
89-
1. Under the **Actions** column, select **Verify Email**.
88+
Your alert receiver should now appear on the list of Alert Receivers.
89+
1. Select the **Actions** ellipsis (...) for your receiver. Select **Verify Email**.
9090
1. Select **Send email** to confirm.
9191
1. You should receive a verification code in the email provided. Copy that code.
9292
1. Under the **Actions** column, select **Enter verification code**.
@@ -105,13 +105,15 @@ Next, configure the policy that identifies when you'll get an alert.
105105
1. Select **Add Item**.
106106
1. Under **Select Alerts** select a filter. If you're interested in all NGINX alerts, select **Matching RegEx of Alertname**. In the text box that appears, enter **NGINX**.
107107
1. Set the **Action as Send** and select **Apply**.
108-
1. Select **Apply** again, and then select **Apply Alert Policy**.
109108

110109
Now set a second alert related to Common Vulnerabilities and Exposures (CVEs).
111110

112111
1. Select **Add Item**
112+
1. Under **Select Alerts** select a filter. If you're interested in all CVEs, select **Matching RegEx of Alertname**. In the text box that appears, enter **CVE**.
113113
1. Under **Select Alerts**, set the **Action** as **Send** and select **Apply**
114-
1. Select **Save and Exit**
114+
You should now see two alerts under **Policy Rules**.
115+
1. Select **Apply** to save thse policies.
116+
1. Select **Add Alert Policy**.
115117

116118
You've now set up F5 Distributed Cloud to send you security-related alerts from NGINX One Console.
117119

0 commit comments

Comments
 (0)