Proteções de integridade de dados para o Amazon S3 - AWS SDKs e ferramentas

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á.

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

nota

Para obter ajuda na compreensão do layout das páginas de configurações ou na interpretação da tabela Support by AWS SDKs and tools a seguir, consulteEntender as páginas de configurações deste guia.

Há algum tempo, AWS SDKs suportamos 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 CRC64 NVME. Embora cada SDK ou ferramenta tenha um algoritmo padrão, você pode escolher um algoritmo diferente. Se desejar, você também pode continuar fornecendo manualmente uma soma de verificação pré-calculada para os uploads. 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 do nosso AWS SDKs calculam AWS CLI automaticamente uma soma de verificação baseada em verificação de redundância cíclica (CRC) para cada upload e a enviam para o 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. Ao armazenar 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 fazer upload de arquivos em várias partes, SDKs calcule 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 Support by AWS SDKs and tools. Você pode optar por uma soma de verificação completa do objeto definindo checksum_type a configuração FULL_OBJECT ou optando por usar o algoritmo CRC64 NVME.

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

Se seu aplicativo usa uma versão anterior a dezembro de 2024 do SDK ou da ferramenta, o Amazon S3 ainda computa CRC64 uma soma de verificação NVME 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.

Configure essa funcionalidade usando o seguinte:

request_checksum_calculation- configuração de AWS config arquivo compartilhado
AWS_REQUEST_CHECKSUM_CALCULATION: variável de ambiente
aws.requestChecksumCalculation- Propriedade do sistema JVM: somente Java/Kotlin

Por padrão, os usuários optam por calcular a soma de verificação da solicitação ao enviar uma solicitação. O usuário pode escolher um dos algoritmos de soma de verificação disponíveis como parte da criação da solicitação. Caso contrário, é usado um algoritmo padrão específico do SDK. Consulte a tabela Support by AWS SDKs and tools para ver o algoritmo padrão para cada SDK ou ferramenta.

Valor padrão: WHEN_SUPPORTED

Valores válidos:

  • WHEN_SUPPORTED: a validação da soma de verificação é realizada em todas as cargas úteis de solicitação quando compatível com a operação da API, como transferências de dados para o Amazon S3.

  • WHEN_REQUIRED: a validação da soma de verificação é realizada somente quando exigido pela operação da API.

response_checksum_validation- configuração de AWS config arquivo compartilhado
AWS_RESPONSE_CHECKSUM_VALIDATION: variável de ambiente
aws.responseChecksumValidation- Propriedade do sistema JVM: somente Java/Kotlin

Por padrão, os usuários optam por uma validação da soma de verificação ao enviar uma solicitação. Uma soma de verificação para a carga útil da resposta é calculada e comparada com o cabeçalho da resposta da soma de verificação. Se houver falha na validação da soma de verificação, será gerado um erro para o usuário quando a carga útil for lida.

O cabeçalho da resposta da soma de verificação também indica o algoritmo para a soma de verificação. O cliente Amazon S3 tenta validar somas de verificação de resposta para todas as operações de API do Amazon S3 compatíveis com somas de verificação. Porém, se o SDK não tiver implementado o algoritmo de soma de verificação especificado, essa validação será ignorada.

Valor padrão: WHEN_SUPPORTED

Valores válidos:

  • WHEN_SUPPORTED: a validação da soma de verificação é realizada em todas as cargas úteis de resposta quando compatível com a operação de API, como transferências de dados para o Amazon S3.

  • WHEN_REQUIRED: a validação da soma de verificação é realizada somente quando compatível com a operação de API e quando o chamador habilitou explicitamente a soma de verificação para a operação. Por exemplo, quando a API GetObject do Amazon S3 é chamada e o parâmetro ChecksumMode é definido como habilitado.

Support by AWS SDKs and tools

Os itens a seguir SDKs oferecem suporte aos recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. Todas as configurações de propriedade do sistema JVM são suportadas pelo AWS SDK para Java e pelo AWS SDK para Kotlin único.

nota

Na tabela a seguir, "CRT" se refere ao AWS Bibliotecas do Common Runtime (CRT) e pode exigir a adição de uma dependência adicional ao projeto.

SDK Compatível Algoritmo da soma de verificação padrão Algoritmos de soma de verificação compatíveis Notas ou mais informações
AWS CLI v2 Sim CRC64NVME CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 Para a AWS CLI v1, o algoritmo padrão e os algoritmos suportados serão idênticos ao Python (Boto3).
SDK para C++ Sim CRC64NVME CRC64NVME, CRC32 C CRC32,, SHA1 SHA256
SDK para Go V2 (1.x) Sim CRC32 CRC64NVME, CRC32 C CRC32,, SHA1 SHA256
SDK para Go 1.x (V1) Não
SDK para Java 2.x Sim CRC32 CRC64NVME (somente via CRT),, C, CRC32, CRC32 SHA1 SHA256
SDK para Java 1.x Não
SDK para 3.x JavaScript Sim CRC32 CRC32, CRC32 C, SHA1, SHA256
SDK para 2.x JavaScript Não
SDK para Kotlin Sim CRC32 CRC32, CRC32 C, SHA1, SHA256
SDK para .NET 4.x Sim CRC32 CRC32, CRC32 C, SHA1, SHA256
SDK para .NET 3.x Sim CRC32 CRC32, CRC32 C, SHA1, SHA256
SDK para PHP 3.x Sim CRC32 CRC32, CRC32 C (somente via CRT),, SHA1 SHA256 awscrta extensão é necessária para usar CRC32 C.
SDK para Python (Boto3) Sim CRC32 CRC64NVME (somente via CRT) CRC32, CRC32 C (somente via CRT),, SHA1 SHA256
SDK para Ruby 3.x Sim CRC32 CRC64NVME (somente via CRT) CRC32, CRC32 C (somente via CRT),, SHA1 SHA256
SDK para Rust Sim CRC32 CRC64NVME, CRC32 C CRC32,, SHA1 SHA256
SDK para Swift Sim CRC32 CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 Dependência de CRT requerida para todos os algoritmos.
Ferramentas para PowerShell V5 Sim CRC32 CRC32, CRC32 C, SHA1, SHA256
Ferramentas para PowerShell V4 Sim CRC32 CRC32, CRC32 C, SHA1, SHA256