Referrer-Policy
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
La cabecera Referrer-Policy
de HTTP determina qué datos de referente, de entre los que se envían con la cabecera Referer
, deben incluirse con las solicitudes realizadas.
Tipo de cabecera | Response header |
---|---|
Forbidden header name | no |
Sintaxis
Observe que Referer
es una falta de ortografía; en inglés, la palabra correcta es referrer. La cabecera Referrer-Policy
no contiene esta falta.
Referrer-Policy: no-referrer Referrer-Policy: no-referrer-when-downgrade Referrer-Policy: origin Referrer-Policy: origin-when-cross-origin Referrer-Policy: same-origin Referrer-Policy: strict-origin Referrer-Policy: strict-origin-when-cross-origin Referrer-Policy: unsafe-url
Directivas
- no-referrer
-
La cabecera
Referer
se omitirá en su totalidad. No se enviará ningún dato de referente junto con las solicitudes. - no-referrer-when-downgrade (predeterminado)
-
Este es el comportamiento predeterminado del agente de usuario si no se especifica ninguna directiva. El origen se enviará como referente cuando el nivel de seguridad del protocolo permanece igual (HTTPS → HTTPS), pero no se enviará a destinos menos seguros (HTTPS → HTTP).
- origin
-
Se enviará únicamente el origen del documento como referente en todos los casos. El documento
https://ejemplo.com/pagina.html
enviará el referentehttps://ejemplo.com/
. - origin-when-cross-origin
-
Se enviará un URL completo al realizarse una solicitud de origen equivalente, pero únicamente el origen para otros casos.
- same-origin
-
Se enviará un referente para orígenes de sitio equivalente, pero las solicitudes de origen transversal no contendrán ningún dato de referente.
- strict-origin
-
Solo se enviará el origen del documento como referente a destinos que a priori son igual de seguros (HTTPS → HTTPS), pero no lo recibirán destinos menos seguros (HTTPS → HTTP).
- strict-origin-when-cross-origin
-
Se enviará un URL completo al realizarse una solicitud de origen equivalente, se enviará únicamente el origen del documento a destinos igual de seguros a priori (HTTPS → HTTPS) y no se enviará ninguna cabecera a destinos menos seguros (HTTPS → HTTP).
- unsafe-url
-
Se enviará un URL completo al realizarse una solicitud de origen equivalente o de origen transversal.
Nota: Esta directiva filtrará los orígenes y las rutas de acceso de recursos protegidos por TLS a orígenes inseguros. Estudie atentamente el impacto resultante de esta configuración.
Ejemplos
Especificaciones
Specification |
---|
Referrer Policy # referrer-policy-header |
Compatibilidad con navegadores
BCD tables only load in the browser
Véase también
-
Otras maneras de definir una directiva de referentes:
- Un elemento
<meta>
con un nombre dereferrer
. - Un atributo
referrerpolicy
en un elemento<a>
,<area>
,<img>
,<iframe>
o<link>
. - La relación de enlace
noreferrer
en un elemento a, area o link (rel="noreferrer"
). - Al utilizar Fetch:
Request.referrerPolicy
- Un elemento
-
«Un mayor control sobre sus referentes» en el blog de seguridad de Mozilla