Skip to content

Root-Rotation: Documentation update#1916

Open
nayak-prajna wants to merge 4 commits intomainfrom
42257_root_rotation_doc
Open

Root-Rotation: Documentation update#1916
nayak-prajna wants to merge 4 commits intomainfrom
42257_root_rotation_doc

Conversation

@nayak-prajna
Copy link
Collaborator

@nayak-prajna nayak-prajna commented Feb 27, 2026

This document is updated as part of the main Ticket:
https://hashicorp.atlassian.net/browse/VAULT-42182

Description:
Added new section at api-docs/auth/ldap.mdx for root rotation.

Changes:
Document before update:
image

Document after update (Root Rotation section is added before the List LDAP Group):
image

@nayak-prajna nayak-prajna requested a review from a team as a code owner February 27, 2026 17:32
@github-actions github-actions bot added the Vault Content update for Vault product docs label Feb 27, 2026
@hashicorp-cla-app
Copy link

hashicorp-cla-app bot commented Feb 27, 2026

CLA assistant check
All committers have signed the CLA.

@hashicorp-cla-app
Copy link

CLA assistant check

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes

Have you signed the CLA already but the status is still pending? Recheck it.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 27, 2026

Vercel Previews Deployed

Name Status Preview Updated (UTC)
Dev Portal ✅ Ready (Inspect) Visit Preview Tue Mar 3 06:13:14 UTC 2026
Unified Docs API ✅ Ready (Inspect) Visit Preview Tue Mar 3 06:09:05 UTC 2026

@github-actions
Copy link
Contributor

github-actions bot commented Feb 27, 2026

Broken Link Checker

No broken links found! 🎉

@stuti-sr
Copy link

stuti-sr commented Mar 2, 2026

Links provided in PR description doesn't work.
enable CLA.
Can you share test screen shot here post changes?

Copy link
Contributor

@schavis schavis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minimal changes for style corrections. Let me know when you're ready for another look.

## Rotate root password

The `rotate-root` endpoint offers password rotation for the `binddn` entry used to manage LDAP.
This generated password will only be known to Vault and will not be retrievable once rotated.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This generated password will only be known to Vault and will not be retrievable once rotated.
The root password becomes irretrievable and only known to Vault once you rotate it.

Style correction: write in active voice, avoid "this" as a pronoun

Comment on lines +217 to +220
$ curl \
--header "X-Vault-Token: ..." \
--request POST \
http://127.0.0.1:8200/v1/auth/ldap/rotate-root
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
$ curl \
--header "X-Vault-Token: ..." \
--request POST \
http://127.0.0.1:8200/v1/auth/ldap/rotate-root
$ curl \
--request POST \
--header "X-Vault-Token: ${VAULT_TOKEN}" \
${VAULT_ADDR}/v1/auth/ldap/rotate-root

We're slowly moving example code over to using standard env variables to reduce how much folks need to edit the example before running it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Vault Content update for Vault product docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants