Conscrypt is a Java Security Provider that implements parts of the Java Cryptography Extension and Java Secure Socket Extension.
Java C++ Other
Latest commit 56a0c0d Jan 20, 2017 @kruton kruton committed with kruton Revert "Do not try to loadLibrary for GmsCore (#53)"
This reverts commit c41349b.
Permalink
Failed to load latest commit information.
android-stub Restructuring conscrypt into submodules Nov 29, 2016
android Revert "Do not try to loadLibrary for GmsCore (#53)" Jan 24, 2017
common/src Fix buffer underflow bug (#58) Jan 23, 2017
constants Use task model to run generator executable Jan 17, 2017
gradle/wrapper Update gradle to 3.3-rc-1 (#15) Dec 22, 2016
licenses Fix git issue on windows/osx Jan 6, 2017
openjdk Adding support for Java 8 static linking. (#50) Jan 23, 2017
platform/src Fix serialized session reading (#54) Jan 18, 2017
.clang-format Restructuring conscrypt into submodules Nov 29, 2016
.gitignore Restructuring conscrypt into submodules Nov 29, 2016
.travis.yml Adding support for Java 8 static linking. (#50) Jan 23, 2017
Android.bp Fix Android build files (#39) Jan 12, 2017
Android.mk Fix Android build files (#39) Jan 12, 2017
BUILDING.md Allow building both 32-bit and 64-bit JNI libraries (#36) Jan 12, 2017
CONTRIBUTING.md Updating markdown docs. Dec 14, 2016
LICENSE Preparing for move to github. Dec 12, 2016
MODULE_LICENSE_APACHE2 Add NOTICE and MODULE_LICENSE files Mar 12, 2015
NOTICE Fix git issue on windows/osx Jan 6, 2017
PREUPLOAD.cfg PREUPLOAD: Remove clang_format options Oct 26, 2016
README.md Merge pull request #3 from nmittler/readme_fix Dec 20, 2016
appveyor.yml Adding support for Java 8 static linking. (#50) Jan 23, 2017
build.gradle Adding support for Java 8 static linking. (#50) Jan 23, 2017
gradlew Update gradle to 3.3-rc-1 (#15) Dec 22, 2016
gradlew.bat Preparing for move to github. Dec 12, 2016
jarjar-rules.txt Move JSSE to new package Apr 29, 2013
settings.gradle Add constants module and remove common Dec 20, 2016

README.md

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 cryptograhpic primitives and Transport Layer Security (TLS) for Java applications on Android and OpenJDK.

The core SSL engine has borrowed liberally from the Netty project and their work on netty-tcnative, giving Conscrypt similar performance.

Homepage: conscrypt.org
Mailing List: conscrypt@googlegroups.com

Download

NOTE: This section is under construction! Artifacts have not yet been published to the public Maven repositories.

Download JARs

You can download the JARs directly from the Maven repositories.

OpenJDK (i.e. non-Android)

Maven

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>0.0.1-SNAPSHOT</version>
  <classifier>${os.detected.classifier}</classifier>
</dependency>
Gradle

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-jdk:0.0.1-SNAPSHOT:' + osdetector.classifier
}

Artifacts are available for the following platforms:

Classifier Description
windows-x86_64 Windows distribution
osx-x86_64 Mac distribution
linux-x86_64 Used for Linux

How to Build

If you are making changes to Conscrypt, see the building instructions.

Source Overview

Here's a quick readers' guide to the code to help folks get started. The high-level modules are Common, Android, OpenJDK, and Platform.

Common

This contains the bulk of the code for both Java and C. This isn't an actual module and builds no artifacts. Rather, the other modules just point to this directory as source.

Android

This module provides the Platform class for Android and also adds compatibility classes for supporting various versions of Android. This generates an aar library artifact.

OpenJDK

This modules provides the Platform class for non-Android (OpenJDK-based) systems. It also provides a native library loader supports bundling the shared library with the JAR.

Platform

This is not an actual module and is not part of the default build. This is used for building Conscrypt as an embedded component of the Android platform.