Nesta página, descrevemos algumas práticas recomendadas para definir sua Referrer-Policy e usar o referenciador em solicitações recebidas.
Resumo
- O vazamento inesperado de informações entre origens prejudica a privacidade dos usuários da Web. Uma política de referenciador de proteção pode ajudar.
- Considere definir uma política de referenciador de
strict-origin-when-cross-origin. Ela preserva a maior parte da utilidade do referenciador, ao mesmo tempo que reduz o risco de vazamento de dados entre origens. - Não use referenciadores para proteção contra falsificação de solicitações entre sites (CSRF, na sigla em inglês). Use tokens CSRF e outros cabeçalhos como uma camada extra de segurança.
Introdução ao Referer e à Referrer-Policy
As solicitações HTTP podem incluir um cabeçalho Referer opcional,
que indica a origem ou o URL da página da Web de onde a solicitação foi feita. O
cabeçalho Referrer-Policy
define quais dados são disponibilizados no cabeçalho Referer.
No exemplo a seguir, o cabeçalho Referer inclui o URL completo da página em site-one de onde a solicitação foi feita.
O cabeçalho Referer pode estar presente em diferentes tipos de solicitações:
- Solicitações de navegação, quando um usuário clica em um link.
- Solicitações de sub-recursos, quando um navegador solicita imagens, iframes, scripts e outros recursos necessários para uma página.
Para navegações e iframes, também é possível acessar esses dados com JavaScript usando
document.referrer.
Você pode aprender muito com os valores de Referer. Por exemplo, um serviço de análise
pode usá-los para determinar que 50% dos visitantes em site-two.example vieram
de social-network.example. No entanto, quando o URL completo, incluindo o caminho e a
string de consulta, é enviado no Referer entre origens, isso pode colocar em risco a privacidade
do usuário e criar riscos de segurança:
Os URLs de 1 a 5 contêm informações particulares e, às vezes, sensíveis ou dados pessoais. O vazamento silencioso dessas informações entre origens pode comprometer a privacidade dos usuários da Web.
O URL nº 6 é um URL de recurso. Se outra pessoa receber esse link, um usuário malicioso poderá assumir o controle da conta do usuário.
Para restringir quais dados de referenciador são disponibilizados para solicitações do seu site, defina uma política de referenciador.
Quais políticas estão disponíveis e como elas se diferenciam?
Você pode selecionar uma das oito políticas. Dependendo da política, os dados
disponíveis no cabeçalho Referer (e document.referrer) podem ser:
- Sem dados (não há cabeçalho
Referer) - Somente a origem
- O URL completo: origem, caminho e string de consulta
Algumas políticas são projetadas para se comportar de maneira diferente dependendo do contexto: solicitação entre origens ou de mesma origem, se o destino da solicitação é tão seguro quanto a origem ou ambos. Isso é útil para limitar a quantidade de informações compartilhadas entre origens ou com origens menos seguras, mantendo a riqueza do referenciador no seu próprio site.
A tabela a seguir mostra como as políticas de referenciador restringem os dados de URL disponíveis
no cabeçalho Referer e em document.referrer:
| Escopo da política | Nome da política | Referenciador: sem dados | Referer: Origin only | Referenciador: URL completo |
|---|---|---|---|---|
| Não considera o contexto da solicitação | no-referrer |
verificar | ||
origin |
verificar | |||
unsafe-url |
check | |||
| Foco em segurança | strict-origin |
Solicitação de HTTPS para HTTP | Solicitação de HTTPS para HTTPS ou de HTTP para HTTP |
|
no-referrer-when-downgrade |
Solicitação de HTTPS para HTTP | Solicitação de HTTPS para HTTPS ou de HTTP para HTTP |
||
| Foco na privacidade | origin-when-cross-origin |
Solicitação entre origens | Solicitação de mesma origem | |
same-origin |
Solicitação entre origens | Solicitação de mesma origem | ||
| Foco em privacidade e segurança | strict-origin-when-cross-origin |
Solicitação de HTTPS para HTTP | Solicitação entre origens de HTTPS para HTTPS ou HTTP para HTTP |
Solicitação de mesma origem |
A MDN fornece uma lista completa de políticas e exemplos de comportamento.
Confira alguns pontos que você precisa saber ao definir uma política de referenciador:
- Todas as políticas que consideram o esquema (HTTPS versus HTTP)
(
strict-origin,no-referrer-when-downgradeestrict-origin-when-cross-origin) tratam as solicitações de uma origem HTTP para outra origem HTTP da mesma forma que as solicitações de uma origem HTTPS para outra origem HTTPS, mesmo que o HTTP seja menos seguro. Isso ocorre porque, para essas políticas, o que importa é se ocorre um downgrade de segurança, ou seja, se a solicitação pode expor dados de uma origem criptografada para uma não criptografada, como em solicitações HTTPS → HTTP. Uma solicitação HTTP → HTTP é totalmente descriptografada, então não há downgrade. - Se uma solicitação for de mesma origem, isso significa que o esquema (HTTPS ou HTTP) é o mesmo, então não há downgrade de segurança.
Políticas de referenciador padrão em navegadores
A partir de outubro de 2021
Se nenhuma política de referenciador for definida, o navegador vai usar a política padrão.
| Navegador | Referrer-Policy padrão / Comportamento |
|---|---|
| Chrome |
O padrão é strict-origin-when-cross-origin.
|
| Firefox |
O padrão é strict-origin-when-cross-origin.A partir da versão 93, para usuários da Proteção Antirrastreamento Rigorosa e da Navegação Privada, as políticas de referenciador menos restritivas no-referrer-when-downgrade,
origin-when-cross-origin e unsafe-url são
ignoradas para solicitações entre sites, o que significa que o referenciador é sempre cortado
para solicitações entre sites, independentemente da política do site.
|
| Edge |
O padrão é strict-origin-when-cross-origin.
|
| Safari |
O padrão é semelhante a strict-origin-when-cross-origin,
com algumas diferenças específicas. Consulte
Como evitar o rastreamento de prevenção de rastreamento para mais detalhes.
|
Práticas recomendadas para definir a política de referenciador
Há diferentes maneiras de definir políticas de referenciador para seu site:
- Como um cabeçalho HTTP
- No seu HTML
- Do JavaScript por solicitação
É possível definir políticas diferentes para páginas, solicitações ou elementos distintos.
O cabeçalho HTTP e o elemento meta são no nível da página. A ordem de prioridade para determinar a política efetiva de um elemento é a seguinte:
- Política no nível do elemento
- Política no nível da página
- Padrão do navegador
Exemplo:
index.html:
<meta name="referrer" content="strict-origin-when-cross-origin" />
<img src="..." referrerpolicy="no-referrer-when-downgrade" />
A imagem é solicitada com uma política no-referrer-when-downgrade, e todas as outras
solicitações de sub-recursos dessa página seguem a política
strict-origin-when-cross-origin.
Como ver a política de referenciador?
O site securityheaders.com é útil para determinar qual política um site ou uma página específica está usando.
Também é possível usar as ferramentas para desenvolvedores no Chrome, Edge ou Firefox para ver a
política de referenciador usada em uma solicitação específica. No momento em que este artigo foi escrito, o Safari
não mostrava o cabeçalho Referrer-Policy, mas mostrava o Referer que foi
enviado.
Qual política você deve definir para seu site?
Recomendamos definir explicitamente uma política de melhoria de privacidade, como
strict-origin-when-cross-origin (ou mais rigorosa).
Por que "explicitamente"?
Se você não definir uma política de referenciador, a política padrão do navegador será usada. Na verdade, os sites geralmente seguem o padrão do navegador. Mas isso não é o ideal, porque:
- Navegadores diferentes têm políticas padrão diferentes. Portanto, se você depender dos padrões do navegador, seu site não se comportará de maneira previsível em todos os navegadores.
- Os navegadores estão adotando padrões mais rígidos, como
strict-origin-when-cross-origin, e mecanismos como remoção de referenciador para solicitações entre origens. Ativar explicitamente uma política de melhoria de privacidade antes que os padrões do navegador mudem dá controle a você e ajuda a realizar testes como achar melhor.
Por que strict-origin-when-cross-origin (ou mais rigoroso)?
Você precisa de uma política que seja segura, que melhore a privacidade e que seja útil. O que "útil" significa depende do que você quer do referenciador:
- Seguro: se o site usa HTTPS (se não, faça disso uma
prioridade), você não quer que os URLs do site vazem em
solicitações não HTTPS. Como qualquer pessoa na rede pode ver essas informações, os vazamentos
expõem os usuários a ataques de intermediários. As políticas
no-referrer-when-downgrade,strict-origin-when-cross-origin,no-referrerestrict-originresolvem esse problema. - Melhoria da privacidade: para uma solicitação entre origens,
no-referrer-when-downgradecompartilha o URL completo, o que pode causar problemas de privacidade.strict-origin-when-cross-originestrict-origincompartilham apenas a origem, eno-referrernão compartilha nada. Isso deixa você comstrict-origin-when-cross-origin,strict-origineno-referrercomo opções de melhoria da privacidade. - Útil:
no-referrerestrict-originnunca compartilham o URL completo, mesmo para solicitações de mesma origem. Se você precisar do URL completo,strict-origin-when-cross-originé uma opção melhor.
Tudo isso significa que o strict-origin-when-cross-origin geralmente é uma
escolha sensata.
Exemplo: como definir uma política strict-origin-when-cross-origin
index.html:
<meta name="referrer" content="strict-origin-when-cross-origin" />
Ou do lado do servidor, por exemplo, no Express:
const helmet = require('helmet');
app.use(helmet.referrerPolicy({policy: 'strict-origin-when-cross-origin'}));
E se o strict-origin-when-cross-origin (ou mais restrito) não acomodar todos os seus casos de uso?
Nesse caso, use uma abordagem progressiva: defina uma política de proteção como
strict-origin-when-cross-origin para seu site e, se necessário, uma política mais
permissiva para solicitações ou elementos HTML específicos.
Exemplo: política no nível do elemento
index.html:
<head>
<!-- document-level policy: strict-origin-when-cross-origin -->
<meta name="referrer" content="strict-origin-when-cross-origin" />
<head>
<body>
<!-- policy on this <a> element: no-referrer-when-downgrade -->
<a src="…" href="…" referrerpolicy="no-referrer-when-downgrade"></a>
<body></body>
</body>
</head>
</head>
O Safari/WebKit pode limitar o cabeçalho document.referrer ou Referer para solicitações entre sites.
Confira os detalhes.
Exemplo: política no nível da solicitação
script.js:
fetch(url, {referrerPolicy: 'no-referrer-when-downgrade'});
O que mais você precisa considerar?
Sua política deve depender do seu site e dos casos de uso, conforme determinado por você, sua equipe e sua empresa. Se alguns URLs contiverem dados de identificação ou sensíveis, defina uma política de proteção.
Práticas recomendadas para solicitações recebidas
Veja algumas diretrizes sobre o que fazer se o site usar o URL de referência de solicitações recebidas.
Proteger os dados dos usuários
O Referer pode conter dados particulares, pessoais ou de identificação. Por isso, trate-os
como tal.
Os referenciadores de entrada podem mudar {referer-can-change}
O uso do referenciador de solicitações entre origens recebidas tem algumas limitações:
- Se você não tiver controle sobre a implementação do emissor da solicitação, não será possível
fazer suposições sobre o cabeçalho
Referer(edocument.referrer) que você recebe. O emissor da solicitação pode decidir mudar para uma políticano-referrera qualquer momento ou, de modo mais geral, para uma política mais rígida do que a usada antes. Isso significa que você recebe menos dados doRefererdo que antes. - Os navegadores usam cada vez mais a Referrer-Policy
strict-origin-when-cross-originpor padrão. Isso significa que agora você pode receber apenas a origem, em vez de um URL de referenciador completo, em solicitações entre origens recebidas, se o site do remetente não tiver uma política definida. - Os navegadores podem mudar a forma como gerenciam o
Referer. Por exemplo, alguns desenvolvedores de navegadores podem decidir sempre cortar os referenciadores para origens em solicitações de sub-recursos entre origens, para proteger a privacidade do usuário. - O cabeçalho
Referer(edocument.referrer) pode conter mais dados do que você precisa. Por exemplo, ele pode ter um URL completo quando você só quer saber se a solicitação é entre origens.
Alternativas a Referer
Talvez seja necessário considerar alternativas se:
- Um recurso essencial do seu site usa o URL de referência de solicitações entre origens recebidas.
- Seu site não está mais recebendo a parte do URL de referência necessária em uma solicitação entre origens. Isso acontece quando o emissor da solicitação muda a política ou quando não há uma política definida e a política padrão do navegador é alterada (como no Chrome 85).
Para definir alternativas, primeiro analise qual parte do referenciador você está usando.
Se você só precisa da origem
- Se você estiver usando o referenciador em um script que tem acesso de nível superior à página,
window.location.originé uma alternativa. - Se disponíveis, cabeçalhos como
OrigineSec-Fetch-Sitefornecem oOriginou descrevem se a solicitação é entre origens, o que pode ser exatamente o que você precisa.
Se você precisar de outros elementos do URL (caminho, parâmetros de consulta etc.)
- Os parâmetros de solicitação podem atender ao seu caso de uso, o que evita o trabalho de analisar o referenciador.
- Se você estiver usando o referenciador em um script que tem acesso de nível superior à página,
window.location.pathnamepode funcionar como uma alternativa. Extraia apenas a seção de caminho do URL e transmita-a como um argumento para que as informações possivelmente sensíveis nos parâmetros de URL não sejam transmitidas.
Se não for possível usar essas alternativas:
- Verifique se é possível mudar seus sistemas para que o emissor da solicitação
(por exemplo,
site-one.example) defina explicitamente as informações necessárias em algum tipo de configuração.- Vantagem: mais explícito, que preserva a privacidade dos usuários do
site-one.example, mais preparado para o futuro. - Desvantagem: pode dar mais trabalho para você ou para os usuários do seu sistema.
- Vantagem: mais explícito, que preserva a privacidade dos usuários do
- Verifique se o site que emite as solicitações concorda em definir uma
Referrer-Policy por elemento ou por solicitação de
no-referrer-when-downgrade.- Desvantagem: pode preservar menos a privacidade dos usuários do
site-one.examplee não ser compatível com todos os navegadores.
- Desvantagem: pode preservar menos a privacidade dos usuários do
Proteção contra falsificação de solicitações entre sites (CSRF)
Um emissor de solicitação pode sempre decidir não enviar o referenciador definindo uma
política no-referrer, e um usuário malicioso pode até mesmo falsificar o referenciador.
Use tokens CSRF
como sua proteção principal. Para maior proteção, use
SameSite e,
em vez de Referer, use cabeçalhos como
Origin
(disponível em solicitações POST e CORS) e
Sec-Fetch-Site,
se disponível.
Registrar e depurar
Proteja os dados pessoais ou sensíveis dos usuários que possam estar no
Referer.
Se você estiver usando apenas a origem, verifique se é possível usar o cabeçalho Origin como alternativa. Isso pode fornecer as informações necessárias para fins de depuração
de uma maneira mais simples e sem precisar analisar o referenciador.
Pagamentos
Os provedores de pagamento podem usar o cabeçalho Referer das solicitações recebidas para
verificações de segurança.
Exemplo:
- O usuário clica em um botão Comprar no
online-shop.example/cart/checkout. online-shop.exampleredireciona parapayment-provider.examplepara gerenciar a transação.payment-provider.exampleverifica oRefererdessa solicitação em uma lista de valoresRefererpermitidos configurados pelos comerciantes. Se não corresponder a nenhuma entrada na lista, opayment-provider.examplerejeitará a solicitação. Se houver correspondência, o usuário poderá prosseguir com a transação.
Práticas recomendadas para verificações de segurança do fluxo de pagamento
Como provedor de pagamento, você pode usar o Referer como uma verificação básica contra alguns
ataques. No entanto, o cabeçalho Referer por si só não é uma base confiável para
uma verificação. O site solicitante, seja ele um comerciante legítimo ou não, pode definir uma política de no-referrer que torna as informações de Referer indisponíveis para o provedor de pagamento.
Analisar o Referer pode ajudar os provedores de pagamento a identificar invasores ingênuos que
não definiram uma política de no-referrer. Se você usar o Referer como uma primeira verificação:
- Não espere que o
Refereresteja sempre presente. Se estiver presente, verifique-o apenas com os dados mínimos que ele pode incluir, que é a origem.- Ao definir a lista de valores
Refererpermitidos, inclua apenas a origem e nenhum caminho. - Por exemplo, os valores permitidos de
Refererparaonline-shop.exampleprecisam seronline-shop.example, nãoonline-shop.example/cart/checkout. Ao não esperar nenhumRefererou um valorRefererque seja apenas a origem do site solicitante, você evita erros que podem surgir ao fazer suposições sobre oReferrer-Policydo comerciante.
- Ao definir a lista de valores
- Se o
Refererestiver ausente ou se estiver presente e a verificação básica de origem doRefererfor bem-sucedida, você poderá passar para outro método de verificação mais confiável.
Para verificar os pagamentos de forma mais confiável, permita que o solicitante gere um hash dos parâmetros de solicitação com uma chave exclusiva. Os provedores de pagamento podem calcular o mesmo hash do seu lado e só aceitar a solicitação se ela corresponder ao cálculo.
O que acontece com o Referer quando um site de comerciante HTTP sem política de referenciador
redireciona para um provedor de pagamento HTTPS?
Nenhum Referer fica visível na solicitação ao provedor de pagamento HTTPS, porque
a maioria dos navegadores usa strict-origin-when-cross-origin ou
no-referrer-when-downgrade por padrão quando um site não tem uma política definida.
A mudança do Chrome para uma nova política padrão
não vai alterar esse comportamento.
Conclusão
Uma política de referenciador protetora é uma ótima maneira de dar mais privacidade aos usuários.
Para saber mais sobre diferentes técnicas para proteger seus usuários, consulte nossa coleção Segurança e proteção.
Recursos
- Noções básicas sobre "mesmo site" e "mesma origem"
- Um novo cabeçalho de segurança: política de referenciador (2017)
- Política de referência na MDN
- Cabeçalho do referenciador: preocupações com privacidade e segurança no MDN
- Mudança no Chrome: intenção de implementação do Blink
- Mudança no Chrome: intenção de envio do Blink
- Mudança no Chrome: entrada de status
- Mudança no Chrome: postagem do blog sobre a versão Beta 85
- Thread do GitHub sobre remoção de referenciador: o que os diferentes navegadores fazem
- Especificação da política de referência
Agradecemos as contribuições e o feedback de todos os revisores, especialmente Kaustubha Govind, David Van Cleve, Mike West, Sam Dutton, Rowan Merewood, Jxck e Kayce Basques.