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

# Referensi data terautentikasi tambahan badan (AAD) untuk AWS Encryption SDK
<a name="body-aad-reference"></a>


|  | 
| --- |
|  Informasi di halaman ini adalah referensi untuk membangun pustaka enkripsi Anda sendiri yang kompatibel dengan file AWS Encryption SDK. Jika Anda tidak membangun pustaka enkripsi kompatibel Anda sendiri, Anda mungkin tidak memerlukan informasi ini. Untuk menggunakan AWS Encryption SDK dalam salah satu bahasa pemrograman yang didukung, lihat[Bahasa pemrograman](programming-languages.md). Untuk spesifikasi yang mendefinisikan elemen AWS Encryption SDK implementasi yang tepat, lihat [AWS Encryption SDK Spesifikasi](https://github.com/awslabs/aws-encryption-sdk-specification/) di GitHub.  | 

Anda harus memberikan data otentikasi tambahan (AAD) ke [algoritma AES-GCM](algorithms-reference.md) untuk setiap operasi kriptografi. [Ini berlaku untuk data tubuh berbingkai dan tidak berbingkai.](message-format.md#body-structure) Untuk informasi selengkapnya tentang AAD dan cara penggunaannya dalam Galois/Counter Mode (GCM), lihat [Rekomendasi untuk Mode Operasi Sandi Blok: Galois/Counter Mode (GCM) dan GMAC](https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf).

Tabel berikut menjelaskan bidang yang membentuk tubuh AAD. Byte ditambahkan dalam urutan yang ditunjukkan.


**Struktur AAD Tubuh**  

| Bidang | Panjangnya, dalam byte | 
| --- | --- | 
| [Message ID](#body-aad-message-id) | 16 | 
| [Body AAD Content](#body-aad-content) | Variabel. Lihat Konten Body AAD dalam daftar berikut. | 
| [Sequence Number](#body-aad-sequence-number) | 4 | 
| [Content Length](#body-aad-content-length) | 8 | 

**ID Pesan**  
[Message ID](message-format.md#header-message-id)Nilai yang sama ditetapkan dalam header pesan.

**Konten AAD Tubuh**  
Nilai yang dikodekan UTF-8 ditentukan oleh jenis data tubuh yang digunakan.  
Untuk [data nonframed](message-format.md#body-no-framing), gunakan nilainya. `AWSKMSEncryptionClient Single Block`  
Untuk frame reguler dalam [data berbingkai](message-format.md#body-framing), gunakan nilainya`AWSKMSEncryptionClient Frame`.  
Untuk frame terakhir dalam [data berbingkai](message-format.md#body-framing), gunakan nilainya`AWSKMSEncryptionClient Final Frame`.

**Nomor Urutan**  
Sebuah nilai 4-byte ditafsirkan sebagai 32-bit unsigned integer.  
Untuk [data berbingkai](message-format.md#body-framing), ini adalah nomor urut bingkai.  
Untuk [data nonframed](message-format.md#body-no-framing), gunakan nilai 1, dikodekan sebagai 4 byte `00 00 00 01` dalam notasi heksadesimal.

**Panjang Konten**  
Panjang, dalam byte, dari data plaintext yang disediakan untuk algoritma untuk enkripsi. Ini adalah nilai 8-byte yang ditafsirkan sebagai integer unsigned 64-bit.