En esta página, se describen algunas prácticas recomendadas para configurar tu Referrer-Policy y usar el referente en las solicitudes entrantes.
Resumen
- La filtración inesperada de información de origen cruzado daña la privacidad de los usuarios web. Una política de referencia de protección puede ayudar.
- Considera establecer una política de referencia de
strict-origin-when-cross-origin. Conserva la mayor parte de la utilidad de la referencia y, al mismo tiempo, mitiga el riesgo de que se filtren datos de origen cruzado. - No uses referencias para la protección contra la falsificación de solicitudes entre sitios (CSRF). En su lugar, usa tokens de CSRF y otros encabezados como una capa adicional de seguridad.
Introducción a Referer y Referrer-Policy
Las solicitudes HTTP pueden incluir un encabezado Referer opcional,
que indica el origen o la URL de la página web desde la que se realizó la solicitud. El encabezado Referrer-Policy define qué datos están disponibles en el encabezado Referer.
En el siguiente ejemplo, el encabezado Referer incluye la URL completa de la
página en site-one desde la que se realizó la solicitud.
El encabezado Referer puede estar presente en diferentes tipos de solicitudes:
- Solicitudes de navegación, cuando un usuario hace clic en un vínculo
- Solicitudes de recursos secundarios, cuando un navegador solicita imágenes, iframes, secuencias de comandos y otros recursos que necesita una página.
En el caso de las navegaciones y los iframes, también puedes acceder a estos datos con JavaScript usando
document.referrer.
Puedes aprender mucho de los valores de Referer. Por ejemplo, un servicio de estadísticas
podría usarlos para determinar que el 50% de los visitantes de site-two.example provienen
de social-network.example. Sin embargo, cuando la URL completa, incluidas la ruta de acceso y la cadena de consulta, se envía en el encabezado Referer entre orígenes, puede poner en peligro la privacidad del usuario y crear riesgos de seguridad:
Las URLs de la 1 a la 5 contienen información privada y, a veces, información sensible o de identificación. Filtrar estos datos de forma silenciosa entre orígenes puede comprometer la privacidad de los usuarios web.
La URL n.º 6 es una URL de capacidad. Si alguien que no sea el usuario previsto recibe este mensaje, un agente malicioso puede tomar el control de la cuenta de este usuario.
Para restringir qué datos de referencia están disponibles para las solicitudes de tu sitio, puedes establecer una política de referencia.
¿Qué políticas están disponibles y en qué se diferencian?
Puedes seleccionar una de las ocho políticas. Según la política, los datos
disponibles en el encabezado Referer (y document.referrer) pueden ser los siguientes:
- No hay datos (no hay un encabezado
Refererpresente) - Solo el origen
- La URL completa: origen, ruta y cadena de consulta
Algunas políticas están diseñadas para comportarse de manera diferente según el contexto: solicitud de origen cruzado o del mismo origen, si el destino de la solicitud es tan seguro como el origen, o ambos. Esto es útil para limitar la cantidad de información que se comparte entre orígenes o con orígenes menos seguros, a la vez que se mantiene la riqueza de la referencia dentro de tu propio sitio.
En la siguiente tabla, se muestra cómo las políticas de referencia restringen los datos de URL disponibles
en el encabezado Referer y document.referrer:
| Alcance de la política | Nombre de la política | Referencia: Sin datos | Referer: Origin only | Referencia: URL completa |
|---|---|---|---|---|
| No tiene en cuenta el contexto de la solicitud | no-referrer |
check | ||
origin |
check | |||
unsafe-url |
check | |||
| Enfocada en la seguridad | strict-origin |
Solicitud de HTTPS a HTTP | Solicitud de HTTPS a HTTPS o de HTTP a HTTP |
|
no-referrer-when-downgrade |
Solicitud de HTTPS a HTTP | Solicitud de HTTPS a HTTPS o de HTTP a HTTP |
||
| Centrado en la privacidad | origin-when-cross-origin |
Solicitud de origen cruzado | Solicitud del mismo origen | |
same-origin |
Solicitud de origen cruzado | Solicitud del mismo origen | ||
| Enfoque en la privacidad y la seguridad | strict-origin-when-cross-origin |
Solicitud de HTTPS a HTTP | Solicitud de origen cruzado de HTTPS a HTTPS o de HTTP a HTTP |
Solicitud del mismo origen |
MDN proporciona una lista completa de políticas y ejemplos de comportamiento.
A continuación, se mencionan algunos aspectos que debes tener en cuenta cuando configures una política de referencia:
- Todas las políticas que tienen en cuenta el esquema (HTTPS frente a HTTP)
(
strict-origin,no-referrer-when-downgradeystrict-origin-when-cross-origin) tratan las solicitudes de un origen HTTP a otro origen HTTP de la misma manera que las solicitudes de un origen HTTPS a otro origen HTTPS, aunque HTTP es menos seguro. Esto se debe a que, para estas políticas, lo que importa es si se produce una baja de seguridad, es decir, si la solicitud puede exponer datos de un origen encriptado a uno no encriptado, como en las solicitudes HTTPS → HTTP. Una solicitud HTTP → HTTP no está encriptada, por lo que no hay una versión anterior. - Si una solicitud es de mismo origen, significa que el esquema (HTTPS o HTTP) es el mismo, por lo que no hay una disminución de la seguridad.
Políticas de referente predeterminadas en los navegadores
A partir de octubre de 2021
Si no se establece ninguna política de referencia, el navegador usa su política predeterminada.
| Navegador | Referrer-Policy/comportamiento predeterminado |
|---|---|
| Chrome |
El valor predeterminado es strict-origin-when-cross-origin.
|
| Firefox |
El valor predeterminado es strict-origin-when-cross-origin.A partir de la versión 93, para los usuarios de la protección contra seguimiento estricta y la navegación privada, las políticas de referencia menos restrictivas no-referrer-when-downgrade,
origin-when-cross-origin y unsafe-url se
ignoran para las solicitudes entre sitios, lo que significa que la referencia siempre se recorta
para las solicitudes entre sitios, independientemente de la política del sitio web.
|
| Edge |
El valor predeterminado es strict-origin-when-cross-origin.
|
| Safari |
El valor predeterminado es similar a strict-origin-when-cross-origin,
con algunas diferencias específicas. Consulta
Cómo evitar el seguimiento de la prevención de seguimiento para obtener más detalles.
|
Prácticas recomendadas para configurar la política de referencia
Existen diferentes formas de establecer políticas de referencia para tu sitio:
- Como un encabezado HTTP
- En tu HTML
- Desde JavaScript por solicitud
Puedes establecer diferentes políticas para distintas páginas, solicitudes o elementos.
Tanto el encabezado HTTP como el elemento meta se encuentran a nivel de la página. El orden de prioridad para determinar la política vigente de un elemento es el siguiente:
- Política a nivel del elemento
- Política a nivel de la página
- Configuración predeterminada del navegador
Ejemplo:
index.html:
<meta name="referrer" content="strict-origin-when-cross-origin" />
<img src="..." referrerpolicy="no-referrer-when-downgrade" />
La imagen se solicita con una política no-referrer-when-downgrade, y todas las demás
solicitudes de recursos secundarios de esta página siguen la política
strict-origin-when-cross-origin.
¿Cómo ver la política de referencia?
securityheaders.com es útil para determinar qué política usa un sitio o una página específicos.
También puedes usar las herramientas para desarrolladores en Chrome, Edge o Firefox para ver la
política de referencia que se usa para una solicitud específica. En el momento de escribir este artículo, Safari
no muestra el encabezado Referrer-Policy, pero sí muestra el Referer que se
envió.
¿Qué política deberías establecer para tu sitio web?
Te recomendamos que configures de forma explícita una política que mejore la privacidad, como
strict-origin-when-cross-origin (o más estricta).
¿Por qué "explícitamente"?
Si no estableces una política de referencia, se usará la política predeterminada del navegador. De hecho, los sitios web suelen remitirse a la configuración predeterminada del navegador. Sin embargo, esto no es lo ideal por los siguientes motivos:
- Los diferentes navegadores tienen diferentes políticas predeterminadas, por lo que, si confías en los valores predeterminados del navegador, tu sitio no se comportará de manera predecible en todos los navegadores.
- Los navegadores están adoptando valores predeterminados más estrictos, como
strict-origin-when-cross-origin, y mecanismos como el recorte de URLs de referencia para las solicitudes de origen cruzado. Habilitar de forma explícita una política de mejora de la privacidad antes de que cambien los valores predeterminados del navegador te otorga control y te ayuda a ejecutar pruebas como lo consideres adecuado.
¿Por qué strict-origin-when-cross-origin (o más estricto)?
Necesitas una política que sea segura, que mejore la privacidad y que sea útil. El significado de "útil" depende de lo que quieras obtener de la referencia:
- Seguro: Si tu sitio web usa HTTPS (si no es así, conviértelo en una prioridad), no querrás que las URLs de tu sitio web se filtren en solicitudes que no sean HTTPS. Como cualquier persona de la red puede verlos, las filtraciones expondrían a tus usuarios a ataques de intermediarios. Las políticas
no-referrer-when-downgrade,strict-origin-when-cross-origin,no-referrerystrict-originresuelven este problema. - Mejora de la privacidad: Para una solicitud de origen cruzado,
no-referrer-when-downgradecomparte la URL completa, lo que puede causar problemas de privacidad.strict-origin-when-cross-originystrict-originsolo comparten el origen, yno-referrerno comparte nada. Esto te deja constrict-origin-when-cross-origin,strict-originyno-referrercomo opciones para mejorar la privacidad. - Útil:
no-referrerystrict-originnunca comparten la URL completa, ni siquiera para las solicitudes del mismo origen. Si necesitas la URL completa,strict-origin-when-cross-origines una mejor opción.
Todo esto significa que strict-origin-when-cross-origin suele ser una
opción razonable.
Ejemplo: Configura una política de strict-origin-when-cross-origin
index.html:
<meta name="referrer" content="strict-origin-when-cross-origin" />
O del lado del servidor, por ejemplo, en Express:
const helmet = require('helmet');
app.use(helmet.referrerPolicy({policy: 'strict-origin-when-cross-origin'}));
¿Qué sucede si strict-origin-when-cross-origin (o una política más estricta) no se adapta a todos tus casos de uso?
En este caso, adopta un enfoque progresivo: establece una política de protección, como
strict-origin-when-cross-origin, para tu sitio web y, si es necesario, una política más
permisiva para solicitudes o elementos HTML específicos.
Ejemplo: Política a nivel de 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>
Safari/WebKit podría limitar document.referrer o el encabezado Referer para las solicitudes entre sitios.
Consulta los detalles.
Ejemplo: Política a nivel de solicitud
script.js:
fetch(url, {referrerPolicy: 'no-referrer-when-downgrade'});
¿Qué más deberías tener en cuenta?
Tu política debe depender de tu sitio web y de los casos de uso, según lo determinen tú, tu equipo y tu empresa. Si algunas URLs contienen datos de identificación o sensibles, establece una política de protección.
Prácticas recomendadas para las solicitudes entrantes
A continuación, se incluyen algunos lineamientos sobre qué hacer si tu sitio usa la URL de referencia de las solicitudes entrantes.
Protege los datos de los usuarios
El Referer puede contener datos privados, personales o de identificación, así que asegúrate
de tratarlo como tal.
Los referentes entrantes pueden cambiar {referer-can-change}
El uso de la URL de referencia de las solicitudes entrantes de origen cruzado tiene algunas limitaciones:
- Si no tienes control sobre la implementación del emisor de la solicitud, no puedes
hacer suposiciones sobre el encabezado
Referer(ydocument.referrer) que recibes. El emisor de la solicitud puede decidir cambiar a una política deno-referreren cualquier momento o, de manera más general, a una política más estricta que la que usaba antes. Esto significa que recibes menos datos de laRefererque antes. - Los navegadores usan cada vez más la política de referencia
strict-origin-when-cross-originde forma predeterminada. Esto significa que, ahora, es posible que solo recibas el origen, en lugar de una URL de referencia completa, en las solicitudes de origen cruzado entrantes, si el sitio del remitente no tiene una política establecida. - Es posible que los navegadores cambien la forma en que administran
Referer. Por ejemplo, algunos desarrolladores de navegadores pueden decidir recortar siempre las referencias a los orígenes en las solicitudes de recursos secundarios de origen cruzado para proteger la privacidad del usuario. - El encabezado
Referer(ydocument.referrer) puede contener más datos de los que necesitas. Por ejemplo, puede tener una URL completa cuando solo quieres saber si la solicitud es de origen cruzado.
Alternativas a Referer
Es posible que debas considerar alternativas en los siguientes casos:
- Una función esencial de tu sitio usa la URL de referencia de las solicitudes de origen cruzado entrantes.
- Tu sitio ya no recibe la parte de la URL de referencia que necesita en una solicitud de origen cruzado. Esto sucede cuando el emisor de la solicitud cambia su política o cuando no tiene una política establecida y la política predeterminada del navegador cambió (como en Chrome 85).
Para definir alternativas, primero analiza qué parte de la URL de referencia estás usando.
Si solo necesitas el origen
- Si usas la URL de referencia en una secuencia de comandos que tiene acceso de nivel superior a la página,
window.location.origines una alternativa. - Si están disponibles, los encabezados como
OriginySec-Fetch-Sitete proporcionan elOrigino describen si la solicitud es de origen cruzado, lo que podría ser exactamente lo que necesitas.
Si necesitas otros elementos de la URL (ruta de acceso, parámetros de consulta, etcétera)
- Los parámetros de solicitud pueden abordar tu caso de uso, lo que te ahorra el trabajo de analizar la URL de referencia.
- Si usas la URL de referencia en una secuencia de comandos que tiene acceso de nivel superior a la página,
window.location.pathnamepodría funcionar como alternativa. Extrae solo la sección de la ruta de acceso de la URL y pásala como argumento para que no se pase ninguna información potencialmente sensible en los parámetros de la URL.
Si no puedes usar estas alternativas, haz lo siguiente:
- Verifica si puedes cambiar tus sistemas para esperar que el emisor de la solicitud
(por ejemplo,
site-one.example) establezca de forma explícita la información que necesitas en algún tipo de configuración.- Ventaja: Es más explícito, preserva más la privacidad de los usuarios de
site-one.exampley está más preparado para el futuro. - Desventaja: Es posible que requiera más trabajo de tu parte o de los usuarios de tu sistema.
- Ventaja: Es más explícito, preserva más la privacidad de los usuarios de
- Verifica si el sitio que emite las solicitudes puede aceptar establecer una
política de URL de referencia por elemento o por solicitud de
no-referrer-when-downgrade.- Desventaja: Es posible que preserve menos la privacidad de los usuarios de
site-one.exampley que no sea compatible con todos los navegadores.
- Desventaja: Es posible que preserve menos la privacidad de los usuarios de
Protección contra la falsificación de solicitudes entre sitios (CSRF)
Un emisor de solicitudes siempre puede decidir no enviar la URL de referencia estableciendo una
política no-referrer, y un agente malicioso incluso podría falsificar la URL de referencia.
Usa tokens de CSRF
como protección principal. Para obtener protección adicional, usa
SameSite y,
en lugar de Referer, usa encabezados como
Origin
(disponible en solicitudes POST y CORS) y
Sec-Fetch-Site,
si está disponible.
Registra y depura
Asegúrate de proteger los datos personales o sensibles de los usuarios que puedan estar en el
Referer.
Si solo usas el origen, verifica si puedes usar el encabezado Origin como alternativa. Esto podría brindarte la información que necesitas para la depuración de una manera más sencilla y sin necesidad de analizar la URL de referencia.
Pagos
Es posible que los proveedores de pagos dependan del encabezado Referer de las solicitudes entrantes para
realizar verificaciones de seguridad.
Por ejemplo:
- El usuario hace clic en el botón Comprar en
online-shop.example/cart/checkout. online-shop.exampleredirecciona apayment-provider.examplepara administrar la transacción.payment-provider.exampleverifica elRefererde esta solicitud con una lista de valores deRefererpermitidos que configuran los comercios. Si no coincide con ninguna entrada de la lista,payment-provider.examplerechaza la solicitud. Si coincide, el usuario puede continuar con la transacción.
Prácticas recomendadas para las verificaciones de seguridad del flujo de pagos
Como proveedor de pagos, puedes usar el Referer como una verificación básica contra algunos
ataques. Sin embargo, el encabezado Referer por sí solo no es una base confiable para
una verificación. El sitio solicitante, ya sea un comercio legítimo o no, puede establecer una política de no-referrer que haga que la información de Referer no esté disponible para el proveedor de pagos.
Observar el Referer podría ayudar a los proveedores de pagos a detectar atacantes ingenuos que
no establecieron una política de no-referrer. Si usas el Referer como primera verificación, haz lo siguiente:
- No esperes que el
Referersiempre esté presente. Si está presente, verifícalo solo con los datos mínimos que puede incluir, que es el origen.- Cuando configures la lista de valores
Refererpermitidos, asegúrate de incluir solo el origen y ninguna ruta de acceso. - Por ejemplo, los valores permitidos de
Refererparaonline-shop.exampledeben seronline-shop.example, noonline-shop.example/cart/checkout. Si no esperas ningúnReferero un valor deRefererque sea solo el origen del sitio solicitante, evitas los errores que podrían surgir de hacer suposiciones sobre elReferrer-Policydel comercio.
- Cuando configures la lista de valores
- Si no hay
Referer, o si hay y la verificación básica de origen deRefereres correcta, puedes pasar a otro método de verificación más confiable.
Para verificar los pagos de manera más confiable, permite que el solicitante aplique un algoritmo hash a los parámetros de la solicitud junto con una clave única. Luego, los proveedores de servicios de pago pueden calcular el mismo hash de tu lado y solo aceptar la solicitud si coincide con tu cálculo.
¿Qué sucede con el Referer cuando un sitio de comercio HTTP sin política de referencia
redirecciona a un proveedor de pagos HTTPS?
No se puede ver ningún Referer en la solicitud al proveedor de pagos HTTPS, ya que
la mayoría de los navegadores usan strict-origin-when-cross-origin o
no-referrer-when-downgrade de forma predeterminada cuando un sitio web no tiene una política establecida.
El cambio de Chrome a una nueva política predeterminada
no modificará este comportamiento.
Conclusión
Una política de referencia de protección es una excelente manera de brindarles más privacidad a tus usuarios.
Para obtener más información sobre las diferentes técnicas para proteger a tus usuarios, consulta nuestra colección Seguridad y protección.
Recursos
- Información sobre "mismo sitio" y "mismo origen"
- Un nuevo encabezado de seguridad: Referrer Policy (2017)
- Referrer-Policy en MDN
- Encabezado Referer: inquietudes de privacidad y seguridad en MDN
- Cambio en Chrome: Blink intent to implement
- Cambio en Chrome: Blink intent to ship
- Cambio en Chrome: entrada de estado
- Cambio en Chrome: entrada de blog sobre la versión beta 85
- Hilo de GitHub sobre el recorte de la URL de referencia: qué hacen los diferentes navegadores
- Especificación de Referrer-Policy
Agradecemos las contribuciones y los comentarios de todos los revisores, especialmente Kaustubha Govind, David Van Cleve, Mike West, Sam Dutton, Rowan Merewood, Jxck y Kayce Basques.