AWS Encryption SDK para Java - SDK de criptografia da AWS

Se fornecermos uma tradução da versão em inglês do guia, a versão em inglês prevalecerá caso haja qualquer conflito entre as versões. A tradução é fornecida com o uso de tradução por máquina.

AWS Encryption SDK para Java

Este tópico explica como instalar e usar o AWS Encryption SDK para Java. Para obter detalhes sobre como programar com o AWS Encryption SDK para Java, consulte o repositório aws-encryption-sdk-java no GitHub. Para obter a documentação da API, consulte o Javadoc para AWS Encryption SDK para Java.

Prerequisites

Antes de instalar o AWS Encryption SDK para Java, verifique se você tem os pré-requisitos a seguir.

Um ambiente de desenvolvimento Java

Você precisará do Java 8 ou posterior. No site da Oracle, acesse Java SE Downloads e faça download e instale o Java SE Development Kit (JDK).

Se você usa o Oracle JDK, também precisara fazer download e instalar os arquivos de política de jurisdição de força ilimitada JCE (Java Cryptography Extension).

Bouncy Castle

O AWS Encryption SDK para Java requer o Bouncy Castle.

  • O AWS Encryption SDK para Java versões 1.6.1 e posteriores usam Bouncy Castle para serializar e desserializar objetos de criptografia. Você pode usar o Bouncy Castle ou o Bouncy Castle FIPS para atender a esse requisito. Para obter ajuda para instalar e configurar o Bouncy Castle FIPS, consulte a Documentação do BC FIPS, especialmente os Guias do usuário e os PDFs de Política de segurança .

  • Versões anteriores do AWS Encryption SDK para Java usam a API de criptografia do Bouncy Castle para Java. Este requisito só é atendido por não FIPS Bouncy Castle.

Se você não tiver o Bouncy Castle, visite o Bouncy Castle latest releases para fazer download do arquivo do provedor que corresponde a seu JDK. Você também pode usar o Apache Maven para obter o artefato para o provedor padrão do Bouncy Castle (bcprov-ext-jdk15on) ou o artefato para Bouncy Castle FIPS (bc-fips).

AWS SDK for Java (Opcional)

O AWS Encryption SDK para Java não requer o AWS SDK for Java. No entanto, o AWS SDK for Java versão 1.11 é necessário para usar o AWS Key Management Service (AWS KMS) como um provedor de chaves mestras. Ele também é necessário para alguns dos exemplos de código Java neste guia.

Para instalar o AWS SDK for Java, use o Apache Maven. Para importar todo o AWS SDK for Java como uma dependência, declare-o no arquivo pom.xml. Para criar uma dependência somente para o módulo do AWS KMS, siga as instruções para especificar módulos específicos, e defina o artifactId como aws-java-sdk-kms.

Installation

É possível instalar o AWS Encryption SDK para Java das seguintes maneiras.

Manualmente.

Para instalar o AWS Encryption SDK para Java, clone ou faça download do repositório aws-encryption-sdk-java no GitHub.

Uso do Apache Maven

O AWS Encryption SDK para Java está disponível por meio do Apache Maven com a definição de dependência a seguir.

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

Depois de instalar o SDK, comece a usá-lo examinando o código Java de exemplo neste guia e o Javadoc no GitHub.