Amazon S3 のデータ整合性保護

この機能を設定するには、以下のように使用します。

request_checksum_calculation - AWS config 共有ファイル設定

AWS_REQUEST_CHECKSUM_CALCULATION - 環境変数

aws.requestChecksumCalculation - JVM システムプロパティ: Java/Kotlin のみ

デフォルトでは、ユーザーはリクエストの送信時にリクエストのチェックサムを計算するようオプトインされます。ユーザーは、リクエストの構築の一環として、使用可能なチェックサムアルゴリズムのいずれかを選択できます。選択しない場合は、SDK 固有のデフォルトアルゴリズムが使用されます。各 SDK またはツールのデフォルトアルゴリズムについては、AWS SDK とツールによるサポート テーブルを参照してください。

デフォルト値: WHEN_SUPPORTED

有効な値:

• WHEN_SUPPORTED – チェックサム検証は、Amazon S3 へのデータ転送など、API オペレーションでサポートされている場合、すべてのリクエストペイロードで実行されます。

• WHEN_REQUIRED – チェックサム検証は、API オペレーションで必要な場合にのみ実行されます。

response_checksum_validation - AWS config 共有ファイル設定

AWS_RESPONSE_CHECKSUM_VALIDATION - 環境変数

aws.responseChecksumValidation - JVM システムプロパティ: Java/Kotlin のみ

デフォルトでは、ユーザーはリクエストの送信時にレスポンスのチェックサムの検証にオプトインされます。チェックサムはレスポンスペイロードに対して計算され、チェックサムのレスポンスヘッダーと比較されます。チェックサムの検証に失敗すると、ペイロードの読み取り時にエラーが発生します。

チェックサムのレスポンスヘッダーには、チェックサムのアルゴリズムも示されます。Amazon S3 クライアントは、チェックサムをサポートするすべての Amazon S3 API オペレーションのレスポンスのチェックサム検証を試みます。ただし、SDK が指定されたチェックサムアルゴリズムを実装していない場合、この検証はスキップされます。

デフォルト値: WHEN_SUPPORTED

有効な値:

• WHEN_SUPPORTED – チェックサム検証は、Amazon S3 へのデータ転送など、API オペレーションでサポートされている場合、すべてのレスポンスペイロードで実行されます。

• WHEN_REQUIRED – チェックサム検証は、API オペレーションでサポートされ、呼び出し元がオペレーションのチェックサムを明示的に有効にしている場合にのみ実行されます。例えば、Amazon S3 GetObject API が呼び出され、ChecksumMode パラメータが有効に設定されている場合などです。