Somas de verificação do Amazon S3 com o - AWS SDK for PHP

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 oferece suporte a quatro algoritmos de soma de verificação: SHA -1, SHA -256, -32 e CRC -32C. CRC Você tem a flexibilidade de escolher o algoritmo que melhor atende às suas necessidades e permitir que ele 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 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 SDK calculada 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 desativa 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 pré-calculada de SHA -256.

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 getObjectmétodo para baixar um objeto, o valida SDK automaticamente a soma de verificação . enabled

A solicitação no trecho a seguir orienta o a validar SDK 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 seguinte precedência, com base na eficiência do algoritmo de soma de verificação, determina qual soma de verificação ele valida: SDK

  1. CRC-32° C

  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.