

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Hauptteil der Referenz für zusätzliche authentifizierte Daten (AAD) für AWS Encryption SDK
<a name="body-aad-reference"></a>


|  | 
| --- |
|  Die Informationen auf dieser Seite stellen eine Referenz für die Erstellung Ihrer eigenen, mit AWS Encryption SDK kompatiblen Verschlüsselungsbibliothek dar. Falls Sie keine eigene kompatible Verschlüsselungsbibliothek erstellen, benötigen Sie diese Informationen wahrscheinlich nicht. Informationen zur Verwendung von AWS Encryption SDK in einer der unterstützten Programmiersprachen finden Sie unter. [Programmiersprachen](programming-languages.md) Die Spezifikation, die die Elemente einer ordnungsgemäßen AWS Encryption SDK Implementierung definiert, finden Sie in der [AWS Encryption SDK Spezifikation](https://github.com/awslabs/aws-encryption-sdk-specification/) unter GitHub.  | 

Sie müssen zusätzliche authentifizierte Daten (AAD) für den [AES-GCM-Algorithmus](algorithms-reference.md) für jede kryptografische Operation angeben. Dies gilt für [Textdaten](message-format.md#body-structure) mit und ohne Frame. Weitere Informationen zu AAD und seiner Verwendung im Galois/Counter Modus (GCM) finden Sie unter [Empfehlungen für Block Cipher Modes of Operations: Galois/Counter Mode (GCM) und GMAC](https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf).

In der folgenden Tabelle sind die Felder beschrieben, die die Text-AAD bilden. Die Byte werden in der angegebenen Reihenfolge angehängt.


**Struktur der Text-AAD**  

| Feld | Länge, in Bytes | 
| --- | --- | 
| [Message ID](#body-aad-message-id) | 16 | 
| [Body AAD Content](#body-aad-content) | Variable. Weitere Informationen finden Sie unter Text-AAD-Inhalt in der folgenden Liste. | 
| [Sequence Number](#body-aad-sequence-number) | 4 | 
| [Content Length](#body-aad-content-length) | 8 | 

**Nachrichten-ID**  
Der gleiche [Message ID](message-format.md#header-message-id)-Wert, wie der im Nachrichten-Header festgelegte Wert.

**AAD-Inhalt des Hauptteils**  
Ein UTF-8-kodierter Wert, abhängig von der Art der verwendeten Textdaten.  
Für [Daten ohne Frame](message-format.md#body-no-framing) verwenden Sie den Wert `AWSKMSEncryptionClient Single Block`.  
Für reguläre Frames in [Daten mit Frame](message-format.md#body-framing) verwenden Sie den Wert `AWSKMSEncryptionClient Frame`.  
Für den abschließenden Frame in [Daten mit Frame](message-format.md#body-framing) verwenden Sie den Wert `AWSKMSEncryptionClient Final Frame`.

**Sequenznummer**  
Ein 4-Byte-Wert, interpretiert als vorzeichenlose 32-Bit-Ganzzahl.  
Für [Daten mit Frame](message-format.md#body-framing) ist dies die Frame-Folgenummer.  
Für [Daten ohne Frame](message-format.md#body-no-framing) verwenden Sie den Wert 1, kodiert als die 4 Bytes `00 00 00 01` im Hexadezimalformat.

**Länge des Inhalts**  
Die Länge der Klartextdaten in Bytes, die dem Algorithmus zur Verschlüsselung zur Verfügung gestellt werden. Dies ist ein 8-Byte-Wert, interpretiert als vorzeichenlose 64-Bit-Ganzzahl.