

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á.

# Migrando seu AWS Encryption SDK
<a name="migration"></a>

O AWS Encryption SDK suporta várias [implementações de linguagem de programação](programming-languages.md) interoperáveis, cada uma delas desenvolvida em um repositório de código aberto no. GitHub Como [prática recomendada](best-practices.md), recomendamos que você use a versão mais recente do AWS Encryption SDK para cada idioma. 

Você pode atualizar com segurança a partir da versão 2.0. *x* ou posterior AWS Encryption SDK para a versão mais recente. No entanto, o 2.0. A versão *x* do AWS Encryption SDK introduz novos recursos de segurança significativos, alguns dos quais são mudanças significativas. Para atualizar de versões anteriores à 1.7.*x* para a versão 2.0.*x* e posteriores, primeiro será necessário atualizar para a versão 1.*x* mais recente. Os tópicos desta seção foram elaborados para ajudar você a entender as alterações, selecionar a versão correta para a aplicação e migrar com segurança e sucesso para as versões mais recentes do AWS Encryption SDK.

Para obter informações sobre versões significativas do AWS Encryption SDK, consulte[Versões do AWS Encryption SDK](about-versions.md).

**Importante**  
Não atualize diretamente de uma versão anterior à 1.7*x* para a versão 2.0.*x* ou posterior sem primeiro atualizar para a mais recente versão 1*x.*. Se você atualizar diretamente para a versão 2.0. *x* ou posterior e habilite todos os novos recursos imediatamente, eles não AWS Encryption SDK conseguirão descriptografar texto cifrado criptografado em versões mais antigas do. AWS Encryption SDK

**nota**  
A versão mais antiga do AWS Encryption SDK para.NET é a versão 3.0. *x.* Todas as versões do AWS Encryption SDK para.NET oferecem suporte às melhores práticas de segurança introduzidas na versão 2.0. *x* do AWS Encryption SDK. É possível atualizar com segurança para a versão mais recente sem fazer alterações no código ou nos dados.  
AWS CLI de criptografia: ao ler este guia de migração, use a versão 1.7. *x* instruções de migração para o AWS Encryption CLI 1.8. *x* e use o 2.0. *x* instruções de migração para o AWS Encryption CLI 2.1. *x.* Para obter detalhes, consulte [Versões da CLI AWS de criptografia](crypto-cli-versions.md).  
Novos recursos de segurança foram lançados originalmente nas versões 1.7 do AWS Encryption CLI. *x* e 2.0. *x.* No entanto, a versão AWS 1.8 do Encryption CLI. *x* substitui a versão 1.7. *x* e CLI de AWS criptografia 2.1. *x* substitui 2.0. *x.* Para obter detalhes, consulte a [consultoria de segurança](https://github.com/aws/aws-encryption-sdk-cli/security/advisories/GHSA-2xwp-m7mq-7q3r) relevante no [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/)repositório em GitHub.

**Novos usuários**  
Se você é novo no AWS Encryption SDK, instale a versão mais recente do AWS Encryption SDK para sua linguagem de programação. Os valores padrão habilitam todos os recursos de segurança do AWS Encryption SDK, incluindo criptografia com assinatura, derivação de [chave e comprometimento de chave](concepts.md#key-commitment). AWS Encryption SDK

**Usuários atuais**  
Recomendamos atualizar da versão atual para a versão mais recente disponível assim que possível. Todos os 1. As versões *x* do AWS Encryption SDK estão em [end-of-support fase](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle), assim como as versões posteriores em algumas linguagens de programação. Para obter detalhes sobre o status de suporte e manutenção do AWS Encryption SDK em sua linguagem de programação, consulte [Suporte e manutenção](introduction.md#support).  
AWS Encryption SDK versões 2.0. *x* e versões posteriores fornecem novos recursos de segurança para ajudar a proteger seus dados. No entanto, AWS Encryption SDK a versão 2.0. *x* inclui alterações significativas que não são compatíveis com versões anteriores. Para garantir uma transição segura, comece migrando da sua versão atual para a mais recente 1.*x* na sua linguagem de programação. Quando a versão 1.*x* estiver totalmente implantada e operando com sucesso, você poderá migrar com segurança para as versões 2.0.*x* e posteriores. Esse [processo de duas etapas](migration-guide.md) é essencial, especialmente para aplicações distribuídas.

*Para obter mais informações sobre os recursos AWS Encryption SDK de segurança subjacentes a essas mudanças, consulte [Criptografia aprimorada do lado do cliente: compromisso explícito KeyIds e fundamental](https://aws.amazon.com/blogs/security/improved-client-side-encryption-explicit-keyids-and-key-commitment/) no Blog de Segurança.AWS *

Procurando ajuda para usar o AWS Encryption SDK for Java com o AWS SDK for Java 2.x? Consulte [Pré-requisitos](java.md#java-prerequisites).

**Topics**
+ [Como migrar e implantar o AWS Encryption SDK](migration-guide.md)
+ [Atualizando provedores de chaves AWS KMS mestras](migrate-mkps-v2.md)
+ [Atualizando AWS KMS chaveiros](migrate-keyrings-v2.md)
+ [Como definir sua política de compromisso](migrate-commitment-policy.md)
+ [Solução de problemas de migração para as versões mais recentes](troubleshooting-migration.md)