

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Body Additional Authenticated Data (AAD) di riferimento per AWS Encryption SDK
<a name="body-aad-reference"></a>


|  | 
| --- |
|  Le informazioni presenti su questa pagina sono un riferimento per la creazione della tua libreria di crittografia, compatibile con AWS Encryption SDK. Se non stai creando la tua libreria di crittografia compatibile, allora è probabile che queste informazioni non ti serviranno. Per utilizzare il AWS Encryption SDK in uno dei linguaggi di programmazione supportati, vedere. [Linguaggi di programmazione](programming-languages.md) Per le specifiche che definiscono gli elementi di una corretta AWS Encryption SDK implementazione, vedere la [AWS Encryption SDK Specificazione](https://github.com/awslabs/aws-encryption-sdk-specification/) in GitHub.  | 

È necessario fornire dati autenticati aggiuntivi (AAD) all'[algoritmo AES-GCM](algorithms-reference.md) per ciascuna operazione di crittografia. Questo vale sia per i [dati del corpo](message-format.md#body-structure) framed e non framed. Per ulteriori informazioni su AAD e su come viene utilizzato in Galois/Counter Mode (GCM), consulta [Raccomandazioni per le modalità operative di cifratura a blocchi: Galois/Counter Mode (GCM) e GMAC](https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf).

La tabella seguente descrive i campi che costituiscono l'AAD del corpo. I byte vengono aggiunti nell'ordine mostrato.


**Struttura dell'AAD del corpo**  

| Campo | Lunghezza, in byte | 
| --- | --- | 
| [Message ID](#body-aad-message-id) | 16 | 
| [Body AAD Content](#body-aad-content) | Variabile. Vedi Contenuto dell'AAD del corpo nell'elenco qui di seguito. | 
| [Sequence Number](#body-aad-sequence-number) | 4 | 
| [Content Length](#body-aad-content-length) | 8 | 

**ID del messaggio**  
Lo stesso valore [Message ID](message-format.md#header-message-id) impostato nell'intestazione del messaggio.

**Contenuto Body AAD**  
Un valore codificato UTF-8, stabilito dal tipo di dati del corpo utilizzati.  
Per i [dati non framed](message-format.md#body-no-framing), utilizza il valore `AWSKMSEncryptionClient Single Block`.  
Per i frame regolari nei [dati framed](message-format.md#body-framing), utilizza il valore `AWSKMSEncryptionClient Frame`.  
Per il frame finale nei [dati framed](message-format.md#body-framing), utilizza il valore `AWSKMSEncryptionClient Final Frame`.

**Numero di sequenza**  
È un valore a 4 byte interpretato come un numero intero senza segno a 32 bit.  
Per i [dati framed](message-format.md#body-framing), questo è il numero di sequenza di frame.  
Per i [dati non framed](message-format.md#body-no-framing), usa il valore 1, codificato come 4 byte `00 00 00 01` in notazione esadecimale.

**Lunghezza del contenuto**  
La lunghezza in byte dei dati di testo non crittografato forniti all'algoritmo per la crittografia. È un valore a 8 byte interpretato come un numero intero senza segno a 64 bit.