Proteções de integridade de dados para o Amazon S3

Já há algum tempo, os SDKs da AWS são compatíveis com verificações de integridade de dados ao carregar ou baixar dados do Amazon Simple Storage Service. Antes, essas verificações eram opcionais. Agora, habilitamos essas verificações por padrão, usando algoritmos baseados em CRC, como CRC32 ou CRC64NVME. Embora cada SDK ou ferramenta tenha um algoritmo padrão, você pode escolher um algoritmo diferente. Você também pode continuar fornecendo manualmente uma soma de verificação pré-calculada para os uploads, se desejar. O comportamento consistente entre uploads, uploads em várias partes, downloads e modos de criptografia simplifica as verificações de integridade do lado do cliente.

As versões mais recentes de nossos SDKs e AWS CLI da AWS calculam automaticamente uma soma de verificação baseada em verificação de redundância cíclica (CRC) para cada upload e a enviam ao Amazon S3. Em seguida, o Amazon S3 calcula independentemente um valor de soma de verificação do objeto do lado do servidor e o valida com o valor fornecido antes de armazenar o objeto e o valor da soma de verificação nos metadados do objeto. Armazenando a soma de verificação nos metadados junto com o objeto, quando o objeto é baixado, a mesma soma de verificação também pode ser retornada automaticamente e usada para validar os downloads. Você também pode confirmar a soma de verificação armazenada nos metadados do objeto a qualquer momento.

Para saber mais sobre operações de soma de verificação, uploads com várias partes ou a lista de algoritmos de soma de verificação compatíveis, consulte Verificar a integridade do objeto no Amazon S3 Guia do usuário do Amazon Simple Storage Service.

Uploads com várias partes:

O Amazon S3 também fornece aos desenvolvedores somas de verificação completas e consistentes entre os objetos em uploads com uma única parte e com várias partes.

Ao carregar arquivos em várias partes, os SDKs calculam as somas de verificação para cada parte. O Amazon S3 usa essas somas de verificação para verificar a integridade de cada parte por meio da API UploadPart. Além disso, o Amazon S3 valida o tamanho e a soma de verificação do arquivo inteiro quando você chama a API CompleteMultipartUpload.

Se o SDK tiver um Amazon S3 Transfer Manager para auxiliar nos uploads de várias partes, as somas de verificação serão validadas para as partes usando o algoritmo padrão específico do SDK encontrado na tabela Compatibilidade com SDKs e ferramentas da AWS. Você pode optar por uma soma de verificação do objeto completo definindo a configuração checksum_type como FULL_OBJECT ou escolhendo usar o algoritmo CRC64NVME.

Se você estiver usando uma versão mais antiga de SDK ou AWS CLI:

Mesmo que a aplicação usar uma versão de SDK ou ferramenta anterior a dezembro de 2024, o Amazon S3 computa uma soma de verificação CRC64NVME em novos objetos e a armazena nos metadados do objeto para referência futura. Você pode comparar depois o CRC armazenado com um CRC calculado do seu lado e verificar se a transmissão da rede estava correta. Além disso, você ainda pode estender manualmente a proteção de integridade fornecendo suas próprias somas de verificação computadas previamente com suas solicitações de PutObject ou UploadPart, que é a técnica padrão para lidar com isso nas versões mais antigas.

Compatibilidade com SDKs e ferramentas da AWS

Os SDKs a seguir são compatíveis com os recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. As configurações de propriedade do sistema de JVM são compatíveis apenas como o AWS SDK para Java e o AWS SDK para Kotlin.