-
Notifications
You must be signed in to change notification settings - Fork 4.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: backport to 1.15.x jwt auth bound audiences (#27471)
- Loading branch information
1 parent
888feb2
commit 3d5a5cc
Showing
2 changed files
with
33 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
31 changes: 31 additions & 0 deletions
31
website/content/partials/known-issues/1_15-jwt_auth_bound_audiences.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
### JWT auth login requires bound audiences on the role | ||
|
||
#### Affected versions | ||
|
||
- 1.15.9 | ||
- 1.15.10 | ||
- 1.16.3 | ||
- 1.16.4 | ||
|
||
#### Issue | ||
A behavior change was made in the jwt auth plugin to address CVE-2024-5798. | ||
Since the behavior change was a breaking change, we reverted the change in | ||
the versions after 1.15.10 and 1.16.4. However, the behavior change will go | ||
into effect in 1.17. | ||
|
||
The new behavior requires that the `bound_audiences` parameter of "jwt" roles | ||
**must** match at least one of the JWT's associated `aud` claims. The `aud` | ||
claim can be a single string or a list of strings as per | ||
[RFC 7519 Section 4.1.3](https://datatracker.ietf.org/doc/html/rfc7519#section-4.1.3). | ||
|
||
Users may not be able to log into Vault if the JWT role is configured | ||
incorrectly. For additional details, refer to the | ||
[JWT auth method (API)](/vault/api-docs/auth/jwt) documentation. | ||
|
||
See this [issue](https://github.com/hashicorp/vault/issues/27343) for more details. | ||
|
||
#### Workaround | ||
|
||
Configure the `bound_audiences` parameter of "jwt" roles to match at least one | ||
of the JWT's associated `aud` claims. This configuratoin will be required for | ||
1.17 and later. |