CDN:Assinatura do Tipo F

Como funciona

• Formato da URL assinada

  Uma URL assinada segue o formato abaixo:

  http://DomainName/FileName?{sign=<md5hash>&time=<timestamp>}

  Nota

  O conteúdo em {} representa os parâmetros de autenticação anexados à URL padrão.

  Os nomes dos parâmetros sign e time são os valores padrão. É possível personalizar o Signature Parameter e o Timestamp Parameter no console de Configurar assinatura de URL.

• Parâmetro	Descrição
  DomainName	Nome de domínio acelerado pelo CDN.
  PrivateKey	Chave criptográfica personalizada de 16 a 32 caracteres, composta por letras maiúsculas, letras minúsculas e dígitos.
  FileName	Caminho do recurso para a solicitação back-to-origin. Deve começar com uma barra (/).
  timestamp	Momento em que o servidor de assinatura gera a URL assinada. Em conjunto com o período de validade, esse valor define quando a URL assinada expira. O horário é um timestamp UNIX — o número de segundos decorridos desde 00:00:00 UTC em 1º de janeiro de 1970. Trata-se de um inteiro decimal positivo de 10 dígitos, independente de fusos horários. No console Configurar assinatura de URL, defina o formato do timestamp como decimal (timestamp UNIX) ou hexadecimal (timestamp UNIX). Nota Configure o TTL no console Configurar assinatura de URL. A URL assinada expira em timestamp + o período de validade configurado.
  md5hash	String de 32 caracteres gerada pelo algoritmo MD5. Contém os dígitos de 0 a 9 e as letras minúsculas de a a z. O valor md5hash é gerado a partir da seguinte string de assinatura: sstring = "Privatekey+URI+timestamp" (onde URI é o caminho relativo do objeto solicitado, como /Filename, e não inclui parâmetros de consulta) md5hash = md5sum(sstring)

• Lógica de autenticação

  Ao receber uma solicitação, um nó de borda do CDNDCDN verifica primeiramente se timestamp + validity period já expirou.

  • Caso timestamp + validity period seja anterior ao horário atual, a solicitação expirou. O servidor retorna um erro HTTP 403.

  • Se timestamp + validity period for posterior ao horário atual, o servidor constrói uma string de assinatura no formato sstring, calcula seu valor MD5 e compara o resultado com o valor md5hash presente na solicitação.

    • Quando os valores correspondem, a autenticação é bem-sucedida e o recurso solicitado é retornado.

      Nota

      Após a autenticação bem-sucedida, o nó de borda remove os parâmetros de autenticação da URL para aumentar a taxa de acerto de cache e reduzir o tráfego back-to-origin. Por exemplo:

      • URL com parâmetros de assinatura: http://DomainName/FileName?{sign=<md5hash>&time=<timestamp>}

      • Após a autenticação:

        • URL usada para gerar a chave de cache: http://DomainName/FileName

        • URL para a solicitação back-to-origin: http://DomainName/FileName

    • Se os valores não corresponderem, a autenticação falha e o servidor retorna um erro HTTP 403.

Exemplo

Quando um cliente solicita um recurso com uma URL assinada, a autenticação é bem-sucedida se o valor md5hash calculado pelo servidor CDNDCDN corresponder ao valor md5hash na solicitação — por exemplo, a37fa50a5fb8f71214b1e7c95ec7a1bd — e a URL não tiver expirado. Caso contrário, a autenticação falha.