기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 마이그레이션 AWS Encryption SDK 는 여러 상호 운용 가능한 [프로그래밍 언어 구현](programming-languages.md)을 AWS Encryption SDK 지원하며, 각 구현은 GitHub의 오픈 소스 리포지토리에서 개발됩니다. [가장 좋은 방법은](best-practices.md) 각 언어에 AWS Encryption SDK 대해 최신 버전의를 사용하는 것입니다. 버전 2.0.*x* 이상에서 최신 버전으로 안전하게 업그레이드 AWS Encryption SDK 할 수 있습니다. 그러나의 2.0.*x* 버전에는 중요한 새로운 보안 기능이 AWS Encryption SDK 도입되었으며, 그 중 일부는 주요 변경 사항입니다. 1.7.*x* 이하 버전에서 2.0.*x* 및 이상 버전으로 업그레이드하려면 먼저 최신 1.*x* 버전으로 업그레이드해야 합니다. 이 섹션의 항목은 변경 사항을 이해하고, 애플리케이션에 맞는 올바른 버전을 선택하고, AWS Encryption SDK의 최신 버전으로 안전하고 성공적으로 마이그레이션하는 데 도움이 되도록 설계되었습니다. 의 중요 버전에 대한 자세한 내용은 섹션을 AWS Encryption SDK참조하세요[의 버전 AWS Encryption SDK](about-versions.md). **중요** 1.7.*x* 이하 버전에서 최신 1.*x* 버전으로 먼저 업그레이드하지 않고 곧바로 2.0.*x* 이상 버전으로 업그레이드해서는 안됩니다. 버전 2.0.*x* 이상으로 직접 업그레이드하고 모든 새 기능을 즉시 활성화하면 AWS Encryption SDK 는 이전 버전의에서 암호화된 사이퍼텍스트를 해독할 수 없습니다 AWS Encryption SDK. **참고** AWS Encryption SDK for .NET의 최신 버전은 버전 3.0.*x*입니다. AWS Encryption SDK for .NET의 모든 버전은의 2.0.*x*에 도입된 보안 모범 사례를 지원합니다 AWS Encryption SDK. 코드나 데이터를 변경하지 않고도 최신 버전으로 안전하게 업그레이드할 수 있습니다. AWS Encryption CLI:이 마이그레이션 가이드를 읽을 때 AWS Encryption CLI 1.8.*x*에 대한 1.7.*x* 마이그레이션 지침을 사용하고 AWS Encryption CLI 2.1.*x*에 대한 2.0.*x* 마이그레이션 지침을 사용합니다. 자세한 내용은 [AWS 암호화 CLI 버전](crypto-cli-versions.md)을 참조하세요. 새로운 보안 기능은 원래 AWS Encryption CLI 버전 1.7.*x* 및 2.0.*x*에서 릴리스되었습니다. 그러나 AWS Encryption CLI 버전 1.8.*x*는 버전 1.7.*x*를 대체하고 AWS Encryption CLI 2.1.*x*는 2.0.*x*를 대체합니다. 자세한 내용은 GitHub의 [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/) 리포지토리에서 관련 [보안 권고](https://github.com/aws/aws-encryption-sdk-cli/security/advisories/GHSA-2xwp-m7mq-7q3r)를 참조하세요. **신규 사용자** 를 처음 사용하는 경우 프로그래밍 언어에 AWS Encryption SDK 맞는 최신 버전의를 AWS Encryption SDK설치합니다. 기본값은의 서명 AWS Encryption SDK, 키 파생 및 [키 커](concepts.md#key-commitment)밋을 사용한 암호화를 포함하여의 모든 보안 기능을 활성화합니다. AWS Encryption SDK **현재 사용자** 가능한 한 빨리 현재 버전에서 사용 가능한 최신 버전으로 업그레이드하는 것이 좋습니다. 의 모든 1.*x* 버전 AWS Encryption SDK 은 일부 프로그래밍 언어의 이후 버전과 마찬가지로 [end-of-support 단계에](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle) 있습니다. 사용 중인 프로그래밍 언어의 AWS Encryption SDK 지원 및 유지 관리 상태에 대한 자세한 내용은 [지원 및 유지 관리](introduction.md#support) 섹션을 참조하세요. AWS Encryption SDK 버전 2.0.*x* 이상에서는 데이터를 보호하는 데 도움이 되는 새로운 보안 기능을 제공합니다. 그러나 AWS Encryption SDK 버전 2.0.*x*에는 이전 버전과 호환되지 않는 주요 변경 사항이 포함되어 있습니다. 안전하게 전환하려면 먼저 현재 버전에서 사용하는 프로그래밍 언어의 최신 1.*x* 버전으로 마이그레이션하세요. 최신 1.*x* 버전이 완전히 배포되고 제대로 작동하면 2.0.*x* 이상 버전으로 안전하게 마이그레이션할 수 있습니다. 이 [2단계 프로세스](migration-guide.md)는 특히 분산 애플리케이션에 중요합니다. 이러한 변경 사항의 기반이 되는 AWS Encryption SDK 보안 기능에 대한 자세한 내용은 *AWS 보안 블로그*의 [향상된 클라이언트 측 암호화: 명시적 KeyIds 및 키 커](https://aws.amazon.com/blogs/security/improved-client-side-encryption-explicit-keyids-and-key-commitment/)밋을 참조하세요. 에서를 사용하는 데 도움이 필요하신 AWS Encryption SDK for Java 가요 AWS SDK for Java 2.x? [사전 조건](java.md#java-prerequisites)을(를) 참조하세요. **Topics** + [마이그레이션 및 배포 방법 AWS Encryption SDK](migration-guide.md) + [AWS KMS 마스터 키 공급자 업데이트](migrate-mkps-v2.md) + [AWS KMS 키링 업데이트](migrate-keyrings-v2.md) + [커밋 정책 설정](migrate-commitment-policy.md) + [최신 버전으로의 마이그레이션 문제 해결](troubleshooting-migration.md)