From eca4c5a9cbd036f5d3ba242a87a328b74dd0bb0a Mon Sep 17 00:00:00 2001 From: Harrison Sherwin - Akeyless Date: Fri, 15 May 2026 08:50:42 -0600 Subject: [PATCH 1/2] docs(uid): add uid-auto-rotate guidance to UID page --- .../auth-with-universal-identity/index.md | 23 ++++++++++++------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md b/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md index b03ddcb90..2e9119478 100644 --- a/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md +++ b/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md @@ -87,17 +87,24 @@ curl https://:8080 -d "cmd=uid-rotate-token&&uid-token=u-XXXXX" #### Rotation Flow -Frequent key rotation is a best practice. You may create an automated script that will rotate your token in pre-scheduled intervals. +Frequent key rotation is a best practice. To automate UID token rotation, use the built-in `uid-auto-rotate` command set. -While you can write your own script, we have a compatible one-minute interval token rotation script in the [Akeyless Downloads](https://download.akeyless.io/Akeyless_Artifacts/Linux/Universal_Identity/) folder. -This script is Linux/macOS compatible, and has the following flow: +The command set includes: -1. Write the token to a path. -2. Take the token from the path to perform commands. -3. Rotate the token. -4. Replace the token in the path. +* `init`: Installs and initializes automatic rotation. +* `rotate`: Runs a manual rotation immediately. +* `status`: Shows the current auto-rotation status. +* `uninstall`: Removes the auto-rotation setup. -After downloading the `.sh` file, execute it, select `init`, and insert the token you generated to start the process. From this point on, the script can run automatically to rotate the token. +Example: + +```shell +akeyless uid-auto-rotate init --uid-token u-XXXXXXXX +``` + +For command details and available flags, see [CLI Reference - Universal Identity: uid-auto-rotate](https://docs.akeyless.io/docs/cli-reference-universal-identity#uid-auto-rotate). + +If custom automation is required, use `uid-rotate-token` in your own script. If you wish to write your own script, here are some useful parts you might want to include: From 944390920305181dd412d7e15af11eb1249b3fe4 Mon Sep 17 00:00:00 2001 From: Harrison Sherwin - Akeyless Date: Fri, 15 May 2026 08:55:37 -0600 Subject: [PATCH 2/2] docs(uid): use token rotation wording in UID section --- .../auth-with-universal-identity/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md b/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md index 2e9119478..25a754e07 100644 --- a/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md +++ b/docs/Accessing Akeyless/access-and-authentication-methods/auth-with-universal-identity/index.md @@ -87,7 +87,7 @@ curl https://:8080 -d "cmd=uid-rotate-token&&uid-token=u-XXXXX" #### Rotation Flow -Frequent key rotation is a best practice. To automate UID token rotation, use the built-in `uid-auto-rotate` command set. +Frequent token rotation is a best practice. To automate UID token rotation, use the built-in `uid-auto-rotate` command set. The command set includes: