Skip to content

Remove the openapi-war-overlay module#296

Merged
vharseko merged 1 commit into
OpenIdentityPlatform:masterfrom
vharseko:chore/remove-openapi-war-overlay
Jul 23, 2026
Merged

Remove the openapi-war-overlay module#296
vharseko merged 1 commit into
OpenIdentityPlatform:masterfrom
vharseko:chore/remove-openapi-war-overlay

Conversation

@vharseko

Copy link
Copy Markdown
Member

Summary

Removes the openapi-war-overlay module — a vendored copy of Swagger UI 2.1.4 (2016) checked directly into the tree. Its bundled third-party JS (handlebars-4.7.6.js, marked.js, swagger-oauth.js, swagger-ui.js, …) was the source of most open CodeQL code-scanning alerts, including the sole error-level one (js/invalid-prototype-value).

The module's only consumer inside the repo was json-resource-examples; no other module or ecosystem repo depends on it.

Changes

  • Delete the whole commons/rest/openapi-war-overlay/ module (49 files).
  • commons/rest/pom.xml — drop the module from the reactor.
  • json-resource-examples/pom.xml — remove the openapi-war-overlay dependency and the maven-war-plugin <overlay>.
  • json-resource-examples/web.xml — remove the /openapi/* DefaultServlet mapping.
  • CrestHttpApplication.java — remove the /docs/api → Swagger UI redirect route, the "API explorer" landing link, and the now-unused SWAGGER_JSON_ROUTE constant / Uris import. OpenAPI JSON (?_api), CREST descriptor (?_crestapi) and HTML docs remain.
  • .github/workflows/codeql.yml — remove the now-dead openapi-war-overlay/**/swagger-ui.js ignore entry.

Verification

mvn -o -pl commons/rest/json-resource-examples -am clean package succeeds. The resulting servlet WAR contains 0 openapi/ entries and 0 openapi-war-overlay references — Swagger UI is no longer bundled and the example builds with no dangling links.

Note

openapi-war-overlay is published as org.openidentityplatform.commons:openapi-war-overlay. No local ecosystem repo consumes it, but any external downstream depending on the published WAR would need to vendor Swagger UI itself after this removal.

@vharseko
vharseko requested a review from maximthomas July 22, 2026 13:53
@vharseko vharseko added codeql CodeQL static-analysis findings dependencies Pull requests that update a dependency file ci Build, CI/CD, JDK matrix and workflow changes labels Jul 22, 2026
Drop the vendored Swagger UI 2.1.4 WAR overlay and its only consumer
wiring in json-resource-examples. The stale third-party JS in the
overlay was the source of most open CodeQL code-scanning alerts,
including the sole error-level one (js/invalid-prototype-value).
@vharseko
vharseko force-pushed the chore/remove-openapi-war-overlay branch from 39a9fcb to 72bad77 Compare July 22, 2026 13:56
@vharseko
vharseko merged commit 817f5ed into OpenIdentityPlatform:master Jul 23, 2026
13 of 14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci Build, CI/CD, JDK matrix and workflow changes codeql CodeQL static-analysis findings dependencies Pull requests that update a dependency file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants