Menu
AWS Encryption SDK
Developer Guide

AWS Encryption SDK for Java

This topic explains how to install and use the AWS Encryption SDK for Java. For details about programing with the SDK, see the aws-encryption-sdk-java repository on GitHub the Javadoc for the AWS Encryption SDK.

Prerequisites

Before you install the AWS Encryption SDK for Java, be sure you have the following prerequisites.

A Java 8 development environment

If you don't have one, go to Java SE Downloads on the Oracle website, then download and install the Java SE Development Kit (JDK). We recommend Java 8.

If you use the Oracle JDK, you must also download and install the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files.

Bouncy Castle

Bouncy Castle provides a cryptography API for Java. If you don't have Bouncy Castle, go to Bouncy Castle latest releases to download the provider file that corresponds to your JDK.

If you use Apache Maven, Bouncy Castle is available with the following dependency definition.

Copy
<dependency> <groupId>org.bouncycastle</groupId> <artifactId>bcprov-ext-jdk15on</artifactId> <version>1.56</version> </dependency>
AWS SDK for Java (Optional)

Although you don't need the AWS SDK for Java to use the AWS Encryption SDK for Java, you do need it to use AWS Key Management Service (AWS KMS) as a master key provider, and to use some of the example Java code in this guide. For more information about installing and configuring the AWS SDK for Java, see AWS SDK for Java.

Installation

You can install the AWS Encryption SDK for Java in the following ways.

Manually

To install the AWS Encryption SDK for Java, clone or download the aws-encryption-sdk-java GitHub repository.

Using Apache Maven

The AWS Encryption SDK for Java is available through Apache Maven with the following dependency definition.

Copy
<dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-encryption-sdk-java</artifactId> <version>0.0.1</version> </dependency>

After you install the SDK, get started by looking at the example Java code in this guide and the Javadoc on GitHub.

On this page: