Skip to content

Commit a3660a0

Browse files
feat: documenting serviceAccountToken volume type (#31329)
* feat: documenting serviceAccountToken volume type * serviceAccountToken: correct few terms * Update volumes.md * Migrate to projected-volumes * Update projected-volumes.md * Remove serviceAccountToken from volume type * Update projected-volumes.md * Change heading's fragment identifier
1 parent 388a12a commit a3660a0

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

content/en/docs/concepts/storage/projected-volumes.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Currently, the following types of volume sources can be projected:
2323
* [`secret`](/docs/concepts/storage/volumes/#secret)
2424
* [`downwardAPI`](/docs/concepts/storage/volumes/#downwardapi)
2525
* [`configMap`](/docs/concepts/storage/volumes/#configmap)
26-
* `serviceAccountToken`
26+
* [`serviceAccountToken`](#serviceaccounttoken)
2727

2828
All sources are required to be in the same namespace as the Pod. For more details,
2929
see the [all-in-one volume](https://github.com/kubernetes/design-proposals-archive/blob/main/node/all-in-one-volume.md) design document.
@@ -45,15 +45,18 @@ parameters are nearly the same with two exceptions:
4545
volume source. However, as illustrated above, you can explicitly set the `mode`
4646
for each individual projection.
4747

48+
## serviceAccountToken projected volumes {#serviceaccounttoken}
4849
When the `TokenRequestProjection` feature is enabled, you can inject the token
4950
for the current [service account](/docs/reference/access-authn-authz/authentication/#service-account-tokens)
5051
into a Pod at a specified path. For example:
5152

5253
{{< codenew file="pods/storage/projected-service-account-token.yaml" >}}
5354

5455
The example Pod has a projected volume containing the injected service account
55-
token. This token can be used by a Pod's containers to access the Kubernetes API
56-
server. The `audience` field contains the intended audience of the
56+
token. Containers in this Pod can use that token to access the Kubernetes API
57+
server, authenticating with the identity of [the pod's ServiceAccount]
58+
(/docs/tasks/configure-pod-container/configure-service-account/).
59+
The `audience` field contains the intended audience of the
5760
token. A recipient of the token must identify itself with an identifier specified
5861
in the audience of the token, and otherwise should reject the token. This field
5962
is optional and it defaults to the identifier of the API server.

0 commit comments

Comments
 (0)