本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 安裝 AWS Encryption SDK 命令列界面
本主題說明如何安裝 AWS 加密 CLI。如需詳細資訊，請參閱 GitHub 上的 [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/) 儲存庫，並[閱讀相關文件](https://aws-encryption-sdk-cli.readthedocs.io/en/latest/)。
**Topics**
+ [安裝必要項目](#crypto-cli-prerequisites)
+ [安裝 CLI](#install-sdk-cli)
## 安裝必要項目
AWS 加密 CLI 建置在 上 適用於 Python 的 AWS Encryption SDK。若要安裝 AWS 加密 CLI，您需要 Python 和 `pip`，Python 套件管理工具。所有支援的平台皆有提供 Python 與 `pip`。
在安裝 AWS 加密 CLI 之前，請先安裝下列先決條件，
**Python**
AWS 加密 CLI 4.2.0 版及更新版本需要 Python 3.8 或更新版本。
舊版的 AWS Encryption CLI 支援 Python 2.7 和 3.4 及更新版本，但我們建議您使用最新版本的 AWS Encryption CLI。
Python 包含在大多數 Linux 和 macOS 安裝中，但您需要升級至 Python 3.6 或更新版本。我們建議您使用最新版本的 Python。在 Windows 上，您必須安裝 Python；預設不會安裝。若要下載並安裝 Python，請參閱 [Python 下載](https://www.python.org/downloads/)。
若要判斷 Python 是否已安裝完畢，請於命令列輸入下列內容。
```
python
```
若要查看 Python 版本，請使用 `-V` (大寫 V) 參數。
```
python -V
```
在 Windows 上，安裝 Python 之後，將`Python.exe`檔案的路徑新增至**路徑**環境變數的值。
在預設情況下，Python 會安裝在 `$home` 子目錄的所有使用者目錄或使用者描述檔目錄中 (`%userprofile%` 或 `AppData\Local\Programs\Python`)。若要找出系統中的 `Python.exe` 檔案，請查看下列登錄機碼。您可以使用 PowerShell 來搜尋登錄。
```
PS C:\> dir HKLM:\Software\Python\PythonCore\version\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\version\InstallPath
```
**pip**
`pip` 為 Python 套件管理工具。若要安裝 AWS Encryption CLI 及其相依性，您需要 `pip` 8.1 或更新版本。如需安裝或升級 的說明`pip`，請參閱 `pip` 文件中的[安裝](https://pip.pypa.io/en/latest/installing/)。
在 Linux 安裝上， 8.1 `pip`之前的版本無法建置 AWS 加密 CLI 所需的**密碼編譯**程式庫。如果您選擇不更新`pip`版本，您可以分別安裝建置工具。如需詳細資訊，請參閱[在 Linux 上建置密碼編譯](https://cryptography.io/en/latest/installation.html#building-cryptography-on-linux)。
**AWS Command Line Interface**
只有在您在 AWS Command Line Interface (AWS CLI) AWS KMS keys 中 AWS Key Management Service 搭配 AWS 加密 CLI 使用 時，才需要 (AWS KMS)。如果您使用的是不同的[主金鑰提供者](concepts.md#master-key-provider)， AWS CLI 則不需要 。
若要 AWS KMS keys 搭配 AWS 加密 CLI 使用 ，您需要[安裝](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)和[設定 ](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration) AWS CLI。組態可讓您用來驗證 的登入資料可供 AWS 加密 CLI AWS KMS 使用。
## 安裝和更新 AWS 加密 CLI
安裝最新版本的 AWS Encryption CLI。當您使用 `pip` 安裝 AWS 加密 CLI 時，它會自動安裝 CLI 所需的程式庫，包括 [適用於 Python 的 AWS Encryption SDK](python.md)、Python [密碼編譯程式庫](https://cryptography.io/en/latest/)和 [適用於 Python (Boto3) 的 AWS SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)。
**注意**
4.0.0 之前的 AWS 加密 CLI 版本處於終止[end-of-support階段](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)。
您可以安全地從 2.1.*x* 版和更新版本更新至最新版本的 AWS 加密 CLI，而不需要變更任何程式碼或資料。不過，2.1.*x* 版中引入[的新安全功能](about-versions.md#version-2)與回溯不相容。若要從 1.7.*x* 版或更早版本更新，您必須先更新至 AWS 加密 CLI 的最新 1.*x* 版本。如需詳細資訊，請參閱[遷移您的 AWS Encryption SDK](migration.md)。
新的安全功能最初在 AWS 加密 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 加密 CLI**
```
pip install aws-encryption-sdk-cli
```
**升級至最新版本的 AWS 加密 CLI**
```
pip install --upgrade aws-encryption-sdk-cli
```
**尋找 AWS 加密 CLI 和 的版本編號 AWS Encryption SDK**
```
aws-encryption-cli --version
```
輸出會列出兩個程式庫的版本編號。
```
aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0
```
**升級至最新版本的 AWS 加密 CLI**
```
pip install --upgrade aws-encryption-sdk-cli
```
如果尚未安裝最新版本的 適用於 Python (Boto3) 的 AWS SDK，安裝 AWS Encryption CLI 也會安裝該版本。如果已安裝 Boto3，安裝程式會驗證 Boto3 版本並視需要更新。
**尋找已安裝的 Boto3 版本**
```
pip show boto3
```
**更新至最新版本的 Boto3**
```
pip install --upgrade boto3
```
若要安裝目前正在開發的 AWS 加密 CLI 版本，請參閱 GitHub 上的 [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/) 儲存庫。
如需使用 `pip` 安裝與升級 Python 套件的詳細資訊，請參閱 [pip 文件](https://pip.pypa.io/en/stable/quickstart/)。