View a markdown version of this page

Exemplo: upload baseado no navegador usando HTTP POST (usando o AWS Signature Version 4) - Amazon Simple Storage Service
Upload de um arquivo no Amazon S3 usando HTTP POST

Exemplo: upload baseado no navegador usando HTTP POST (usando o AWS Signature Version 4)

Esta seção mostra um exemplo do uso de uma solicitação HTTP POST para fazer upload de conteúdo diretamente no Amazon S3.

Para obter mais informações sobre o Signature Version 4, consulte Processo de assinatura do Signature Version 4.

Upload de um arquivo no Amazon S3 usando HTTP POST

Este exemplo fornece uma política de POST de exemplo e um formulário que você pode usar para fazer upload de um arquivo. Este tópico usa a política de exemplo e as credenciais fictícias para mostrar o fluxo de trabalho e a assinatura e o hash da política resultantes. Você pode usar esses dados como conjunto de testes para verificar seu código de cálculo de assinatura.

O exemplo usa as credenciais de exemplo a seguir nos cálculos da assinatura. Você pode usar essas credenciais para verificar o código de cálculo da assinatura. No entanto, você deve substituí-las por suas próprias credenciais ao enviar solicitações para a AWS.

Parâmetro Valor
AWSAccessKeyId AKIAIOSFODNN7EXAMPLE
AWSSecretAccessKey wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Política e formulário de exemplo

A política de POST a seguir é compatível com uploads no Amazon S3 com condições específicas.

{ "expiration": "2015-12-30T12:00:00.000Z",
  "conditions": [
    {"bucket": "sigv4examplebucket"},
    ["starts-with", "$key", "user/user1/"],
    {"acl": "public-read"},
    {"success_action_redirect": "http://sigv4examplebucket.s3.amazonaws.com/successful_upload.html"},
    ["starts-with", "$Content-Type", "image/"],
    {"x-amz-meta-uuid": "14365123651274"},
    {"x-amz-server-side-encryption": "AES256"},
    ["starts-with", "$x-amz-meta-tag", ""],

    {"x-amz-credential": "AKIAIOSFODNN7EXAMPLE/20151229/us-east-1/s3/aws4_request"},
    {"x-amz-algorithm": "AWS4-HMAC-SHA256"},
    {"x-amz-date": "20151229T000000Z" }
  ]
}

Ela define as seguintes condições na solicitação:

  • O upload deve ocorrer antes do meio-dia UTC em 30 de dezembro de 2015.

  • O conteúdo só pode ser enviado para sigv4examplebucket. O bucket deve estar na região que você especificou no escopo da credencial (parâmetro do formulário x-amz-credential), porque a assinatura fornecida é válida somente dentro desse escopo.

  • Você pode fornecer qualquer nome de chave que comece com user/user1. Por exemplo, user/user1/MyPhoto.jpg.

  • A ACL deve ser definida como public-read.

  • Se o upload for bem-sucedido, o navegador do usuário será redirecionado para http://sigv4examplebucket.s3.amazonaws.com/successful_upload.html.

  • O objeto deve ser um arquivo de imagem.

  • A tag x-amz-meta-uuid deve ser definida como 14365123651274.

  • A x-amz-meta-tag pode conter qualquer valor.

Veja a seguir uma versão codificada em Base64 dessa política de POST. Você usa esse valor como a StringToSign no cálculo da assinatura.

