Skip to content

Commit

Permalink
Add warning about JDK-8278449.
Browse files Browse the repository at this point in the history
  • Loading branch information
charleskorn committed Apr 20, 2022
1 parent f3dd84c commit 6c5e495
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,21 @@ dependencies {
Check the [releases page](https://github.com/charleskorn/okhttp-system-keystore/releases) for the latest release information, and the
[Maven Central page](https://search.maven.org/artifact/com.charleskorn.okhttp.systemkeystore/okhttp-system-keystore) for examples of how to reference the library in other build systems.

### macOS security note

:warning: On macOS, it's highly recommended that this library only be used with versions of the JDK that contain a fix for JDK-8278449
("Only Expose Certificates With Proper Trust Settings as Trusted Certificate Entries in macOS KeychainStore").

Without this fix, certificates marked as 'never trust' in your certificate trust settings will be treated as trusted by Java.

The following versions of the JDK contain a fix for this issue:

* JDK 8: 8u332 or later
* JDK 11: 11.0.15 or later
* JDK 17: 17.0.3 or later
* JDK 18: 18.0.1 or later
* All versions of JDK 19 or later

## Usage

Call `useOperatingSystemCertificateTrustStore()` when building your OkHttp client:
Expand Down

0 comments on commit 6c5e495

Please sign in to comment.