Avertissement sur la compatibilité des SDK et de la CLI AWS

Le 16 janvier 2025, Amazon Web Services (AWS) a introduit de nouveaux algorithmes de protection de l’intégrité par défaut lors du chargement et du téléchargement de données à l’aide de l’API S3.

Ces nouveaux contrôles d’intégrité ne sont pas encore mis en œuvre par OOS. En conséquence, utiliser certaines versions mises à jour des SDK ou de la CLI AWS avec OOS renvoie l’erreur client HTTP 400 Bad Request suivante : HTTP 400 Bad Request client error: An error occurred (BadRequest) when calling the PutObject operation: trailing checksum is not supported.

Versions impactées

Produit AWS

Version impactée

aws-cli v1

1.37.0

aws-cli v2

2.23.0

PHP SDK

3.337.0

Python SDK (boto3)

1.36.0

GoLang SDK v2

1.33.0

JavaScript SDK v3

3.729.0

Java SDK v2

2.30.0

Solutions de contournement

Deux solutions de contournement sont disponibles :

  • Utiliser les versions non impactées les plus récentes des SDK et de la CLI AWS :

    Produit AWS

    Dernière version non impactée

    aws-cli v1

    1.36.40

    aws-cli v2

    2.22.35

    PHP SDK

    3.336.15

    Python SDK (boto3)

    1.35.99

    GoLang SDK v2

    1.32.8

    JavaScript SDK v3

    3.728.0

    Java SDK v2

    2.29.52

  • Mettre à jour les variables d’environnement pour les SDK et la CLI AWS à l’aide de la commande suivante (spécifier la valeur WHEN_REQUIRED) :

    export AWS_REQUEST_CHECKSUM_CALCULATION=WHEN_REQUIRED
export AWS_RESPONSE_CHECKSUM_VALIDATION=WHEN_REQUIRED

    Pour en savoir plus, voir la documentation officielle d’AWS sur le SDK.

    Veuillez tenir compte des facteurs suivants au moment de l’utilisation de cette solution de contournement :

    • À ce jour, les versions 2.23.0 à 2.23.4 d’AWS CLI n’implémentent que partiellement cette solution.

      1. aws s3api put-object applique correctement cette configuration, et les téléchargements fonctionnent avec la dernière version d’AWS CLI.

      2. aws s3 cp <file> s3://<bucket> ne prend pas en charge cette correction dans la version v.2.23.0 à v.2.23.4 d’AWS CLI.

      3. Les téléchargements vers OOS échouent avec ces versions.

    • Avec la v.2.23.5 d’AWS CLI ou une version ultérieure, les téléchargements fonctionnent correctement avec OOS.

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF