Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cuerpo de referencia de datos autenticados adicionales (AAD) para el AWS Encryption SDK
<a name="body-aad-reference"></a>


|  | 
| --- |
| La información de esta página le servirá de referencia para crear su propia biblioteca de cifrado compatible con el AWS Encryption SDK. Si no está creando su propia biblioteca de cifrado compatible, es probable que no necesite esta información.<br />Para usarlos AWS Encryption SDK en uno de los lenguajes de programación compatibles, consulte. [Lenguajes de programación](programming-languages.md)<br />Para ver la especificación que define los elementos de una AWS Encryption SDK implementación adecuada, consulte la [AWS Encryption SDK especificación ](https://github.com/awslabs/aws-encryption-sdk-specification/) en GitHub. | 

Debe proporcionar datos autenticados adicionales (AAD) al [ AES-GCM algoritmo ](algorithms-reference.md) para cada operación criptográfica. Esto es válido para [datos del cuerpo con o sin trama](message-format.md#body-structure). Para obtener más información sobre el AAD y cómo se usa en Galois/Counter modo (GCM), consulte [ Recomendaciones para los modos de operación del cifrado por bloques: Galois/Counter modo (GCM) y GMAC. ](https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf)

En la siguiente tabla se describen los campos que componen la AAD del cuerpo. Los bytes se anexan en el orden mostrado


**Estructura de la AAD del cuerpo**  

| Campo | Longitud, en bytes | 
| --- | --- | 
| [Message ID](#body-aad-message-id) | 16 | 
| [Body AAD Content](#body-aad-content) | Variable. Consulte Body AAD Content en la siguiente lista. | 
| [Sequence Number](#body-aad-sequence-number) | 4 | 
| [Content Length](#body-aad-content-length) | 8 | 

**ID del mensaje**  
El mismo valor de [Message ID](message-format.md#header-message-id) establecido en el encabezado del mensaje.

**Cuerpo: Contenido de AAD**  
Un valor UTF-8 codificado determinado por el tipo de datos corporales utilizados.  
Para [datos sin trama](message-format.md#body-no-framing), utilice el valor `AWSKMSEncryptionClient Single Block`.  
Para las tramas normales en los [datos con trama](message-format.md#body-framing), utilice el valor `AWSKMSEncryptionClient Frame`.  
Para la trama final en los [datos con trama](message-format.md#body-framing), utilice el valor `AWSKMSEncryptionClient Final Frame`.

**Número de secuencia**  
Un valor de 4 bytes interpretado como un entero sin signo de 32 bits.  
Para los [datos con trama](message-format.md#body-framing), este es el número de secuencia de la trama.  
Para [datos sin trama](message-format.md#body-no-framing), utilice el valor 1, codificado como `00 00 00 01` de 4 bytes en notación hexadecimal.

**Longitud del contenido**  
La longitud, en bytes, de los datos en texto no cifrado proporcionados al algoritmo para el cifrado. Se trata de un valor de 8 bytes interpretado como un entero sin signo de 64 bits.