Skip to content

KAFKA-18608: Add documentation for OAuth client assertion authentication (KIP-1258)#21859

Open
prabhashkr wants to merge 1 commit intoapache:trunkfrom
prabhashkr:KIP-1258-docs
Open

KAFKA-18608: Add documentation for OAuth client assertion authentication (KIP-1258)#21859
prabhashkr wants to merge 1 commit intoapache:trunkfrom
prabhashkr:KIP-1258-docs

Conversation

@prabhashkr
Copy link
Contributor

  • Add documentation for client assertion authentication support in the client_credentials grant type, introduced in https://cwiki.apache.org/confluence/display/KAFKA/KIP-1258 / PR KAFKA-18608: Add Support for OAuth Client Assertion to client_credentials Grant Type #21483
  • Document the three-tier fallback mechanism (file-based assertion > locally-generated assertion > client secret)
  • Add configuration examples for dynamically-generated assertions, pre-generated assertion files, and assertion template files
  • Clarify that DefaultJwtRetriever auto-delegates to ClientCredentialsJwtRetriever for HTTP/HTTPS endpoints, so sasl.oauthbearer.jwt.retriever.class does not need to be set explicitly in most cases
  • Update "Secure/Production Use" section to reference built-in JWT retriever implementations
  • Add security considerations for client assertion (replay protection via JTI, short-lived assertions)

@github-actions github-actions bot added docs small Small PRs triage PRs from the community labels Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs small Small PRs triage PRs from the community

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant