Prácticas recomendadas en relación con las políticas de referencias y los referentes

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.

Solicitud HTTP que incluye un encabezado Referer.
Una solicitud HTTP con un encabezado Referer.

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:

URLs con rutas de acceso, asignadas a diferentes riesgos de privacidad y seguridad.
El uso de la URL completa puede afectar la privacidad y la seguridad del usuario.

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 Referer presente)
  • Solo el origen
  • La URL completa: origen, ruta y cadena de consulta
Son los datos que se pueden
    incluir en el encabezado Referer y en document.referrer.
Ejemplos de datos de Referer.

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-downgrade y strict-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:

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:

  1. Política a nivel del elemento
  2. Política a nivel de la página
  3. 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ó.

Captura de pantalla del panel de redes de las Herramientas para desarrolladores de Chrome, en la que se muestran Referer y Referrer-Policy.
Panel Red de las Herramientas para desarrolladores de Chrome con una solicitud seleccionada.

¿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-referrer y strict-origin resuelven este problema.
  • Mejora de la privacidad: Para una solicitud de origen cruzado, no-referrer-when-downgrade comparte la URL completa, lo que puede causar problemas de privacidad. strict-origin-when-cross-origin y strict-origin solo comparten el origen, y no-referrer no comparte nada. Esto te deja con strict-origin-when-cross-origin, strict-origin y no-referrer como opciones para mejorar la privacidad.
  • Útil: no-referrer y strict-origin nunca comparten la URL completa, ni siquiera para las solicitudes del mismo origen. Si necesitas la URL completa, strict-origin-when-cross-origin es 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 (y document.referrer) que recibes. El emisor de la solicitud puede decidir cambiar a una política de no-referrer en 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 la Referer que antes.
  • Los navegadores usan cada vez más la política de referencia strict-origin-when-cross-origin de 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 (y document.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.origin es una alternativa.
  • Si están disponibles, los encabezados como Origin y Sec-Fetch-Site te proporcionan el Origin o 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.pathname podrí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.example y 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.
  • 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.example y que no sea compatible con todos los navegadores.

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.example redirecciona a payment-provider.example para administrar la transacción.
  • payment-provider.example verifica el Referer de esta solicitud con una lista de valores de Referer permitidos que configuran los comercios. Si no coincide con ninguna entrada de la lista, payment-provider.example rechaza 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 Referer siempre 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 Referer permitidos, asegúrate de incluir solo el origen y ninguna ruta de acceso.
    • Por ejemplo, los valores permitidos de Referer para online-shop.example deben ser online-shop.example, no online-shop.example/cart/checkout. Si no esperas ningún Referer o un valor de Referer que sea solo el origen del sitio solicitante, evitas los errores que podrían surgir de hacer suposiciones sobre el Referrer-Policy del comercio.
  • Si no hay Referer, o si hay y la verificación básica de origen de Referer es 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

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.