Cómo configurar cookies SameSite con sus 6 atributos

PublicadoHerramientaGenerador y Analizador de Cookies

Contenido
  1. Los puntos donde más te trabas al crear una cookie de sesión
  2. Cómo construir a mano una cadena de cookie sin herramientas
  3. Las confusiones más habituales
  4. En resumen
  5. Preguntas frecuentes

Por más que escribas HttpOnly en document.cookie, nunca se reflejará en la cookie real: no es un descuido, es la especificación. HttpOnly no se puede establecer desde el JavaScript del navegador, porque es un atributo que solo tiene efecto en la cabecera de respuesta HTTP que envía el servidor.

Este artículo repasa, tal como funciona el código en la práctica, cómo se combinan realmente los seis atributos —Domain, Path, Max-Age, SameSite, Secure y HttpOnly— dentro de la cadena de una cookie, y por qué una asignación a document.cookie y una cabecera Set-Cookie producen resultados distintos.

Resumen ① HttpOnly solo es válido en la cabecera Set-Cookie del servidor y jamás se puede establecer con document.cookie. ② Domain y Path deciden el alcance con el que se envía la cookie, y Max-Age fija el momento de caducidad en segundos. ③ Al analizar una cadena de cookies hay que separar los tramos por punto y coma (;) y cortar cada tramo solo en la primera posición del signo igual (=), para que los "=" que haya dentro del valor no se rompan.

Cuando intentas crear a mano una cookie de sesión para el login, hay una situación que se repite. Escribes document.cookie = "session=abc123; HttpOnly" en la consola de las herramientas de desarrollo del navegador y luego vuelves a consultar document.cookie, y la palabra HttpOnly no aparece por ningún lado.

No es una errata ni un fallo del navegador. document.cookie solo funciona dentro del contexto de ejecución de JavaScript, mientras que HttpOnly es, por definición, el atributo que impide que JavaScript lea o escriba esa cookie.

Si un script pudiera imponerse esa restricción a sí mismo, la restricción perdería todo su sentido, así que el navegador ignora en silencio cualquier HttpOnly que llegue a través de document.cookie.

Un caso parecido que también suele atascarte es el de las cookies que se quedan fuera en peticiones de sitio cruzado. Si en un widget de pago o en un iframe externo has puesto SameSite en None y la cookie no se envía, lo más probable es que falte el atributo Secure.

Los navegadores actuales, si una cookie con SameSite=None no lleva Secure, ni siquiera la guardan o directamente no la envían.

La cadena de una cookie se puede escribir correctamente a mano si conoces las reglas. El orden es este.

  1. Codifica desde key=value. La cadena de cookie usa el punto y coma (;) y el signo igual (=) como separadores, así que si el valor contiene alguno de estos caracteres, espacios o caracteres no ASCII (tildes, eñes y similares), tiene que pasar por codificación URL para que la cadena no se rompa.
  2. Une solo los atributos que necesites con "; ". Añádelos en forma nombre=valor, como Domain=example.com, Path=/, Max-Age=3600, y los atributos sin valor (Secure, HttpOnly) se escriben solo con el nombre.
  3. HttpOnly va en otro destino. Si quieres ejecutar la cadena que has creado desde JavaScript, asígnala con document.cookie = "...", pero en ese caso HttpOnly es un atributo exclusivo de las cabeceras del servidor que se ignora aunque lo incluyas. Si lo que quieres es enviarla en la respuesta del servidor, basta con ponerla tal cual en una cabecera HTTP con la forma Set-Cookie: ..., y entonces HttpOnly sí se aplica con normalidad.

Criterios para decidir los valores de Max-Age, Domain y Path

Entre Max-Age y Expires solo tienes que elegir uno. Max-Age indica con un número entero cuántos segundos pasan desde este momento hasta la caducidad, y si omites el valor la cookie se convierte en una cookie de sesión que desaparece al cerrar la ventana del navegador. Expires exige escribir una fecha absoluta como cadena, con la carga de ajustarse al formato, así que Max-Age se usa con más frecuencia.

Si omites Domain, la cookie queda ligada exactamente al host al que te has conectado, es una cookie exclusiva de host y no se envía a los subdominios. Si lo indicas como Domain=example.com, la cookie viaja también en las peticiones a example.com y a subdominios como sub.example.com.

En Path, si omites el valor, el navegador calcula uno por defecto a partir de la ruta de la petición que creó la cookie. Si pones Path=/, la cookie se envía en todas las rutas del dominio, y si lo estrechas a algo como Path=/account, solo se envía en esa ruta y en sus subrutas. Puedes comprobar este cálculo al instante con nuestro Generador y Analizador de Cookies.

Generador y Analizador de Cookies

Al introducir Key/Value y los valores de Domain, Path, Max-Age, SameSite, Secure y HttpOnly, se generan a la vez la sentencia document.cookie y la cadena de cabecera Set-Cookie.

Las confusiones más habituales

SameSite y Secure van de la mano. Usar SameSite=None significa que vas a enviar la cookie también en peticiones de sitio cruzado, y eso amplía las posibilidades de que la cookie quede expuesta. Por eso el navegador rechaza una cookie que tiene SameSite=None sin Secure.

