Sommes de contrôle Amazon S3 avec la 3 - AWS SDK for PHP

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Sommes de contrôle Amazon S3 avec la 3

Amazon Simple Storage Service (Amazon S3) permet de spécifier une somme de contrôle lorsque vous chargez un objet. Lorsque vous spécifiez une somme de contrôle, elle est stockée avec l'objet et peut être validée lors du téléchargement de l'objet.

Les checksums fournissent une couche supplémentaire d'intégrité des données lorsque vous transférez des fichiers. Avec les checksums, vous pouvez vérifier la cohérence des données en confirmant que le fichier reçu correspond au fichier d'origine. Pour plus d'informations sur les sommes de contrôle avec Amazon S3, consultez le guide de l'utilisateur d'Amazon Simple Storage Service.

Amazon S3 prend actuellement en charge quatre algorithmes de somme de contrôle : SHA-1, SHA-256, CRC-32 et CRC-32C. Vous avez la possibilité de choisir l'algorithme qui répond le mieux à vos besoins et de laisser le SDK calculer le checksum. Vous pouvez également spécifier leur propre valeur de somme de contrôle précalculée en utilisant l'un des quatre algorithmes pris en charge.

Nous discutons des sommes de contrôle en deux phases de demande : le téléchargement d'un objet et le téléchargement d'un objet.

Charger un objet

Les valeurs valides pour l'algorithme sont CRC32CRC32C,SHA1, etSHA256.

L'extrait de code suivant montre une demande de téléchargement d'un objet avec une somme de contrôle CRC-32. Lorsque le SDK envoie la demande, il calcule le checksum CRC-32 et télécharge l'objet. Amazon S3 stocke le checksum avec l'objet.

Si le checksum calculé par le SDK ne correspond pas au checksum calculé par Amazon S3 lorsqu'il reçoit la demande, une erreur est renvoyée.

Utiliser une valeur de somme de contrôle précalculée

Une valeur de somme de contrôle précalculée fournie avec la demande désactive le calcul automatique par le SDK et utilise la valeur fournie à la place.

L'exemple suivant montre une demande avec une somme de contrôle SHA-256 précalculée.

Si Amazon S3 détermine que la valeur de la somme de contrôle est incorrecte pour l'algorithme spécifié, le service renvoie une réponse d'erreur.

Chargements partitionnés

Vous pouvez également utiliser des checksums pour les téléchargements partitionnés.

Télécharger un objet

Lorsque vous utilisez la méthode GetObject pour télécharger un objet, le SDK valide automatiquement le checksum est. enabled

La demande contenue dans l'extrait suivant demande au SDK de valider la somme de contrôle dans la réponse en calculant la somme de contrôle et en comparant les valeurs.

Si l'objet n'a pas été chargé avec une somme de contrôle, aucune validation n'a lieu.

Un objet dans Amazon S3 peut avoir plusieurs checksum, mais un seul checksum est validé lors du téléchargement. La priorité suivante, basée sur l'efficacité de l'algorithme de somme de contrôle, détermine la somme de contrôle validée par le SDK :

  1. CRC-32C

  2. CRC-32

  3. SHA-1

  4. SHA-256

Par exemple, si une réponse contient à la fois des sommes de contrôle CRC-32 et SHA-256, seule la somme de contrôle CRC-32 est validée.