Skip to content

docs: improve Javadocs for OIDC login and JWT bearer authentication#23742

Merged
netroms merged 1 commit into
masterfrom
docs/javadocs-oidc-login-jwt
Apr 29, 2026
Merged

docs: improve Javadocs for OIDC login and JWT bearer authentication#23742
netroms merged 1 commit into
masterfrom
docs/javadocs-oidc-login-jwt

Conversation

@netroms

@netroms netroms commented Apr 24, 2026

Copy link
Copy Markdown
Contributor

Summary

Part 3 of 3 splitting #23734 into smaller PRs per reviewer request. This PR covers the existing OIDC Relying Party (external IdP login) code and the JWT bearer resource-server code. Both have been in DHIS2 since 2.41 and are the largest pre-existing block in the auth stack.

19 classes, Javadoc only, aligned with the user-facing OAuth2 / OIDC / JWT reference in dhis2-docs#1739.

  • OIDC RP core (10): `DhisOidcClientRegistration`, `DhisOidcProviderRepository`, `DhisOidcUserService`, `DhisOidcUser`, `DhisOidcLogoutSuccessHandler`, `DhisAuthorizationCodeTokenResponseClient`, `DhisCustomAuthorizationRequestResolver`, `GenericOidcProviderConfigParser`, `KeyStoreUtil`, `OidcLoginEnabledCondition`.
  • OIDC provider builders (6): `AbstractOidcProvider`, `GenericOidcProviderBuilder`, `GoogleProvider`, `AzureAdProvider` (Microsoft Entra ID), `Wso2Provider`, `Dhis2InternalOidcProvider`.
  • JWT bearer (3): `Dhis2JwtAuthenticationManagerResolver`, `DhisBearerJwtTokenAuthenticationEntryPoint`, `DhisJwtAuthenticationToken`.

Companion PRs:

  • SAS core: docs/javadocs-sas
  • DCR: docs/javadocs-android-dcr

AI Assisted

Align Javadocs on the OIDC Relying Party code (login with Google,
Microsoft Entra ID / Azure AD, WSO2, generic providers, the internal
DHIS2 OIDC provider, and linked accounts) and the JWT bearer
resource-server code with the user-facing OAuth2 / OIDC / JWT reference
in the DHIS2 docs. Covers provider builders, the authorization-request
resolver, the token-response client, the logout success handler, and
the resource-server JWT manager/resolver stack.

No behavior, signatures, imports, or annotations were changed.

AI Assisted
@sonarqubecloud

Copy link
Copy Markdown

@netroms netroms merged commit 5766c02 into master Apr 29, 2026
16 checks passed
@netroms netroms deleted the docs/javadocs-oidc-login-jwt branch April 29, 2026 09:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants