

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# の本文追加認証データ (AAD) リファレンス AWS Encryption SDK
<a name="body-aad-reference"></a>


|  | 
| --- |
|  このページの情報は、 AWS Encryption SDKと互換性のある独自の暗号化ライブラリを構築するためのリファレンスです。互換性のある独自の暗号化ライブラリを構築しない場合は、この情報は必要ありません。 サポートされているプログラミング言語のいずれか AWS Encryption SDK で を使用するには、「」を参照してください[プログラミング言語](programming-languages.md)。 適切な AWS Encryption SDK 実装の要素を定義する仕様については、GitHub の[AWS Encryption SDK 「仕様](https://github.com/awslabs/aws-encryption-sdk-specification/)」を参照してください。  | 

暗号化オペレーションごとに、[AES-GCM アルゴリズム](algorithms-reference.md)に追加の認証データ (AAD) を指定する必要があります。これは、フレーム化された[本文データ](message-format.md#body-structure)とフレーム化されていない本文データの両方で必要です。AAD および Galois/Counter Mode での使用方法については、「[ブロック暗号の動作モード: Galois/Counter Mode (GCM) および GMAC の推奨事項](https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf)」を参照してください。

以下の表では、本文 AAD を形成するフィールドについて説明します。バイトは示されている順に追加されます。


**本文 AAD 構造**  

| フィールド | 長さ、バイト単位 | 
| --- | --- | 
| [Message ID](#body-aad-message-id) | 16 | 
| [Body AAD Content](#body-aad-content) | 変数。　 以下のリストの本文 AAD コンテンツを参照してください。 | 
| [Sequence Number](#body-aad-sequence-number) | 4 | 
| [Content Length](#body-aad-content-length) | 8 | 

**メッセージ ID**  
メッセージヘッダーの同じ [Message ID](message-format.md#header-message-id) 値のセット。

**本文 AAD コンテンツ**  
使用する本文データのタイプによって決定される、UTF-8 でエンコードされた値。  
[フレーム化されていないデータ](message-format.md#body-no-framing)の場合、`AWSKMSEncryptionClient Single Block` の値を使用します。  
[フレーム化されたデータ](message-format.md#body-framing)の通常のフレーム。`AWSKMSEncryptionClient Frame` の値を使用します。  
[フレーム化されたデータ](message-format.md#body-framing)の最終フレーム。`AWSKMSEncryptionClient Final Frame` の値を使用します。

**シーケンス番号**  
32 ビットの符号なし整数として解釈される 4 バイトの値。  
[フレーム化されたデータ](message-format.md#body-framing)の場合、これはフレームのシーケンス番号です。  
[フレーム化されていないデータ](message-format.md#body-no-framing)の場合、1 の値 (4 バイトの 16 進数表記で `00 00 00 01` としてエンコード) を使用します。

**コンテンツの長さ**  
暗号化のためにアルゴリズムに提供されるプレーンテキストデータの長さ (バイト単位)。これは 64 ビットの符号なし整数として解釈される 8 バイトの値です。