UserID#

El módulo establece cookies adecuadas para la identificación del cliente. Las cookies recibidas y establecidas pueden registrarse utilizando las variables integradas $uid_got y $uid_set. Este módulo es compatible con el módulo mod_uid para Apache.

Ejemplo de configuración#

userid         on;
userid_name    uid;
userid_domain  example.com;
userid_path    /;
userid_expires 365d;
userid_p3p     'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';

Directivas#

userid#

Sintaxis

userid on | v1 | log | off;

Predeterminado

userid off;

Contexto

http, server, location

Habilita o deshabilita el establecimiento de cookies y el registro de las cookies recibidas:

on

habilita el establecimiento de cookies de versión 2 y el registro de las cookies recibidas;

v1

habilita el establecimiento de cookies de versión 1 y el registro de las cookies recibidas;

log

deshabilita el establecimiento de cookies, pero habilita el registro de las cookies recibidas;

off

deshabilita el establecimiento de cookies y el registro de las cookies recibidas.

userid_domain#

Sintaxis

userid_domain name | none;

Predeterminado

userid_domain none;

Contexto

http, server, location

Define un dominio para el cual se establece la cookie. El parámetro none deshabilita el establecimiento de un dominio para la cookie.

userid_expires#

Sintaxis

userid_expires time | max | off;

Predeterminado

userid_expires off;

Contexto

http, server, location

Establece un tiempo durante el cual un navegador debe mantener la cookie. El parámetro max hará que la cookie expire el "31 Dec 2037 23:55:55 GMT". El parámetro off hará que la cookie expire al final de una sesión del navegador.

userid_flags#

Sintaxis

userid_flags off | flag ...;

Predeterminado

userid_flags off;

Contexto

http, server, location

Si el parámetro no es off, define una o más banderas adicionales para la cookie: secure, httponly, samesite=strict, samesite=lax, samesite=none.

userid_mark#

Sintaxis

userid_mark letter | digit | = | off;

Predeterminado

userid_mark off;

Contexto

http, server, location

Si el parámetro no es off, habilita el mecanismo de marcado de cookies y establece el carácter utilizado como marca. Este mecanismo se utiliza para agregar o cambiar userid_p3p y/o un tiempo de expiración de cookie mientras se preserva el identificador del cliente. Una marca puede ser cualquier letra del alfabeto inglés (distingue entre mayúsculas y minúsculas), dígito o el carácter "=".

Si se establece la marca, se compara con el primer símbolo de relleno en la representación base64 del identificador del cliente pasado en una cookie. Si no coinciden, la cookie se reenvía con la marca especificada, el tiempo de expiración y el encabezado P3P.

userid_name#

Sintaxis

userid_name name;

Predeterminado

userid_name uid;

Contexto

http, server, location

Establece el nombre de la cookie.

userid_p3p#

Sintaxis

userid_p3p string | none;

Predeterminado

userid_p3p none;

Contexto

http, server, location

Establece un valor para el campo de encabezado P3P que se enviará junto con la cookie. Si la directiva se establece en el valor especial none, el encabezado P3P no se enviará en una respuesta.

userid_path#

Sintaxis

userid_path path;

Predeterminado

userid_path /;

Contexto

http, server, location

Define una ruta para la cual se establece la cookie.

userid_service#

Sintaxis

userid_service number;

Predeterminado

userid_service IP address of the server;

Contexto

http, server, location

Si los identificadores son emitidos por múltiples servidores (servicios), a cada servicio se le debe asignar su propio number para garantizar que los identificadores de cliente sean únicos. Para cookies de versión 1, el valor predeterminado es cero. Para cookies de versión 2, el valor predeterminado es el número compuesto por los últimos cuatro octetos de la dirección IP del servidor.

Variables integradas#

$uid_got#

El nombre de la cookie y el identificador de cliente recibido.

$uid_reset#

Si la variable se establece en una cadena no vacía que no sea 0, los identificadores de cliente se restablecen. El valor especial log además provoca la salida de mensajes sobre los identificadores restablecidos en el error_log.

$uid_set#

El nombre de la cookie y el identificador de cliente enviado.