commit | 95333de0f73d86f4be1586f97ea132c90a5c4021 | [log] [tgz] |
---|---|---|
author | Pete Bentley <44170157+prbprbprb@users.noreply.github.com> | Fri Jan 27 18:32:31 2023 +0000 |
committer | GitHub <noreply@github.com> | Fri Jan 27 18:32:31 2023 +0000 |
tree | 752ac99d9e31c72007ec26fae0cbc89e2ed798c1 | |
parent | a56ab5c684e88341e30122a0e6012d7142d10f62 [diff] |
Rework Ssl*Stream creation. (#1109) * Rework Ssl*Stream creation. PR #1106 introduced a subtle bug by changing Ssl*Stream creation to use the public get*Stream() methods. The contract for those methods is to throw if the socket has been closed, which mean two threads could race such that startHandshake() called getInputStream() after the socket has been closed by another (e.g. timeout) thread. The upshot was that getInputStream() would throw, causing close() to be called before an output stream is created, causing an NPE when trying to send a TLS close message. This change moves the actual creation into a method which doesn't chack the socket state and so is suitable for calling from startHandshake(). Also added some additional tests around shutdownInput() and shutdownOutput() as it became apparent these were missing.
Conscrypt is a Java Security Provider (JSP) that implements parts of the Java Cryptography Extension (JCE) and Java Secure Socket Extension (JSSE). It uses BoringSSL to provide cryptographic primitives and Transport Layer Security (TLS) for Java applications on Android and OpenJDK. See the capabilities documentation for detailed information on what is provided.
The core SSL engine has borrowed liberally from the Netty project and their work on netty-tcnative, giving Conscrypt
similar performance.
Conscrypt supports Java 7 or later on OpenJDK and Gingerbread (API Level 9) or later on Android. The build artifacts are available on Maven Central.
You can download the JARs directly from the Maven repositories.
The OpenJDK artifacts are platform-dependent since each embeds a native library for a particular platform. We publish artifacts to Maven Central for the following platforms:
Classifier | OS | Architecture |
---|---|---|
linux-x86_64 | Linux | x86_64 (64-bit) |
osx-x86_64 | Mac | x86_64 (64-bit) |
windows-x86 | Windows | x86 (32-bit) |
windows-x86_64 | Windows | x86_64 (64-bit) |
Use the os-maven-plugin to add the dependency:
<build> <extensions> <extension> <groupId>kr.motd.maven</groupId> <artifactId>os-maven-plugin</artifactId> <version>1.4.1.Final</version> </extension> </extensions> </build> <dependency> <groupId>org.conscrypt</groupId> <artifactId>conscrypt-openjdk</artifactId> <version>2.5.2</version> <classifier>${os.detected.classifier}</classifier> </dependency>
Use the osdetector-gradle-plugin (which is a wrapper around the os-maven-plugin) to add the dependency:
buildscript { repositories { mavenCentral() } dependencies { classpath 'com.google.gradle:osdetector-gradle-plugin:1.4.0' } } // Use the osdetector-gradle-plugin apply plugin: "com.google.osdetector" dependencies { compile 'org.conscrypt:conscrypt-openjdk:2.5.2:' + osdetector.classifier }
For convenience, we also publish an Uber JAR to Maven Central that contains the shared libraries for all of the published platforms. While the overall size of the JAR is larger than depending on a platform-specific artifact, it greatly simplifies the task of dependency management for most platforms.
To depend on the uber jar, simply use the conscrypt-openjdk-uber
artifacts.
<dependency> <groupId>org.conscrypt</groupId> <artifactId>conscrypt-openjdk-uber</artifactId> <version>2.5.2</version> </dependency>
dependencies { compile 'org.conscrypt:conscrypt-openjdk-uber:2.5.2' }
The Android AAR file contains native libraries for x86, x86_64, armeabi-v7a, and arm64-v8a.
dependencies { implementation 'org.conscrypt:conscrypt-android:2.5.2' }
If you are making changes to Conscrypt, see the building instructions.