AWS Encryption SDK 명령줄 인터페이스 설치

이 항목에서는 AWS 암호화 CLI를 설치하는 방법을 설명합니다. 자세한 내용은 aws-encryption-sdk-cli리포지토리를 GitHub 참조하고 문서를 읽어보십시오.

사전 필수 소프트웨어 설치

AWS 암호화 CLI는 를 기반으로 합니다. AWS Encryption SDK for Python AWS 암호화 CLI를 설치하려면 Python과 pip Python 패키지 관리 도구가 필요합니다. Python 및 pip는 지원되는 모든 플랫폼에서 사용할 수 있습니다.

암호화 AWS CLI를 설치하기 전에 다음 사전 요구 사항을 설치하십시오.

Python

AWS 암호화 CLI 버전 4.2.0 이상에서는 Python 3.8 이상이 필요합니다.

이전 버전의 AWS 암호화 CLI는 Python 2.7 및 3.4 이상을 지원하지만 최신 버전의 암호화 CLI를 사용하는 것이 좋습니다. AWS

Python은 대부분의 Linux 및 macOS 설치에 포함되어 있지만 Python 3.6 이상으로 업그레이드해야 합니다. 최신 버전의 Python전을 사용하는 것이 좋습니다. Windows에서는 Python을 설치해야 하며, 이는 기본적으로 설치되어 있지 않습니다. Python을 다운로드하고 설치하려면 Python 다운로드를 참조하세요.

Python 설치 여부를 알아보려면 명령줄에서 다음을 입력합니다.

python

Python 버전을 확인하려면 -V(대문자 V) 파라미터를 사용합니다.

python -V

Windows에서는 Python을 설치한 후 Path 환경 변수의 값에 Python.exe 파일의 경로를 추가합니다.

기본적으로 Python은 모든 사용자 디렉터리 또는 AppData\Local\Programs\Python 하위 디렉터리의 사용자 프로필 디렉터리($home 또는 %userprofile%)에 설치됩니다. 시스템에서 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 암호화 CLI와 해당 종속성을 설치하려면 pip 8.1 이상이 필요합니다. pip 설치 또는 업그레이드에 도움이 필요하면 pip 설명서의 설치를 참조하세요.

Linux 설치의 경우 8.1 pip 이전 버전에서는 암호화 AWS CLI에 필요한 암호화 라이브러리를 빌드할 수 없습니다. pip 버전을 업데이트하지 않기로 선택한 경우 빌드 도구를 별도로 설치할 수 있습니다. 자세한 내용은 Linux에서 암호화 빌드를 참조하세요.

AWS Command Line Interface

AWS Command Line Interface (AWS CLI) 는 AWS 암호화 CLI와 함께 AWS KMS keys in AWS Key Management Service (AWS KMS) 을 사용하는 경우에만 필요합니다. 다른 마스터 키 제공자를 사용하는 경우에는 AWS CLI 가 필요하지 않습니다.

AWS 암호화 AWS KMS keys CLI와 함께 사용하려면 를 설치하고 구성해야 합니다. AWS CLI컨피그레이션은 인증에 사용하는 자격 증명을 AWS Encryption CLI에서 AWS KMS 사용할 수 있도록 합니다.

AWS 암호화 CLI 설치 및 업데이트

최신 버전의 AWS 암호화 CLI를 설치합니다. AWS 암호화 CLI를 설치하는 pip 데 사용하면 Python 암호화 라이브러리 및 를 포함하여 CLI에 필요한 라이브러리가 자동으로 설치됩니다. AWS Encryption SDK for PythonAWS SDK for Python (Boto3)

참고

4.0.0 이전의 AWS 암호화 CLI 버전은 현재 단계에 있습니다. end-of-support

코드나 데이터를 변경하지 않고 버전 2.1.x 이상에서 AWS Encryption CLI의 최신 버전으로 안전하게 업데이트할 수 있습니다. 그러나 버전 2.1.x에 도입된 새로운 보안 기능은 이하 버전과 호환되지 않습니다. 버전 1.7에서 업데이트하려면 x 또는 이전 버전에서는 먼저 최신 버전으로 업데이트해야 합니다. x 버전의 AWS 암호화 CLI입니다. 자세한 내용은 AWS Encryption SDK 마이그레이션단원을 참조하세요.

새로운 보안 기능은 원래 AWS 암호화 CLI 버전 1.7에서 릴리스되었습니다. x 및 2.0. x. 그러나 AWS 암호화 CLI 버전 1.8입니다. x는 버전 1.7을 대체합니다. x 및 AWS 암호화 CLI 2.1. x는 2.0을 대체합니다. x. 자세한 내용은 aws-encryption-sdk-cli리포지토리의 관련 보안 공지를 참조하십시오 GitHub.

최신 버전의 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

AWS Encryption CLI를 설치하면 최신 버전 (아직 설치되지 않은 AWS SDK for Python (Boto3)경우) 도 설치됩니다. Boto3가 설치된 경우 설치 프로그램은 Boto3 버전을 확인하고 필요한 경우 업데이트합니다.

설치된 Boto3 버전 찾기

pip show boto3

Boto3의 최신 버전으로 업데이트

pip install --upgrade boto3

현재 개발 중인 AWS 암호화 CLI 버전을 설치하려면 의 aws-encryption-sdk-cli저장소를 참조하십시오. GitHub

pip를 사용하여 Python 패키지를 설치 및 업그레이드하는 방법에 대한 자세한 내용은 pip 설명서를 참조하세요.