Skip to content

Commit

Permalink
Add page on token managment (#164)
Browse files Browse the repository at this point in the history
Signed-off-by: Derek Nola <[email protected]>
  • Loading branch information
dereknola authored Feb 16, 2024
1 parent ba45986 commit 1a10a0d
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 0 deletions.
21 changes: 21 additions & 0 deletions docs/security/token.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: Token Management
---


## Server Token Rotation

:::info Version Gate
Available as of 2023-11 releases (v1.28.3+rke2r2, v1.27.7+rke2r2, v1.26.10+rke2r2, v1.25.15+rke2r2).
:::

The `rke2 token rotate` command allows you to rotate and replace the original token used for server bootstrap. After running the command on a single server, all servers and agents that used the original token should be restarted with the new token. The original token will be invalidated and cannot be used to join any new servers or agents to the cluster.

Flag | Description | Default
---- | ---- | ----
`--data-dir` value | Folder to hold state | /var/lib/rancher/rke2
`--kubeconfig` value | Kubeconfig for authentication to server | /etc/rancher/rke2/rke2.yaml
`--server` value | Server to connect to | "https://127.0.0.1:9345"
`--token` value | Existing token used to join a server or agent to a cluster | N/A
`--new-token` value | New token to replace the original token | If not specified, a random 16 character token will be generated

1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ module.exports = {
'security/selinux',
'security/secrets_encryption',
'security/certificates',
'security/token',
],
},
'architecture',
Expand Down

0 comments on commit 1a10a0d

Please sign in to comment.