翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# の移行 AWS Encryption SDK
<a name="migration"></a>

は、相互運用可能な複数の[プログラミング言語の実装](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 より前のバージョンからバージョン 2.0.x 以降に直接アップグレードする場合は、最初に最新の 1.x バージョンをアップグレードしてから行ってください。バージョン 2.0.*x* 以降に直接アップグレードし、すべての新機能をすぐに有効にすると、 AWS Encryption SDK は古いバージョンの で暗号化された暗号文を復号できなくなります AWS Encryption SDK。

**注記**  
for .NET AWS Encryption SDK の最も古いバージョンはバージョン 3.0.*x* です。 AWS Encryption SDK for .NET のすべてのバージョンは、 の 2.0.*x* で導入されたセキュリティのベストプラクティスをサポートしています AWS Encryption SDK。コードやデータを変更することなく、最新バージョンに安全にアップグレードできます。  
AWS Encryption CLI: この移行ガイドを読むときは、Encryption CLI 1.8.*x* AWS の 1.7.*x* 移行手順と Encryption CLI 2.1.*x* の AWS 2.0.*x* 移行手順を使用します。詳細については、「[Encryption 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)