Add v3 API token deprecation notice (#2250)

* Add v3 API token deprecation warning shared file / Add warning to applicable pages

* Update Deprecation of v3 API tokens warning

* Update shared-files/_v3-api-tokens-deprecation-warning.md

Co-authored-by: Billy Tat <btat@suse.com>

* Update src/theme/MDXComponents.js

Co-authored-by: Billy Tat <btat@suse.com>

* Fix/update typo in shared file name (v3APITokensDeprecationWarning)

* Fix wording in Deprecation of v3 API tokens warning

---------

Co-authored-by: Billy Tat <btat@suse.com>
This commit is contained in:
Lucas Saintarbor
2026-03-24 08:34:56 -07:00
committed by GitHub
co-authored by Billy Tat
parent 2f4b822cb3
commit 85a32cd276
12 changed files with 30 additions and 0 deletions
+2
View File
@@ -6,6 +6,8 @@ title: Using API Tokens
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/api/api-tokens"/>
</head>
<v3APITokensDeprecationWarning />
Rancher v2.8.0 introduced the [Rancher Kubernetes API](./api-reference.mdx) which can be used to manage Rancher resources through `kubectl`. This page covers information on API tokens used with the [Rancher CLI](../reference-guides/cli-with-rancher/cli-with-rancher.md), [kubeconfig files](../how-to-guides/new-user-guides/manage-clusters/access-clusters/authorized-cluster-endpoint.md#about-the-kubeconfig-file), Terraform and the [v3 API browser](./v3-rancher-api-guide.md#enable-view-in-api).
By default, some cluster-level API tokens are generated with infinite time-to-live (`ttl=0`). In other words, API tokens with `ttl=0` never expire unless you invalidate them. Tokens are not invalidated by changing a password.
+2
View File
@@ -6,6 +6,8 @@ title: Tokens
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/api/workflows/tokens"/>
</head>
<v3APITokensDeprecationWarning />
## Token Resource
Rancher has an imperative API resource `tokens.ext.cattle.io` that allows you to generate tokens for authenticating with Rancher.
@@ -6,6 +6,8 @@ title: API Keys
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/reference-guides/user-settings/api-keys"/>
</head>
<v3APITokensDeprecationWarning />
## API Keys and User Authentication
If you want to access your Rancher clusters, projects, or other objects using external applications, you can do so using the Rancher API. However, before your application can access the API, you must provide the app with a key used to authenticate with Rancher. You can obtain a key using the Rancher UI.