Somas de verificação do Amazon S3 com o

O Amazon Simple Storage Service (Amazon S3) oferece a capacidade de especificar uma soma de verificação ao fazer upload de um objeto. Quando você especifica uma soma de verificação, ela é armazenada com o objeto e pode ser validada quando o objeto é baixado.

As somas de verificação fornecem uma camada adicional de integridade de dados quando você transfere arquivos. Com somas de verificação, você pode verificar a consistência de dados confirmando que o arquivo recebido corresponde ao arquivo original. Para obter mais informações sobre somas de verificação com o Amazon S3, consulte o Guia do usuário do Amazon Simple Storage Service.

Atualmente, o Amazon S3 é compatível com quatro algoritmos de soma de verificação: SHA-1, SHA-256, CRC-32 e CRC-32C. Você tem a flexibilidade de escolher o algoritmo mais adequado às suas necessidades e deixar que o SDK calcule a soma de verificação. Como alternativa, você pode especificar seu próprio valor de soma de verificação pré-computado usando um dos quatro algoritmos compatíveis.

Discutimos somas de verificação em duas fases de solicitação: upload de um objeto e download de um objeto.

Fazer upload de um objeto

Os valores válidos para o algoritmo são CRC32, CRC32C, SHA1 e SHA256.

O trecho de código a seguir mostra uma solicitação para carregar um objeto com uma soma de verificação CRC-32. Quando o SDK envia a solicitação, ele calcula a soma de verificação CRC-32 e carrega o objeto. O Amazon S3 armazena a soma de verificação com o objeto.

Se a soma de verificação calculada pelo SDK não corresponder à soma de verificação calculada pelo Amazon S3 ao receber a solicitação, um erro será retornado.

Usar um valor de soma de verificação pré-calculado

Um valor de soma de verificação pré-calculado fornecido com a solicitação desabilita a computação automática pelo SDK e, em vez disso, usa o valor fornecido.

O exemplo a seguir mostra uma solicitação com uma soma de verificação SHA-256 pré-calculada.

Se o Amazon S3 determinar que o valor da soma de verificação está incorreto para o algoritmo especificado, o serviço retornará uma resposta de erro.

Carregamentos fracionados

Você também pode usar somas de verificação com carregamentos fracionados.

Fazer download de um objeto

Quando você usa o método getObject para baixar um objeto, o SDK valida automaticamente a soma de verificação

A solicitação no trecho a seguir direciona o SDK a validar a soma de verificação na resposta calculando a soma de verificação e comparando os valores.

Se o objeto não tiver sido carregado com uma soma de verificação, nenhuma validação ocorrerá.

Um objeto no Amazon S3 pode ter várias somas de verificação, mas somente uma soma de verificação é validada no download. A precedência a seguir, com base na eficiência do algoritmo de soma de verificação, determina qual soma de verificação o SDK valida:

1. CRC-32C

2. CRC-32

3. SHA-1

4. SHA-256

Por exemplo, se uma resposta contiver somas de verificação CRC-32 e SHA-256, somente a soma de verificação CRC-32 será validada.