Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Documentation, JWT Builder Workload Identity and JWK Rotation

Open
  • Is something wrong?
#8,529 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Active
Domain
authentication, documentation, security

Research direction

Start by reading development epic 35645 and the linked jwt-1.0, JSON Web Token, and IBM WebSphere Liberty documentation topics to understand the feature and existing coverage. Done means updating the affected topics with the workload identity and JWK rotation configuration and behavior, and defining any required new topic and navigation placement.

Written by the indexing model from the issue text.

Description

26.0.0.12
Feature epic details
Operating systems

Does the documentation apply to all operating systems?

  • Yes
  • No; specify operating systems: ______

** details below are a work in progress **

Summary

Provide a concise summary of your feature. What is the update, why does it matter, and to whom? What do 80% of target users need to know to be most easily productive using your runtime update?

Enhance the JWT Builder to be able to set a workload identity claim, generated by the server, in the JWTs that it issues. This claim cannot be modified via the JwtBuilder API to provide attestation.

Also, add the ability to define the rotation interval of the JWKs used for signing and verifying the JWTs issued by the JWT Builder as well as define the maximum number of JWKs retained by the JWK endpoint for verifying JWTs.

Configuration

List any new or changed properties, parameters, elements, attributes, etc. Include default values and configuration examples where relevant:

Example configuration:

<jwtBuilder
    workloadIdentityClaim="workload-identity"
    jwkRotationTime="60m"
    jwkMaxKeys="3"
/>
Updates to existing topics

To update existing topics, specify a link to the topics that are affected. Include a copy of the current text and the exact text to which it will change. For example: Change ABC to XYZ

Create a new topic

To create a topic, specify a first draft of the topic that you want added and the section in the navigation where the topic should go.

Dominant language
No language data
Stars
14
Forks
58
Avg merge
1h 4m
Merged PRs (30d)
21

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from OpenLiberty/docs

All issues in OpenLiberty/docs

Similar issues

More Security issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.