Cabeçalhos de Requisição Personalizados

Visão geral

Os cabeçalhos de requisição personalizados permitem anexar seus próprios cabeçalhos HTTP a cada requisição que o cside faz ao seu servidor de origem. Isso facilita identificar, autenticar ou filtrar o tráfego do cside no seu backend.

Quando o cside busca seus scripts, os cabeçalhos personalizados que você configura são automaticamente incluídos na requisição HTTP de saída para a sua origem.

Casos de uso

Identificar tráfego do cside: Adicione um cabeçalho como X-Request-Source: cside para que seu backend possa distinguir as requisições do cside do tráfego regular de usuários
Autenticação: Inclua um token de autorização para que sua origem possa verificar que a requisição vem do cside
Filtragem e registro: Marque as requisições com um identificador personalizado para facilitar a filtragem de logs e análises
Regras de WAF / firewall: Permita as requisições do cside fazendo correspondência com um valor de cabeçalho conhecido

Configurar cabeçalhos personalizados

Navegue até as configurações do seu domínio no painel do cside e role até a seção Custom Request Headers.

Adicionar um cabeçalho

Insira o nome do cabeçalho no campo Header name (ex.: X-Request-Id)
Insira o valor do cabeçalho no campo Value (ex.: my-value)
Para adicionar cabeçalhos adicionais, clique em + Add header
Clique em Save request headers para aplicar suas alterações

Nota

As alterações nos cabeçalhos personalizados entram em vigor em poucos minutos à medida que a configuração é atualizada em todas as regiões edge.

Remover um cabeçalho

Para remover um cabeçalho, clique no botão de remover ao lado da linha do cabeçalho que deseja excluir e depois clique em Save request headers.

Como funciona

Quando o cside faz uma requisição ao seu servidor de origem para buscar o conteúdo do script, qualquer cabeçalho personalizado que você tenha configurado é injetado na requisição HTTP de saída. Seu servidor de origem recebe esses cabeçalhos junto com os cabeçalhos de requisição padrão.

Exemplo: Se você configurar um cabeçalho X-Cside-Token com o valor abc123, sua origem receberá requisições como:

GET /your-script.js HTTP/1.1
Host: yourdomain.com
X-Cside-Token: abc123

Você pode então usar este cabeçalho na configuração do seu servidor para identificar ou autorizar requisições do cside. Por exemplo, no NGINX:

location /scripts/ {
    if ($http_x_cside_token = "abc123") {
        # A requisição vem do cside
    }
}

Permissões

Gerenciar cabeçalhos de requisição personalizados requer a permissão Manage Domains na sua equipe. Entre em contato com o administrador da sua equipe se você não tiver acesso a esta configuração.