As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS Encryption SDK for Java
Este tópico explica como instalar e usar o AWS Encryption SDK for Java. Para obter detalhes sobre a programação com o AWS Encryption SDK for Java, consulte o [aws-encryption-sdk-java](https://github.com/aws/aws-encryption-sdk-java/)repositório em GitHub. Para obter a documentação da API, consulte o [Javadoc](https://aws.github.io/aws-encryption-sdk-java/) para AWS Encryption SDK for Java.
**Topics**
+ [Pré-requisitos](#java-prerequisites)
+ [Instalação](#java-installation)
+ [Exemplos](java-example-code.md)
## Pré-requisitos
Antes de instalar o AWS Encryption SDK for Java, verifique se você tem os seguintes pré-requisitos.
**Um ambiente de desenvolvimento Java**
Você precisará do Java 8 ou posterior. No site da Oracle, acesse [Java SE Downloads](https://www.oracle.com/java/technologies/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)](http://www.oracle.com/java/technologies/javase-jce8-downloads.html).
**Bouncy Castle**
AWS Encryption SDK for Java Isso requer o [Bouncy Castle.](https://www.bouncycastle.org/download/bouncy-castle-java/)
+ AWS Encryption SDK for Java as versões 1.6.1 e posteriores usam o Bouncy Castle para serializar e desserializar objetos criptográficos. Você pode usar o Bouncy Castle ou o [Bouncy Castle FIPS](https://www.bouncycastle.org/about/bouncy-castle-fips-faq/) para atender a esse requisito. **Para obter ajuda na instalação e configuração do Bouncy Castle FIPS, consulte a [documentação do BC FIPS](https://www.bouncycastle.org/documentation/), especialmente os Guias **do Usuário** e a Política de Segurança.** PDFs
+ As versões anteriores do AWS Encryption SDK for 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, acesse [Baixar Bouncy Castle for Java para](https://bouncycastle.org/download/bouncy-castle-java/) baixar o arquivo do provedor que corresponde ao seu JDK. [Você também pode usar o [Apache Maven](https://maven.apache.org/) para obter o artefato para o provedor padrão do Bouncy Castle ([bcprov-ext-jdk15on](https://mvnrepository.com/artifact/org.bouncycastle/bcprov-ext-jdk15on)) ou o artefato para o Bouncy Castle FIPS (bc-fips).](https://mvnrepository.com/artifact/org.bouncycastle/bc-fips)
**AWS SDK para Java**
Versão 3. *x* of the AWS Encryption SDK for Java requer o AWS SDK for Java 2.x, mesmo se você não usar AWS KMS chaveiros.
Versão 2. *x* ou anterior do AWS Encryption SDK for Java não requer AWS SDK para Java o. No entanto, AWS SDK para Java é necessário usar [AWS Key Management Service](https://aws.amazon.com/kms/)(AWS KMS) como provedor de chave mestra. A partir da AWS Encryption SDK for Java versão 2.4.0, o AWS Encryption SDK for Java suporta as versões 1.x e 2.x do. AWS SDK para Java AWS Encryption SDK os códigos para AWS SDK para Java 1.x e 2.x são interoperáveis. Por exemplo, você pode criptografar dados com AWS Encryption SDK código compatível com AWS SDK para Java 1.x e descriptografá-los usando código compatível AWS SDK for Java 2.x (ou vice-versa). As versões AWS Encryption SDK for Java anteriores à 2.4.0 suportam apenas AWS SDK para Java 1.x. Para obter informações sobre como atualizar sua versão do AWS Encryption SDK, consulte[Migrando seu AWS Encryption SDK](migration.md).
Ao atualizar seu AWS Encryption SDK for Java código de AWS SDK para Java 1.x para AWS SDK for Java 2.x, substitua as referências à [`AWSKMS`interface](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kms/package-summary.html) em AWS SDK para Java 1.x por referências à [`KmsClient`interface](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/kms/package-summary.html) em. AWS SDK for Java 2.x O AWS Encryption SDK for Java não suporta a [`KmsAsyncClient`interface](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/kms/KmsAsyncClient.html). Além disso, atualize seu código para usar os objetos relacionados ao AWS KMS no namespace `kmssdkv2`, em vez do namespace `kms`.
Para instalar o AWS SDK para Java, use o Apache Maven.
+ Para [importar todo o AWS SDK para Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-project-maven.html#build-the-entire-sdk-into-your-project) como uma dependência, declare-o no arquivo `pom.xml`.
+ Para criar uma dependência somente para o AWS KMS módulo na AWS SDK para Java versão 1.x, siga as instruções para [especificar módulos específicos](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-project-maven.html#modules-dependencies) e defina o. `artifactId` `aws-java-sdk-kms`
+ Para criar uma dependência somente para o AWS KMS módulo na AWS SDK para Java versão 2.x, siga as instruções para [especificar](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-project-maven.html#modules-dependencies) módulos específicos. Defina o `groupId` como `software.amazon.awssdk` e `artifactId` como `kms`.
Para ver mais mudanças, consulte [O que há de diferente entre a AWS SDK para Java versão 1.x e a 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration-whats-different.html) no Guia do AWS SDK for Java 2.x desenvolvedor.
Os exemplos de Java no Guia do AWS Encryption SDK Desenvolvedor usam AWS SDK for Java 2.x o.
## Instalação
Instalar a versão mais recente do AWS Encryption SDK for Java.
**nota**
Todas as versões AWS Encryption SDK for Java anteriores à 2.0.0 estão em [end-of-supportfase](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle).
Você pode atualizar com segurança a partir da versão 2.0.*x* e posteriores até a versão mais recente do AWS Encryption SDK for Java sem realizar alterações no código ou nos dados. No entanto, os [novos atributos de segurança](about-versions.md#version-2) introduzidos na versão 2.0.*x* não são compatíveis com versões anteriores. Para atualizar a partir de versões anteriores à 1.7.*x* até a versão 2.0. *x* e posteriores, primeiro será necessário atualizar para a versão 1.*x* mais recente do AWS Encryption SDK. Para obter detalhes, consulte [Migrando seu AWS Encryption SDK](migration.md).
Você pode instalar o AWS Encryption SDK for Java das seguintes maneiras.
**Manualmente**
Para instalar o AWS Encryption SDK for Java, clone ou baixe o [aws-encryption-sdk-java](https://github.com/aws/aws-encryption-sdk-java/) GitHubrepositório.
**Uso do Apache Maven**
O AWS Encryption SDK for Java está disponível por meio do [Apache Maven](https://maven.apache.org/) com a seguinte definição de dependência.
```
com.amazonaws
aws-encryption-sdk-java
3.0.0
```
Depois de instalar o SDK, comece examinando o [exemplo de código Java](java-example-code.md) neste guia e o [Javadoc](https://aws.github.io/aws-encryption-sdk-java/) ativado. GitHub