Edge Security Acceleration:Configurar a assinatura de URL

Como funciona a assinatura de URL

1. Os clientes da CDNDCDN configuram as regras de geração de URLs assinadas (incluindo um algoritmo de assinatura e uma chave) no servidor de aplicação de origem.

   Por exemplo, uma URL assinada pode ter o formato http://DomainName/timestamp/md5hash/FileName.

2. Quando um cliente visita uma página na sua aplicação, o servidor de aplicação de origem gera uma URL assinada com base nas regras configuradas e a insere na página retornada ao cliente.

3. O cliente usa a URL assinada para solicitar o recurso de um POP da CDNDCDN.

4. O POP da CDNDCDN valida as informações na URL assinada, como a string de assinatura e o carimbo de data e hora, para determinar se a requisição é legítima.

   • Se a autenticação falhar, o POP nega a requisição.

   • Se a autenticação for bem-sucedida, o POP fornece o conteúdo.

     Nota

     • Se um nó da CDNDCDN não possui o recurso em cache, o nó remove os parâmetros de autenticação da URL assinada e a restaura para a URL original (por exemplo, http://DomainName/FileName) e, em seguida, usa a URL original para gerar uma chave de cache ou iniciar uma requisição de busca na origem.

     • Após autenticar a URL da requisição, a CDNDCDN codifica quaisquer caracteres especiais na URL, como caracteres chineses ou outros não ASCII.

Notas de uso

Assinatura de URL para atualização e pré-busca — Por favor, envie uma URL de atualização ou pré-busca que corresponda à chave de cache real. Para um domínio com assinatura de URL configurada, envie a URL original sem os parâmetros de autenticação (domínio acelerado + caminho do arquivo) e mantenha os parâmetros de consulta de negócio. Se o valor de um parâmetro de consulta de negócio contiver /, codifique esse caractere como %2F antes do envio. Não envie uma URL de acesso do cliente que contenha parâmetros de autenticação. Essa URL pode diferir da chave de cache real e não corresponder ao recurso em cache de destino. Prepare e envie a URL usando as regras e exemplos em the refresh and prefetch resource guide.

Configure e ative a assinatura de URL

1. Faça login no console do DCDN.

2. No painel de navegação à esquerda, clique em Domain Names.

3. Na página Domain Names, encontre o domínio de destino e clique em Configure.

4. Na árvore de navegação à esquerda do domínio, clique em Access Control.

5. Clique na guia URL Signing.

6. Por favor, ative o seletor URL Authentication Setting.

7. Na caixa de diálogo URL Signing, configure os parâmetros de assinatura de URL.

   

   Parâmetro	Descrição
   Authentication Type	Por favor, selecione o tipo de autenticação que corresponda ao formato de URL assinada do seu servidor de origem. Type A signing Type B signing Type C signing Nota Se a assinatura de URL falhar, um erro 403 é retornado: Erro de cálculo MD5 Exemplo: X-Tengine-Error:denied by req auth: invalid md5hash=de7bfdc915ced05e17380a149bd760be Erro relacionado ao tempo Exemplo: X-Tengine-Error:denied by req auth: expired timestamp=1439469547
   Primary Key	Por favor, insira a chave primária. Deve ter entre 16 e 128 caracteres e pode conter letras e dígitos. Não pode conter espaços ou cifrões ($).
   Secondary Key	Por favor, insira a chave secundária. Deve ter entre 16 e 128 caracteres e pode conter letras e dígitos. Não pode conter espaços ou cifrões ($). Pelo menos uma chave é obrigatória.
   Validity period	Uma URL assinada permanece válida de timestamp até timestamp + validity period. As requisições fora dessa janela são rejeitadas. Unidade: segundos Faixa de valores: 1 a 31.536.000 Valor padrão: 1800 (30 minutos) Exemplo: Uma URL assinada com timestamp 2020-08-15 15:00:00 (UTC+8) e um período de validade de 1800 segundos expira em 2020-08-15 15:30:00 (UTC+8).

8. Clique em OK.

Verifique a URL assinada

Primeiro, ative a assinatura de URL. Em seguida, gere uma URL de teste no console do DCDN e verifique a lógica de assinatura.

1. Na seção Generate Encrypted URL for Testing, especifique a Original URL e as informações de autenticação.

   

   Parâmetro	Descrição
   Original URL	Insira a url original. Exemplo: https://www.aliyun.com.
   Authentication Type	Por favor, selecione o tipo de autenticação configurado em Configure e ative a assinatura de URL.
   Authentication Key	Por favor, insira a Primary Key ou a Secondary Key de Configure e ative a assinatura de URL.
   Validity Period	Por favor, insira o período de validade em segundos. Deve corresponder ao valor em Configure e ative a assinatura de URL.

2. Clique em Generate para obter a Authentication URL e o Timestamp.

   

Desativar a assinatura de URL

1. No console do DCDN, acesse a seção URL Authentication Setting e desative o seletor de assinatura de URL.

2. No servidor de origem, remova a lógica que adiciona parâmetros de autenticação às URLs.

APIs relacionadas

• DescribeDcdnDomainConfigs

• Functions for domain name configuration