Menginstal antarmuka baris AWS Encryption SDK perintah

Topik ini menjelaskan cara menginstal CLI AWS Enkripsi. Untuk informasi lebih lanjut, lihat aws-encryption-sdk-clirepositori GitHub dan Baca Dokumen.

Memasang prasyarat

CLI AWS Enkripsi dibangun di atas file. AWS Encryption SDK for Python Untuk menginstal CLI AWS Enkripsi, Anda memerlukan Python dan, alat manajemen paket pip Python. Python dan pip tersedia di semua platform yang didukung.

Instal prasyarat berikut sebelum Anda menginstal CLI Enkripsi, AWS

Python

Python 3.8 atau yang lebih baru diperlukan oleh Encryption AWS CLI versi 4.2.0 dan yang lebih baru.

Versi sebelumnya dari AWS Encryption CLI mendukung Python 2.7 dan 3.4 dan yang lebih baru, tetapi kami menyarankan Anda menggunakan versi terbaru dari Encryption CLI. AWS

Python termasuk dalam sebagian besar instalasi Linux dan macOS, tetapi Anda perlu meningkatkan ke Python 3.6 atau yang lebih baru. Kami menyarankan Anda menggunakan versi terbaru Python. Pada Windows, Anda harus menginstal Python; itu tidak diinstal secara default. Untuk mengunduh dan menginstal Python, lihat unduhan Python.

Untuk menentukan apakah Python diinstal, pada baris perintah, ketik berikut ini.

python

Untuk memeriksa versi Python, gunakan parameter -V (huruf besar V).

python -V

Di Windows, setelah Anda menginstal Python, tambahkan path ke Python.exe file ke nilai variabel lingkungan Path.

Secara default, Python dipasang di direktori semua pengguna atau di direktori profil pengguna ($homeatau%userprofile%) di subdirektori. AppData\Local\Programs\Python Untuk menemukan lokasi Python.exe file di sistem Anda, periksa salah satu kunci registri berikut. Anda dapat menggunakan PowerShell untuk mencari registri.

PS C:\> dir HKLM:\Software\Python\PythonCore\version\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\version\InstallPath

pip

pipadalah manajer paket Python. Untuk menginstal CLI AWS Enkripsi dan dependensinya, Anda memerlukan pip 8.1 atau lebih baru. Untuk bantuan menginstal atau meningkatkanpip, lihat Instalasi dalam pip dokumentasi.

Pada instalasi Linux, versi pip lebih awal dari 8.1 tidak dapat membangun pustaka kriptografi yang dibutuhkan AWS CLI Enkripsi. Jika Anda memilih untuk tidak memperbarui pip versi, Anda dapat menginstal alat build secara terpisah. Untuk informasi selengkapnya, lihat Membangun kriptografi di Linux.

AWS Command Line Interface

AWS Command Line Interface (AWS CLI) diperlukan hanya jika Anda menggunakan AWS KMS keys in AWS Key Management Service (AWS KMS) dengan CLI AWS Enkripsi. Jika Anda menggunakan penyedia kunci master yang berbeda, tidak AWS CLI diperlukan.

Untuk menggunakan AWS KMS keys CLI AWS Enkripsi, Anda perlu menginstal dan mengkonfigurasi file. AWS CLI Konfigurasi membuat kredensional yang Anda gunakan untuk mengautentikasi agar AWS KMS tersedia untuk CLI Enkripsi AWS .

Menginstal dan memperbarui CLI AWS Enkripsi

Instal CLI AWS Enkripsi versi terbaru. Ketika Anda menggunakan pip untuk menginstal CLI AWS Enkripsi, secara otomatis menginstal pustaka yang dibutuhkan CLI, termasuk, pustaka kriptografi Python, AWS Encryption SDK for Pythondan file. AWS SDK for Python (Boto3)

catatan

Versi CLI AWS Enkripsi lebih awal dari 4.0.0 sedang dalam fase. end-of-support

Anda dapat memperbarui dengan aman dari versi 2.1. x dan yang lebih baru ke versi terbaru CLI AWS Enkripsi tanpa perubahan kode atau data apa pun. Namun, fitur keamanan baru diperkenalkan di versi 2.1. x tidak kompatibel ke belakang. Untuk memperbarui dari versi 1.7. x atau sebelumnya, Anda harus terlebih dahulu memperbarui ke yang terbaru 1. x versi CLI AWS Enkripsi. Lihat perinciannya di MigrasiAWS Encryption SDK.

Fitur keamanan baru awalnya dirilis dalam AWS Enkripsi CLI versi 1.7. x dan 2.0. x. Namun, AWS Enkripsi CLI versi 1.8. x menggantikan versi 1.7. x dan AWS Enkripsi CLI 2.1. x menggantikan 2.0. x. Untuk detailnya, lihat penasihat keamanan yang relevan di aws-encryption-sdk-clirepositori di. GitHub

Untuk menginstal versi terbaru dari AWS Encryption CLI

pip install aws-encryption-sdk-cli

Untuk meng-upgrade ke versi terbaru dari AWS Encryption CLI

pip install --upgrade aws-encryption-sdk-cli

Untuk menemukan nomor versi CLI AWS Enkripsi Anda dan AWS Encryption SDK

aws-encryption-cli --version

Output mencantumkan nomor versi kedua pustaka.

aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0

Untuk meng-upgrade ke versi terbaru dari AWS Encryption CLI

pip install --upgrade aws-encryption-sdk-cli

Menginstal CLI AWS Enkripsi juga menginstal versi terbaru dari AWS SDK for Python (Boto3), jika belum diinstal. Jika Boto3 diinstal, penginstal memverifikasi versi Boto3 dan memperbaruinya jika diperlukan.

Untuk menemukan versi Boto3 yang Anda instal

pip show boto3

Untuk memperbarui ke versi terbaru Boto3

pip install --upgrade boto3

Untuk menginstal versi CLI AWS Enkripsi yang saat ini sedang dalam pengembangan, lihat aws-encryption-sdk-clirepositori aktif. GitHub

Untuk detail selengkapnya tentang penggunaan pip untuk menginstal dan memutakhirkan paket Python, lihat dokumentasi pip.