diff --git a/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/replicated-cluster.mdx b/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/replicated-cluster.mdx index 7ca61d1fd6..40edf78677 100644 --- a/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/replicated-cluster.mdx +++ b/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/replicated-cluster.mdx @@ -36,6 +36,12 @@ Load the snapshot holding the secret you want to recover: + + +@include 'sysadmin/snapshots/load-snapshot/gui/gui.mdx' + + + @@ -104,6 +110,12 @@ You can check for a loaded snapshot by listing the loaded snapshots: + + +@include 'sysadmin/snapshots/list-snapshots/gui.mdx' + + + @include 'sysadmin/snapshots/list-snapshots/cli.mdx' @@ -130,6 +142,12 @@ storage. + + +@include 'sysadmin/snapshots/secret-restore/recover/gui.mdx' + + + @include 'sysadmin/snapshots/secret-restore/recover/cli.mdx' @@ -150,6 +168,12 @@ storage. + + +@include 'sysadmin/snapshots/secret-restore/verify/gui.mdx' + + + @include 'sysadmin/snapshots/secret-restore/verify/cli.mdx' diff --git a/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/single-cluster.mdx b/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/single-cluster.mdx index e33aa81a21..bbbfbc9cf7 100644 --- a/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/single-cluster.mdx +++ b/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/single-cluster.mdx @@ -31,6 +31,12 @@ Load the snapshot holding the secret you want to recover. + + +@include 'sysadmin/snapshots/load-snapshot/gui/gui.mdx' + + + @@ -99,6 +105,12 @@ updating the loaded snapshot as new automated snapshots are created. You can check for a loaded snapshot by listing the loaded snapshots: + + + +@include 'sysadmin/snapshots/list-snapshots/gui.mdx' + + @@ -126,6 +138,12 @@ storage. + + +@include 'sysadmin/snapshots/secret-restore/recover/gui.mdx' + + + @include 'sysadmin/snapshots/secret-restore/recover/cli.mdx' @@ -146,6 +164,12 @@ storage. + + +@include 'sysadmin/snapshots/secret-restore/verify/gui.mdx' + + + @include 'sysadmin/snapshots/secret-restore/verify/cli.mdx' diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/list-snapshots/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/list-snapshots/gui.mdx new file mode 100644 index 0000000000..967a725d33 --- /dev/null +++ b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/list-snapshots/gui.mdx @@ -0,0 +1,3 @@ +![Loaded snapshot card emphasized](/img/ui-secret-recovery-loaded-snapshot.png) + +Select **Secrets Recovery** from the navigation menu to view currently loaded snapshots. \ No newline at end of file diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/load-snapshot/gui/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/load-snapshot/gui/gui.mdx new file mode 100644 index 0000000000..99a55379c0 --- /dev/null +++ b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/load-snapshot/gui/gui.mdx @@ -0,0 +1,21 @@ +Snapshot load and unload operations are restricted to the root namespace. All other snapshot operations + can be performed in other namespaces. + +1. Open the Vault GUI and sign in to the root namespace. While you can perform +other snapshot operations from any namespace, you must perform load and + unload operations under the `root` namespace. + +1. Select **Secrets Recovery** from the left navigation menu. + +1. Select **Upload snapshot**. + +1. Select your upload method. To use an automated snapshot you must provide an + [automated snapshot config](/vault/api-docs/system/storage/raftautosnapshots#load-a-snapshot-from-an-automated-snapshot-configuration). + +1. Click **Load snapshot** to complete the upload. + +1. Monitor the upload until the status says "Ready" and the expiration date + populates. + ![Snapshot overview card with status and details link emphasized](/img/ui-secret-recovery-overview-details.png) + +1. Click "View details → to open the snapshot details view \ No newline at end of file diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/recover/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/recover/gui.mdx new file mode 100644 index 0000000000..b130f1f447 --- /dev/null +++ b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/recover/gui.mdx @@ -0,0 +1,8 @@ +![Snapshot read and recover form fields](/img/ui-secret-recovery-fields.png) + +Use the available selectors and input fields to find the secret you want to read or recover. Once +you selected, you can: + +- view the snapshot data as key/value pairs or as a JSON object +- recover to the original resource path +- recover the original resource to a new path \ No newline at end of file diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/verify/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/verify/gui.mdx new file mode 100644 index 0000000000..635979e354 --- /dev/null +++ b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/verify/gui.mdx @@ -0,0 +1,3 @@ +If the recovery operation succeeds, the GUI displays a success message with a +link to the recovered resource. +![Snapshot recovery operation](/img/ui-secret-recovery-recover-message.png) \ No newline at end of file diff --git a/content/vault/v1.21.x (rc)/img/ui-secret-recovery-fields.png b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-fields.png new file mode 100644 index 0000000000..a3f7b89ef4 Binary files /dev/null and b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-fields.png differ diff --git a/content/vault/v1.21.x (rc)/img/ui-secret-recovery-loaded-snapshot.png b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-loaded-snapshot.png new file mode 100644 index 0000000000..55c2d6ed30 Binary files /dev/null and b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-loaded-snapshot.png differ diff --git a/content/vault/v1.21.x (rc)/img/ui-secret-recovery-overview-details.png b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-overview-details.png new file mode 100644 index 0000000000..6622e07f84 Binary files /dev/null and b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-overview-details.png differ diff --git a/content/vault/v1.21.x (rc)/img/ui-secret-recovery-recover-message.png b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-recover-message.png new file mode 100644 index 0000000000..4be2e9c049 Binary files /dev/null and b/content/vault/v1.21.x (rc)/img/ui-secret-recovery-recover-message.png differ