Crie uma solicitação assinada de API da AWS

• HTTPMethod: o método HTTP, como GET, PUT, HEAD e DELETE.

• CanonicalUri: a versão codificada em URI do componente de caminho absoluto do URI, começando com o código / que segue o nome do domínio e indo até o final da string ou até o caractere de ponto de interrogação (?) se você tiver parâmetros de string de consulta. Se o caminho absoluto estiver vazio, use um caractere de barra inclinada (/). O URI no exemplo a seguir, /amzn-s3-demo-bucket/myphoto.jpg, é o caminho absoluto, e você não codifica o / no caminho absoluto:

  http://s3.amazonaws.com/amzn-s3-demo-bucket/myphoto.jpg

• CanonicalQueryString: os parâmetros da string de consulta codificados por URI. Codifique por URI cada nome e valor individualmente. Também é necessário classificar os parâmetros na string de consulta canônica em ordem alfabética pelo nome da chave. A classificação ocorre após a codificação. A string de consulta no seguinte exemplo de URI é:

  http://s3.amazonaws.com/amzn-s3-demo-bucket?prefix=somePrefix&marker=someMarker&max-keys=2

  A string de consulta canônica é como este exemplo (quebras de linha foram adicionadas ao exemplo para facilitar a leitura):

  UriEncode("marker")+"="+UriEncode("someMarker")+"&"+
  UriEncode("max-keys")+"="+UriEncode("20") + "&" +
  UriEncode("prefix")+"="+UriEncode("somePrefix")

  Quando uma solicitação se destina a um sub-recurso, o valor do parâmetro de consulta correspondente é uma string vazia (""). Por exemplo, o URI a seguir identifica o sub-recurso ACL no bucket amzn-s3-demo-bucket:

  http://s3.amazonaws.com/amzn-s3-demo-bucket?acl

  Nesse caso, a CanonicalQueryString seria:

  UriEncode("acl") + "=" + ""

  Caso o URI não contenha um ?, não há strings de consulta na solicitação, e você define a string de consulta canônica como uma string vazia (""). Você ainda precisará incluir o caractere de linha nova ("\n").

• CanonicalHeaders: uma lista de cabeçalhos de solicitação com os respectivos valores. Os pares individuais de nome e valor do cabeçalho são separados pelo caractere de linha nova ("\n"). Veja a seguir um exemplo de um CanonicalHeader:

  Lowercase(<HeaderName1>)+":"+Trim(<value>)+"\n"
  Lowercase(<HeaderName2>)+":"+Trim(<value>)+"\n"
  ...
  Lowercase(<HeaderNameN>)+":"+Trim(<value>)+"\n"

  A lista CanonicalHeaders deve conter:

  • Cabeçalho HTTP host

  • Se o cabeçalho Content-Type estiver presente na solicitação, você deverá adicioná-lo à lista CanonicalHeaders.

  • Também deverão ser adicionados todos os cabeçalhos x-amz-* que você pretende incluir na solicitação. Por exemplo, se você estiver usando credenciais de segurança temporárias, precisará incluir o x-amz-security-token na solicitação. É necessário adicionar esse cabeçalho à lista de CanonicalHeaders.

  • Para SigV4a, você deve incluir um cabeçalho de conjunto de regiões que especifique o conjunto de regiões em que a solicitação será válida. O cabeçalho X-Amz-Region-Set é especificado como uma lista de valores separados por vírgula. O exemplo a seguir mostra um cabeçalho de região que permite fazer uma solicitação nas regiões us-east-1 e us-west-1.

    X-Amz-Region-Set=us-east-1,us-west-1

    Você pode usar curingas (*) em regiões para especificar várias regiões. No exemplo a seguir, o cabeçalho permite que uma solicitação seja feita tanto na região us-west-1 quanto na us-west-2.

    X-Amz-Region-Set=us-west-*

  nota

  O cabeçalho x-amz-content-sha256 é obrigatório para solicitações da AWS do Amazon S3. Ele fornece um hash da carga da solicitação. Se não houver carga útil, será necessário fornecer o hash de uma string vazia.

  Todo nome de cabeçalho deve:

  • usar caracteres minúsculos.

  • ser exibido em ordem alfabética.

  • ser seguido por dois pontos (:).

  Para valores, é necessário:

  • remover todos os espaços à esquerda ou à direita.

  • converter espaços sequenciais em um espaço único.

  • separar os valores de um cabeçalho de múltiplos valores usando vírgulas.

  • É necessário incluir na assinatura o cabeçalho host (HTTP/1.1) ou o cabeçalho :authority (HTTP/2) e quaisquer cabeçalhos x-amz-*. Opcionalmente, você pode incluir outros cabeçalhos padrão na assinatura, como content-type.

  As funções Lowercase() e Trim() usadas neste exemplo estão descritas na seção anterior.

  Veja a seguir um exemplo de string CanonicalHeaders. O nomes dos cabeçalhos estão em letras minúsculas e são classificados.

  host:s3.amazonaws.com
  x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
  x-amz-date:20130708T220855Z

  nota

  Para fins de cálculo de uma assinatura de autorização, somente o host e cabeçalhos x-amz-* são obrigatórios; no entanto, para evitar a adulteração de dados, considere incluir os cabeçalhos adicionais no cálculo da assinatura.

  Não inclua cabeçalhos hop-by-hop que são alterados com frequência durante o trânsito em um sistema complexo. Isso inclui todos os cabeçalhos de transporte voláteis que são alterados por proxies, balanceadores de carga e nós em um sistema distribuído, incluindo connection, x-amzn-trace-id, user-agent, keep-alive, transfer-encoding, TE, trailer, upgrade, proxy-authorization e proxy-authenticate.

