https://github.com/google/conscrypt

Conscrypt is a Java Security Provider that implements parts of the Java Cryptography Extension and Java Secure Socket Extension.
https://github.com/google/conscrypt

Last synced: 10 days ago
JSON representation

Conscrypt is a Java Security Provider that implements parts of the Java Cryptography Extension and Java Secure Socket Extension.

• Host: GitHub
• URL: https://github.com/google/conscrypt
• Owner: google
• License: apache-2.0
• Created: 2016-12-12T17:24:18.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-23T16:34:26.000Z (16 days ago)
• Last Synced: 2024-10-23T23:08:58.599Z (16 days ago)
• Language: Java
• Homepage:
• Size: 24.1 MB
• Stars: 1,282
• Watchers: 65
• Forks: 275
• Open Issues: 151
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-java-security - Conscrypt - Java Security Provider that implements parts of the Java Cryptography Extension and Java Secure Socket Extension. (Cryptography)

README

        
Conscrypt - A Java Security Provider

========================================

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](CAPABILITIES.md) for detailed information on what is provided.

The core SSL engine has borrowed liberally from the [Netty](http://netty.io/) project and their

work on [netty-tcnative](http://netty.io/wiki/forked-tomcat-native.html), giving `Conscrypt`

similar performance.

  

    Homepage:

    

      conscrypt.org

    

  

  

    Mailing List:

    

      [email protected]

    

  

Download

-------------

Conscrypt supports **Java 8** or later on OpenJDK and **KitKat (API Level

19)** or later on Android.  The build artifacts are available on Maven Central.

### Download JARs

You can download

[the JARs](http://search.maven.org/#search%7Cga%7C1%7Cg:%22org.conscrypt%22)

directly from the Maven repositories.

### OpenJDK (i.e. non-Android)

#### Native Classifiers

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)

#### Maven

Use the [os-maven-plugin](https://github.com/trustin/os-maven-plugin) to add the dependency:

```xml

  

    

      kr.motd.maven

      os-maven-plugin

      1.4.1.Final

    

  

  org.conscrypt

  conscrypt-openjdk

  2.5.2

  ${os.detected.classifier}

```

#### Gradle

Use the [osdetector-gradle-plugin](https://github.com/google/osdetector-gradle-plugin)

(which is a wrapper around the os-maven-plugin) to add the dependency:

```gradle

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

}

```

#### Uber JAR

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.

##### Maven

```xml

  org.conscrypt

  conscrypt-openjdk-uber

  2.5.2

```

##### Gradle

```gradle

dependencies {

  compile 'org.conscrypt:conscrypt-openjdk-uber:2.5.2'

}

```

### Android

The Android AAR file contains native libraries for x86, x86_64, armeabi-v7a, and

arm64-v8a.

#### Gradle

```gradle

dependencies {

  implementation 'org.conscrypt:conscrypt-android:2.5.2'

}

```

How to Build

------------

If you are making changes to Conscrypt, see the [building

instructions](BUILDING.md).