Skip to content

Commit 9c656ca

Browse files
authored
[Vault] Clarify that 1.21 did not make audience required (#1221)
* Calrify that 1.21 did not make audience required * tweak sentence
1 parent d95df26 commit 9c656ca

File tree

2 files changed

+13
-1
lines changed

2 files changed

+13
-1
lines changed

content/vault/v1.20.x/content/api-docs/auth/kubernetes.mdx

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,12 @@ entities attempting to login.
146146
[LabelSelector](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#labelselector-v1-meta). Currently, label selectors with `matchExpressions` are not supported.
147147
To use label selectors, **Vault must have permission to read namespaces** on the Kubernetes
148148
cluster. If set with `bound_service_account_namespaces`, the conditions are `OR`ed.
149-
- `audience` `(string: "")` - Audience claim to verify in the JWT.
149+
- `audience` `(string: "")` - Audience claim to verify in the JWT. If you leave
150+
`audience` unset, Vault logs a warning about setting an explicit audience
151+
configuration to encourage better security practices. Note: the log entry for
152+
early versions of Vault 1.20.x falsely indicates that `audience` becomes a
153+
required field in Vault 1.21.x. You can safely ignore that portion of the
154+
warning.
150155
- `alias_name_source` `(string: "serviceaccount_uid")` - Configures how identity aliases are generated.
151156
Valid choices are: `serviceaccount_uid` and `serviceaccount_name`.
152157

content/vault/v1.20.x/content/docs/updates/important-changes.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -204,6 +204,13 @@ to the official [Snowflake documentation](https://docs.snowflake.com/en/user-gui
204204
Vault logs a warning when you create or update a Kubernetes auth role without an
205205
audience.
206206

207+
<Note title="Note about warning text">
208+
We have no plans to require audience definition in future Vault versions.
209+
Log messages in earlier versions of 1.20.x incorrectly mention that Vault
210+
1.21.x requires audience configuration. You can safely ignore that portion of
211+
the log message.
212+
</Note>
213+
207214
#### Recommendation
208215

209216
There are cases where configuring audience details can interfere with your

0 commit comments

Comments
 (0)