• SignedHeaders: uma lista ordenada alfabeticamente, separada por ponto e vírgula, de nomes de cabeçalhos de solicitação em letras minúsculas. Os cabeçalhos de solicitação da lista são os mesmos cabeçalhos que você incluiu na string CanonicalHeaders. Para o exemplo anterior, o valor de SignedHeaders seria:

  host;x-amz-content-sha256;x-amz-date

• HashedPayload: uma string criada usando a carga útil no corpo da solicitação HTTP como entrada para uma função de hash. Esta string usa caracteres hexadecimais minúsculos.

  Hex(SHA256Hash(<payload>>))

  Se não houver carga útil na solicitação, calcule um hash da string vazia. Por exemplo, ao recuperar um objeto usando uma solicitação GET, não haverá nada na carga útil.

  Hex(SHA256Hash(""))

  nota

  Para o Amazon S3, inclua a string literal UNSIGNED-PAYLOAD ao construir uma solicitação canônica e defina o mesmo valor como o cabeçalho x-amz-content-sha256 ao enviar a solicitação.

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm: o algoritmo usado para criar o hash da solicitação canônica.

  • SigV4: use AWS4-HMAC-SHA256 para especificar o algoritmo de hash HMAC-SHA256.

  • SigV4a: use AWS4-ECDSA-P256-SHA256 para especificar o algoritmo de hash ECDSA-P256-SHA-256.

• RequestDateTime: a data e a hora usadas no escopo da credencial. Esse valor é a hora UTC atual no formato ISO 8601 (por exemplo, 20130524T000000Z).

• CredentialScope: o escopo de credencial, que restringe a assinatura resultante à região e ao serviço especificados.

  • SigV4: as credenciais incluem o ID da chave de acesso, a data no formato YYYYMMDD, o código da região, o código do serviço e a string aws4_request de término separados por barras (/). O código da região, o código do serviço e a string de término devem usar caracteres minúsculos. A string tem o seguinte formato: YYYYMMDD/region/service/aws4_request.

  • SigV4a: as credenciais incluem a data no formato YYYYMMDD, o nome do serviço e a string aws4_request de término separados por barras (/). Observe que o escopo da credencial não inclui a região, pois ela é englobada em um cabeçalho X-Amz-Region-Set separado. A string tem o seguinte formato: YYYYMMDD/service/aws4_request.

• HashedCanonicalRequest: o hash da solicitação canônica, calculada na etapa anterior.

Entrada obrigatória

• Key: uma string que contém sua chave de acesso secreta.

• Date: uma string que contém a data usada no escopo da credencial, no formato AAAAMMDD.

• Region: uma string que contém o código da região (por exemplo, us-east-1).

  Para obter uma lista de regiões de strings, consulte Regional endpoints, na Referência geral da AWS.

• Service: uma string que contém o código do serviço (por exemplo, ec2).

• A string para assinar que você criou na etapa anterior.