Aunque marques la casilla de HttpOnly, es normal que no quede ningún rastro en la línea de salida de document.cookie. HttpOnly es el atributo que bloquea el acceso desde JavaScript, así que no tiene ningún sentido incluirlo en la propia cadena que vas a ejecutar con JavaScript.

AtributoQué defineFormato del valorSi lo omites
DomainEl rango de hosts a los que se envía la cookieexample.comSe envía solo al host exacto al que te conectaste (sin subdominios)
PathEl rango de rutas URL a las que se envía la cookie/accountSe limita según la ruta de la petición que creó la cookie
Max-AgeEn cuántos segundos caduca3600 (en segundos)Cookie de sesión (se borra al cerrar el navegador)
SameSiteSi se envía también en peticiones a otros sitiosStrict / Lax / NoneVaría según el navegador, pero la mayoría de los navegadores actuales lo tratan como Lax
SecureSi se envía solo por conexiones HTTPSSolo el nombre, sin valorSe envía también por conexiones HTTP
HttpOnlySi JavaScript puede leer la cookieSolo el nombre, sin valor; exclusivo de cabecerasSe puede leer con document.cookie

A veces el valor que copias de las herramientas de desarrollo del navegador lleva delante el prefijo Cookie:. Antes de analizarlo tienes que quitar ese prefijo, o la primera clave se interpretará por error como Cookie en sí misma.

Al dividir cada tramo por el signo igual (=), corta solo en el primer signo igual. Hay valores de token que llevan el signo igual (=) como carácter de relleno, y si cortas cada vez que aparece un igual, el valor se te queda partido por la mitad.

En resumen

  • Domain y Path determinan el alcance con el que se envía la cookie, y Max-Age fija el momento de caducidad en segundos.
  • Para usar SameSite=None tienes que activar Secure a la vez, o el navegador rechazará la cookie.
  • HttpOnly solo es válido en la cabecera Set-Cookie del servidor: ni se puede establecer ni se puede quitar con document.cookie.
  • Al analizar una cadena de cookie, quita primero el prefijo Cookie:, divide por punto y coma y corta cada tramo solo en el primer signo igual para que el valor no se rompa.
Generador y Analizador de Cookies

Al introducir Key/Value y los valores de Domain, Path, Max-Age, SameSite, Secure y HttpOnly, se generan a la vez la sentencia document.cookie y la cadena de cabecera Set-Cookie.

Preguntas frecuentes

No. HttpOnly es, por definición, el atributo que impide el acceso desde JavaScript, así que si consultas document.cookie esa cookie no aparece en la lista y, aunque sobrescribas el valor, no surte efecto. Una cookie HttpOnly solo la puede establecer o modificar el servidor mediante la cabecera Set-Cookie de la respuesta HTTP.

Lo primero que tienes que comprobar es si el atributo Secure está presente. Los navegadores actuales, cuando una cookie con SameSite=None no lleva Secure, ni la guardan o directamente no la envían. Se resuelve activando también Secure en un entorno HTTPS.

¿Qué diferencia hay entre Max-Age y Expires?

Max-Age es un método relativo que indica con un número entero cuántos segundos pasan desde ahora hasta la caducidad, mientras que Expires escribe el instante de caducidad como una cadena de fecha absoluta. Si no especificas ninguno de los dos valores, la cookie se convierte en una cookie de sesión y se elimina al cerrar el navegador.

¿Puedo poner tildes, eñes o espacios tal cual en el valor de una cookie?

Si los pones tal cual, pueden chocar con separadores como el punto y coma (;), el signo igual (=) o el espacio, y la cadena se puede romper. Lo seguro es pasar el valor por codificación URL para convertirlo en caracteres seguros, meterlo después en la cadena de la cookie y volver a decodificarlo al leer el valor.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Diferencia entre async y defer: carga y ejecución de scriptsCompara cómo la carga normal, async y defer afectan al parseo del HTML: cuándo se descarga el script, cuándo se ejecuta y si bloquea el renderizado.
  2. Barra de desplazamiento CSS: cambio de color en Chrome y FirefoxTu CSS de la barra de desplazamiento funciona en Chrome pero no en Firefox: así difieren ::-webkit-scrollbar y scrollbar-color, y cómo generar ambos.
  3. Cómo compartir un texto secreto sin dejarlo en el servidorCifra y comprime el texto en tu navegador y compártelo dentro de la URL: nada se guarda en el servidor. Te explicamos cuándo se cifra de verdad.
  4. Convertidor de mayúsculas y minúsculas: 4 formatos y sus reglasConvierte texto en inglés a Sentence Case, Title Case, snake_case o kebab-case y descubre qué palabras quedan en minúscula y por qué.
  5. Slug de URL: cómo convertir un título en texto con guionesReglas para pasar títulos o frases a un slug en minúsculas con guiones: qué hacer con espacios, tildes, símbolos y si conviene mantener otros alfabetos.
  6. Comillas curvas a ASCII: cómo limpiarlas y evitar errores de sintaxisPor qué Word y los editores web convierten las comillas rectas en curvas, causan errores de sintaxis y cómo reemplazarlas por comillas ASCII estándar.

Herramientas relacionadas