Maven Central publication is pending. Version 1.4.1 is available as signed artifacts from the GitHub security release.
Only the latest 1.x release receives security fixes. Fixes ship in a new release; older release lines are not patched.
| Maven coordinate | Supported | Not supported |
|---|---|---|
org.owasp.encoder:encoder |
1.4.1 | < 1.4.1 |
org.owasp.encoder:encoder-jsp |
1.4.1 | < 1.4.1 |
org.owasp.encoder:encoder-jakarta-jsp |
1.4.1 | < 1.4.1 |
org.owasp.encoder:encoder-esapi |
1.4.1 | < 1.4.1 |
Upgrading the core encoder artifact to the latest 1.x release needs no code changes:
no public API was removed between 1.2.3 and 1.4.1. It does need Java 8 or later;
1.2.3 and earlier also ran on Java 5 through 7.
Please report suspected vulnerabilities privately, not in public issues or pull requests.
Use the Report a vulnerability button on the repository's Security Advisories page. The form requires a GitHub account. If you cannot use it, email the project leaders at jeremy.long@owasp.org and jim.manico@owasp.org.
A useful report includes:
- the affected artifact and version
- the
Encodemethod, tag, or EL function involved - the input, the encoded output, and the output you expected
- where the output was used (for example, an HTML attribute or a JavaScript string) and the browser or parser that interpreted it
- a minimal reproduction, if you have one
In scope:
- input that passes through a documented
Encode.forXxxmethod (or the matching tag or EL function), is used in the context that method documents, and is then interpreted as code or markup by a current mainstream parser for that context - a crash, or unbounded CPU or memory use, on any input
- output that contradicts the encoder's documented contract
Out of scope:
- using an encoder in a context it does not document (for example,
forHtmloutput placed in a JavaScript string) - canonicalization, decoding, or input validation, which this library does not perform
- vulnerabilities in ESAPI, Spring, or servlet containers; report ESAPI issues through the ESAPI security policy
- the unpublished
jakarta-testapplication
These are goals for a volunteer-run project, not guarantees:
- acknowledge a report within about a week
- coordinate disclosure with the reporter, publishing a fix and advisory within 90 days where possible
Version 1.4.1 introduces a dedicated OWASP Java Encoder Release signing key:
1C5F632B86809F2F5DB25092BEA0075F94074A9B
Obtain KEYS, the artifact, its .asc signature, and checksum files from the
same release. Compare the fingerprint with this policy at the corresponding
release tag, then verify:
gpg --import KEYS
gpg --verify encoder-1.4.1.jar.asc encoder-1.4.1.jar
shasum -a 256 -c SHA256SUMS
shasum -a 512 -c SHA512SUMSThe SHA256SUMS and SHA512SUMS manifests are included with the GitHub release
assets. Maven Central provides individual checksum files alongside each artifact.
A new project key and its fingerprint must be added to KEYS before a release
uses it. Previously published artifacts retain their original signatures.