

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# AWS Encryption SDK for Python
<a name="python"></a>

Topik ini menjelaskan cara menginstal dan menggunakan AWS Encryption SDK for Python. Untuk detail tentang pemrograman dengan AWS Encryption SDK for Python, lihat [aws-encryption-sdk-python](https://github.com/aws/aws-encryption-sdk-python/)repositori di. GitHub Untuk dokumentasi API, lihat [Membaca Dokumen.](https://aws-encryption-sdk-python.readthedocs.io/en/latest/)

**Topics**
+ [Prasyarat](#python-prerequisites)
+ [Penginstalan](#python-installation)
+ [Contoh](python-example-code.md)

## Prasyarat
<a name="python-prerequisites"></a>

Sebelum Anda menginstal AWS Encryption SDK for Python, pastikan Anda memiliki prasyarat berikut.

**Versi Python yang didukung**  
Python 3.8 atau yang lebih baru diperlukan oleh AWS Encryption SDK for Python versi 3.2.0 dan yang lebih baru.  
[AWS Cryptographic Material Providers Library](https://github.com/aws/aws-cryptographic-material-providers-library) (MPL) adalah dependensi opsional untuk yang AWS Encryption SDK for Python diperkenalkan di versi 4. *x*. Jika Anda berniat menginstal MPL, Anda harus menggunakan Python 3.11 atau yang lebih baru.
Versi sebelumnya dari AWS Encryption SDK dukungan Python 2.7 dan Python 3.4 dan yang lebih baru, tetapi kami menyarankan Anda menggunakan versi terbaru dari versi. AWS Encryption SDK  
Untuk mengunduh Python, lihat [Unduh Python](https://www.python.org/downloads/).

**Alat instalasi pip untuk Python**  
`pip`termasuk dalam Python 3.6 dan versi yang lebih baru, meskipun Anda mungkin ingin memutakhirkannya. Untuk informasi selengkapnya tentang memutakhirkan atau menginstal`pip`, lihat [Instalasi](https://pip.pypa.io/en/latest/installation/) di `pip` dokumentasi.

## Penginstalan
<a name="python-installation"></a>

Instal versi terbaru dari file AWS Encryption SDK for Python.

**catatan**  
[Semua versi yang AWS Encryption SDK for Python lebih awal dari 3.0.0 sedang dalam fase. end-of-support](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)  
Anda dapat memperbarui dengan aman dari versi 2.0. *x* dan yang lebih baru ke versi terbaru AWS Encryption SDK tanpa kode atau perubahan data. Namun, [fitur keamanan baru](about-versions.md#version-2) diperkenalkan di versi 2.0. *x* tidak kompatibel ke belakang. Untuk memperbarui dari versi lebih awal dari 1.7. *x* ke versi 2.0. *x* dan yang lebih baru, Anda harus terlebih dahulu memperbarui ke yang terbaru 1. *x* versi AWS Encryption SDK. Lihat perinciannya di [Migrasi Anda AWS Encryption SDK](migration.md).

Gunakan `pip` untuk menginstal AWS Encryption SDK for Python, seperti yang ditunjukkan dalam contoh berikut.

**Pasang versi terbaru**  

```
pip install "aws-encryption-sdk[MPL]"
```
`[MPL]`Akhiran menginstal [Perpustakaan Penyedia Materi AWS Kriptografi](https://github.com/aws/aws-cryptographic-material-providers-library) (MPL). MPL berisi konstruksi untuk mengenkripsi dan mendekripsi data Anda. MPL adalah dependensi opsional untuk AWS Encryption SDK for Python diperkenalkan di versi 4. *x*. Kami sangat merekomendasikan menginstal MPL. Namun, jika Anda tidak berniat menggunakan MPL, Anda dapat menghilangkan akhiran. `[MPL]`

Untuk detail selengkapnya tentang penggunaan pip untuk menginstal dan memutakhirkan paket, lihat [Menginstal Paket](https://packaging.python.org/tutorials/installing-packages/).

 AWS Encryption SDK for Python Membutuhkan [perpustakaan kriptografi](https://cryptography.io/en/latest/) (pyca/kriptografi) di semua platform. Semua versi menginstal dan membangun `cryptography` perpustakaan `pip` secara otomatis di Windows. `pip`8.1 dan yang lebih baru secara otomatis menginstal dan membangun `cryptography` di Linux. Jika Anda menggunakan versi sebelumnya `pip` dan lingkungan Linux Anda tidak memiliki alat yang diperlukan untuk membangun `cryptography` perpustakaan, Anda perlu menginstalnya. Untuk informasi selengkapnya, lihat [Membangun Kriptografi di Linux](https://cryptography.io/en/latest/installation.html#building-cryptography-on-linux).

Versi 1.10.0 dan 2.5.0 dari AWS Encryption SDK for Python pin ketergantungan [kriptografi](https://cryptography.io/en/latest/) antara 2.5.0 dan 3.3.2. Versi lain dari AWS Encryption SDK for Python menginstal versi terbaru kriptografi. Jika Anda memerlukan versi kriptografi lebih lambat dari 3.3.2, kami sarankan Anda menggunakan versi utama terbaru dari. AWS Encryption SDK for Python

Untuk versi pengembangan terbaru AWS Encryption SDK for Python, buka [aws-encryption-sdk-python](https://github.com/aws/aws-encryption-sdk-python/)repositori di. GitHub

Setelah Anda menginstal AWS Encryption SDK for Python, mulailah dengan melihat [kode contoh Python dalam panduan](python-example-code.md) ini.