eyAiZXhwaXJhdGlvbiI6ICIyMDE1LTEyLTMwVDEyOjAwOjAwLjAwMFoiLA0KICAiY29uZGl0aW9ucyI6IFsNCiAgICB7ImJ1Y2tldCI6ICJzaWd2NGV4YW1wbGVidWNrZXQifSwNCiAgICBbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAidXNlci91c2VyMS8iXSwNCiAgICB7ImFjbCI6ICJwdWJsaWMtcmVhZCJ9LA0KICAgIHsic3VjY2Vzc19hY3Rpb25fcmVkaXJlY3QiOiAiaHR0cDovL3NpZ3Y0ZXhhbXBsZWJ1Y2tldC5zMy5hbWF6b25hd3MuY29tL3N1Y2Nlc3NmdWxfdXBsb2FkLmh0bWwifSwNCiAgICBbInN0YXJ0cy13aXRoIiwgIiRDb250ZW50LVR5cGUiLCAiaW1hZ2UvIl0sDQogICAgeyJ4LWFtei1tZXRhLXV1aWQiOiAiMTQzNjUxMjM2NTEyNzQifSwNCiAgICB7IngtYW16LXNlcnZlci1zaWRlLWVuY3J5cHRpb24iOiAiQUVTMjU2In0sDQogICAgWyJzdGFydHMtd2l0aCIsICIkeC1hbXotbWV0YS10YWciLCAiIl0sDQoNCiAgICB7IngtYW16LWNyZWRlbnRpYWwiOiAiQUtJQUlPU0ZPRE5ON0VYQU1QTEUvMjAxNTEyMjkvdXMtZWFzdC0xL3MzL2F3czRfcmVxdWVzdCJ9LA0KICAgIHsieC1hbXotYWxnb3JpdGhtIjogIkFXUzQtSE1BQy1TSEEyNTYifSwNCiAgICB7IngtYW16LWRhdGUiOiAiMjAxNTEyMjlUMDAwMDAwWiIgfQ0KICBdDQp9

Quando você copia/cola a política anterior, ela deve ter retornos de carro e novas linhas para que o hash computado corresponda a esse valor (ou seja, texto ASCII, com terminadores de linha CRLF).

Usando credenciais de exemplo para criar uma assinatura, o valor da assinatura é o seguinte (no cálculo da assinatura, a data é igual a x-amz-date na política (20151229):

8afdbf4008c03f22c2cd3cdb72e4afbb1f6a588f3255ac628749a66d7f09699e

O formulário de exemplo a seguir especifica a política de POST anterior e é compatível com uma solicitação POST para o sigv4examplebucket. Copie/cole o conteúdo em um editor de texto e salve-o como exampleform.html. Em seguida, você pode fazer upload de arquivos de imagem para o bucket específico usando o exampleform.html. Sua solicitação será bem-sucedida se a assinatura fornecida corresponder à assinatura calculada pelo Amazon S3.

nota

Você deve atualizar o nome do bucket, as datas, a credencial, a política e a assinatura com valores válidos para que o upload seja realizado no S3. 

<html>
  <head>
    
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    
  </head>
  <body>

  <form action="http://sigv4examplebucket.s3.amazonaws.com/" method="post" enctype="multipart/form-data">
    Key to upload: 
    <input type="input"  name="key" value="user/user1/${filename}" /><br />
    <input type="hidden" name="acl" value="public-read" />
    <input type="hidden" name="success_action_redirect" value="http://sigv4examplebucket.s3.amazonaws.com/successful_upload.html" />
    Content-Type: 
    <input type="input"  name="Content-Type" value="image/jpeg" /><br />
    <input type="hidden" name="x-amz-meta-uuid" value="14365123651274" /> 
    <input type="hidden" name="x-amz-server-side-encryption" value="AES256" /> 
    <input type="text"   name="X-Amz-Credential" value="AKIAIOSFODNN7EXAMPLE/20151229/us-east-1/s3/aws4_request" />
    <input type="text"   name="X-Amz-Algorithm" value="AWS4-HMAC-SHA256" />
    <input type="text"   name="X-Amz-Date" value="20151229T000000Z" />

    Tags for File: 
    <input type="input"  name="x-amz-meta-tag" value="" /><br />
    <input type="hidden" name="Policy" value='<Base64-encoded policy string>' />
    <input type="hidden" name="X-Amz-Signature" value="<signature-value>" />
    File: 
    <input type="file"   name="file" /> <br />
    <!-- The elements after this will be ignored -->
    <input type="submit" name="submit" value="Upload to Amazon S3" />
  </form>
  
</html>

Os parâmetros de postagem não diferenciam maiúsculas de minúsculas. Por exemplo, é possível especificar x-amz-signature ou X-Amz-Signature.