Autenticar solicitações usando a API REST - Amazon Simple Storage Service

Autenticar solicitações usando a API REST

Ao acessar o Amazon S3 usando REST, é necessário fornecer os seguintes itens na solicitação para que ela seja autenticada:

Elementos da solicitação
  • ID da chave de acesso da AWS: cada solicitação deve conter o ID da chave de acesso da identidade que você estiver usando para enviar a solicitação.

  • Assinatura: cada solicitação deve conter uma assinatura de solicitação válida. Caso contrário, a solicitação será rejeitada.

    A assinatura de uma solicitação é calculada com a chave de acesso secreta, um segredo compartilhado conhecido apenas por você e pela AWS.

  • Time stamp: cada solicitação deve conter a data e a hora de criação da solicitação, representada como uma string em UTC.

  • Data: cada solicitação deve conter o time stamp da solicitação.

    Dependendo da ação da API que você está usando, é possível fornecer uma data e hora de expiração para a solicitação em vez (ou além) do time stamp. Consulte o tópico de autenticação da respectiva ação para determinar o que é necessário.

Veja a seguir as etapas gerais para autenticar solicitações ao Amazon S3. Pressupõe-se que você tem as credenciais de segurança necessárias, o ID de chave de acesso e a chave de acesso secreta.

Diagrama que mostra as etapas gerais que você executa para autenticar solicitações ao Amazon S3.

1

Crie uma solicitação para a AWS.

2

Calcule a assinatura usando a chave de acesso secreta.

3

Envie a solicitação para o Amazon S3. Inclua o ID de chave de acesso e a assinatura na solicitação. O Amazon S3 executa as próximas três etapas.

Diagrama que mostra as etapas gerais que a AWS executa para autenticar solicitações ao Amazon S3.

4

O Amazon S3 usa o ID de chave de acesso para pesquisar a chave de acesso secreta.

5

O Amazon S3 calcula uma assinatura a partir dos dados da solicitação e da chave de acesso secreta usando o mesmo algoritmo usado para calcular a assinatura enviada na solicitação.

6

Se a assinatura gerada pelo Amazon S3 corresponder à enviada na solicitação, ela será considerada autêntica. Se a houver falha na comparação, a solicitação será descartada e o Amazon S3 retornará uma resposta de erro.

Informações de autenticação detalhadas

Para obter informações detalhadas sobre a autenticação REST, consulte Assinar e autenticar as solicitações REST.