Os cabeçalhos de resposta de saída são um dos componentes dos cabeçalhos de mensagem de resposta http. Eles podem transportar parâmetros de resposta específicos e transmiti-los aos clientes, além de serem usados para controlar vários tipos de comportamento do cliente, como comportamento de cache, acesso entre origens, tipos de conteúdo e métodos de baixe. Ao modifique os cabeçalhos de resposta de saída, quando os usuários solicitam recursos em um nome de domínio acelerado, a mensagem de resposta retornada pela CDN DCDN inclui os cabeçalhos de resposta que você configure, o que permite ativar recursos específicos, como o acesso entre origens.
Nota: Quando este recurso referencia condições de regra do Rules Engine, a ordem de execução segue a ordem de prioridade das condições de regra configuradas no Rules Engine, e NÃO a ordem de prioridade da própria configuração deste recurso.
Como funciona
Os cabeçalhos de resposta http controlam o comportamento de cache. Quando um cliente solicita um recurso de um POP, os cabeçalhos retornados determinam como tanto o cliente quanto o POP armazenam a resposta em cache.
A configuração de cabeçalho de resposta http é uma configuração no nível do domínio. Depois que a configuração entra em vigor, ela se aplica às mensagens de resposta de todos os recursos no domínio.
configure cabeçalhos de resposta http afeta apenas o comportamento de resposta do cliente (por exemplo, um navegador) e não afeta o comportamento de cache dos nós da CDN DCDN. Se o nome de domínio acelerado for um domínio curinga, a modificação de cabeçalhos de resposta de saída não é suportada.
Cenários
especifique tipos de recurso. Por exemplo, adicione o cabeçalho
Content-Type: text/htmlpara indicar uma resposta HTML.-
Ativar o compartilhamento de recursos de origem cruzada (CORS): Adicione o cabeçalho Access-Control-Allow-Origin às respostas de nomes de domínio acelerados pela DCDN. Para obter mais informações, consulte Configure cross-origin resource sharing.
A DCDN também oferece suporte à autenticação em solicitações de origem cruzada por meio de regras CORS personalizadas.
Personalizar o comportamento de resposta: Adicione ou modifique cabeçalhos para implementar recursos específicos ou ajustar o conteúdo da resposta com base nos requisitos do negócio.
Observações
-
Várias configurações são executadas de cima para baixo na ordem em que aparecem na lista de configurações. Os efeitos são cumulativos. Se várias configurações modificarem o mesmo cabeçalho, a última terá precedência. No exemplo a seguir, a Configuração 2 é a que entra em vigor:
Configuração 1: Adicionar o cabeçalho de resposta http:
cache-control: max-age=3600Configuração 2: Adicionar o cabeçalho de resposta http:
cache-control: no-cache
Quando as condições de regra são aplicadas, a correspondência é determinada pela prioridade das condições, e não pela ordem das configurações.
Procedimento
Faça logon no console do DCDN.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, encontre o nome de domínio de destino e clique em Configure.
Na árvore de navegação à esquerda do nome de domínio, clique em Caching.
-
Na guia Custom Outgoing Response Header, clique em Add. Em seguida, configure os seguintes parâmetros.
Parâmetro
Descrição
Operation
Adicione, exclua, altere ou substitua cabeçalhos de resposta.
Response Header
Selecione um cabeçalho de resposta. Para obter mais informações, consulte Response headers.
Description
Descrição do cabeçalho http selecionado.
Response Header Name
Se você definir Response Header como Custom Header, será necessário especifique um nome de cabeçalho:
O nome deve conter letras, dígitos e hifens (-).
O nome deve ter de 1 a 100 caracteres.
Header Value
O valor do cabeçalho de resposta. Para obter mais informações, consulte Response headers.
Allow Duplicates
Yes: Tanto o cabeçalho do servidor de origem quanto o cabeçalho configurado são retornados ao cliente.
No: O cabeçalho configurado substitui o cabeçalho do servidor de origem.
Rule Condition
Uma condição de regra identifica várias informações de parâmetros em uma solicitação de usuário. Isso determina se uma configuração entra em vigor para essa solicitação.
Do not use: Não usa uma condição de regra.
Para adicionar ou edite condições de regra, gerencie-as em Rules Engine.
CORS
Desativado por padrão. Disponível apenas quando Operation está defina como Add e Response Header está defina como Access-Control-Allow-Origin.
Enable: Os POPs verifique o cabeçalho Origin nas solicitações e definem Access-Control-Allow-Origin com base nas regras CORS.
Disable: Os POPs ignoram o verifique do cabeçalho Origin e retornam o valor Access-Control-Allow-Origin configurado.
-
clique em OK.
Na lista de cabeçalhos de resposta, clique em Modify ou Delete para modifique ou exclua um cabeçalho.
Regras CORS
As configurações Allow Duplicates e CORS são mutuamente exclusivas. defina Allow Duplicates como Yes invalida Yes.
Correspondência curinga: Se Access-Control-Allow-Origin estiver defina como , a resposta sempre retornará Access-Control-Allow-Origin:, independentemente do valor do cabeçalho Origin.
-
Correspondência exata: especifique um ou mais valores para Access-Control-Allow-Origin, separados por vírgulas (,).
Se o cabeçalho Origin corresponder a um valor especificado, a origem correspondente será retornada na resposta.
Se nenhuma correspondência for encontrada, Access-Control-Allow-Origin não será retornado.
Correspondência de domínio curinga: Se Access-Control-Allow-Origin estiver defina como um domínio curinga, o cabeçalho Origin será comparado a ele.
Para obter mais informações, consulte Configure cross-origin resource sharing.
Cabeçalhos de resposta
Cabeçalho de resposta | Descrição | Exemplo |
Cabeçalho personalizado | crie um cabeçalho de resposta personalizado com as seguintes regras:
| Test-Header |
Content-Type | Especifica o tipo de conteúdo retornado ao cliente. | text/html |
Cache-Control | Especifica a política de cache para solicitações e respostas. | no-cache |
Content-Disposition | Nome de arquivo padrão quando a resposta é salva como um arquivo. | examplefile.txt |
Content-Language | Especifica o idioma do público-alvo. | en-US |
Expires | Especifica quando a resposta expira. | Wed, 21 Oct 2015 07:28:00 GMT |
Pragma | Um cabeçalho específico de implementação http/1.0 compatível com http/1.1. Os efeitos variam ao longo da cadeia de solicitação-resposta. | no-cache |
Access-Control-Allow-Origin | Especifica as origens permitidas para solicitações de origem cruzada. Use * para permitir todas as origens ou insira domínios específicos, como Nota
|
|
Access-Control-Allow-Methods | Especifica os métodos de solicitação permitidos para solicitações de origem cruzada. Separe vários métodos com vírgulas (,). | POST,GET |
Access-Control-Allow-Headers | Especifica os campos de cabeçalho permitidos para solicitações de origem cruzada. | X-Custom-Header |
Access-Control-Max-Age | Especifica por quanto tempo os resultados de uma solicitação de preflight podem ser armazenados em cache. Unidade: segundos. | 600 |
Access-Control-Expose-Headers | Especifica os cabeçalhos expostos ao cliente na resposta. | Content-Length |
Access-Control-Request-Method | Indica o método http usado na solicitação real. Enviado pelos navegadores durante as solicitações de preflight. | POST |
Access-Control-Request-Headers | Indica os cabeçalhos http usados na solicitação real. Enviado pelos navegadores durante as solicitações de preflight. | X-PINGOTHER |
Access-Control-Allow-Credentials | Especifica se as solicitações CORS podem incluir credenciais.
| true |