Skip to content

Commit fddbadd

Browse files
committed
Updating after adding information from NVSHAS-9962.
Signed-off-by: Sunil Singh <[email protected]>
1 parent d15b5ae commit fddbadd

File tree

2 files changed

+34
-20
lines changed

2 files changed

+34
-20
lines changed

docs/02.deploying/10.remove/10.remove.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,21 +29,28 @@ In addition to deleting as discussed above and redeploying NeuVector, the follow
2929

3030
The admin password is the key to administering the NeuVector deployment and viewing the cluster network activities. It is important to change the password upon install and keep it safely guarded. If you have `kubectl` access to the cluster, you can reset the admin password to the default using the following steps.
3131

32-
Bash access is disabled by default to harden NeuVector pod security. If resetting the admin password, you need to first disable `nv_protect` which is tied to the Enforcer where the Controller is running in order to access Bash.
32+
Consul CLI access is disabled by default to harden NeuVector pod security. If resetting the admin password, you need to first disable `nv_protect` which is tied to the Enforcer where the Controller is running in order to access the consul CLI. The below `override.yaml` configuration can be applied by an admin user to disable `nv_protect` and allows for running your consul CLI directly in the Controller pods.
3333

34-
1. Execute the command below through the NeuVector CLI to disable `nv_protect`, then you will be able to `kubectl exec` into the specified Controller.
34+
:::important
3535

36-
```shell
37-
set enforcer <enforcer_id> nv_protect disable true
38-
```
36+
If using continuous delivery in your deployment, you can add a temporary admin user by enabling the attribute `always_reload: true` noted in the example `userinitcfg.yaml` in the [ConfigMap](/deploying/production/configmap/#complete-sample-neuvector-configmap-initcfgyaml) and then following the steps below.
37+
38+
:::
39+
40+
```yaml
41+
enforcer:
42+
env:
43+
- name: ENFORCER_SKIP_NV_PROTECT
44+
value: "1"
45+
```
3946
40-
2. `kubectl exec` into one of the Controllers.
47+
1. `kubectl exec` into one of the Controllers.
4148

4249
```shell
4350
kubectl exec -it <controller> -n neuvector -- sh
4451
```
4552

46-
3. Check that the admin entry exists and save the output JSON somewhere for safe keeping.
53+
2. Check that the admin entry exists and save the output JSON somewhere for safe keeping.
4754

4855
```shell
4956
consul kv get object/config/user/admin
@@ -55,13 +62,13 @@ Bash access is disabled by default to harden NeuVector pod security. If resettin
5562

5663
:::
5764

58-
4. Take the output from the above `consul kv get` command and replace the `password_hash` string with the below string.
65+
3. Take the output from the above `consul kv get` command and replace the `password_hash` string with the below string.
5966

6067
```shell
6168
c7ad44cbad762a5da0a452f9e854fdc1e0e7a52a38015f23f3eab1d80b931dd472634dfac71cd34ebc35d16ab7fb8a90c81f975113d6c7538dc69dd8de9077ec
6269
```
6370

64-
5. Reset the admin account password back to the default.
71+
4. Reset the admin account password back to the default.
6572

6673
:::warning
6774

@@ -85,4 +92,4 @@ Bash access is disabled by default to harden NeuVector pod security. If resettin
8592
Success! Data written to: object/config/user/admin
8693
```
8794

88-
6. Login with admin/admin and the change password.
95+
5. Login with admin/admin and change the password.

versioned_docs/version-5.4/02.deploying/10.remove/10.remove.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,21 +29,28 @@ In addition to deleting as discussed above and redeploying NeuVector, the follow
2929

3030
The admin password is the key to administering the NeuVector deployment and viewing the cluster network activities. It is important to change the password upon install and keep it safely guarded. If you have `kubectl` access to the cluster, you can reset the admin password to the default using the following steps.
3131

32-
Starting in v5.4.3, Bash access is disabled by default to harden NeuVector pod security. If resetting the admin password, you need to first disable `nv_protect` which is tied to the Enforcer where the Controller is running in order to access Bash.
32+
Starting in v5.4.3, consul CLI access is disabled by default to harden NeuVector pod security. If resetting the admin password, you need to first disable `nv_protect` which is tied to the Enforcer where the Controller is running in order to access the consul CLI. The below `override.yaml` configuration can be applied by an admin user to disable `nv_protect` and allows for running your consul CLI directly in the Controller pods.
3333

34-
1. Execute the command below through the NeuVector CLI to disable `nv_protect`, then you will be able to `kubectl exec` into the specified Controller.
34+
:::important
3535

36-
```shell
37-
set enforcer <enforcer_id> nv_protect disable true
38-
```
36+
If using continuous delivery in your deployment, you can add a temporary admin user by enabling the attribute `always_reload: true` noted in the example `userinitcfg.yaml` in the [ConfigMap](/deploying/production/configmap/#complete-sample-neuvector-configmap-initcfgyaml) and then following the steps below.
37+
38+
:::
39+
40+
```yaml
41+
enforcer:
42+
env:
43+
- name: ENFORCER_SKIP_NV_PROTECT
44+
value: "1"
45+
```
3946
40-
2. `kubectl exec` into one of the Controllers.
47+
1. `kubectl exec` into one of the Controllers.
4148

4249
```shell
4350
kubectl exec -it <controller> -n neuvector -- sh
4451
```
4552

46-
3. Check that the admin entry exists and save the output JSON somewhere for safe keeping.
53+
2. Check that the admin entry exists and save the output JSON somewhere for safe keeping.
4754

4855
```shell
4956
consul kv get object/config/user/admin
@@ -55,13 +62,13 @@ Starting in v5.4.3, Bash access is disabled by default to harden NeuVector pod s
5562

5663
:::
5764

58-
4. Take the output from the above `consul kv get` command and replace the `password_hash` string with the below string.
65+
3. Take the output from the above `consul kv get` command and replace the `password_hash` string with the below string.
5966

6067
```shell
6168
c7ad44cbad762a5da0a452f9e854fdc1e0e7a52a38015f23f3eab1d80b931dd472634dfac71cd34ebc35d16ab7fb8a90c81f975113d6c7538dc69dd8de9077ec
6269
```
6370

64-
5. Reset the admin account password back to the default.
71+
4. Reset the admin account password back to the default.
6572

6673
:::warning
6774

@@ -85,4 +92,4 @@ Starting in v5.4.3, Bash access is disabled by default to harden NeuVector pod s
8592
Success! Data written to: object/config/user/admin
8693
```
8794

88-
6. Login with admin/admin and change the password.
95+
5. Login with admin/admin and change the password.

0 commit comments

Comments
 (0)