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#

Syntax	`userid` `on` \| `v1` \| `log` \| `off`;
Predeterminado	`userid off;`
Context	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#

Syntax	`userid_domain` name \| `none`;
Predeterminado	`userid_domain none;`
Context	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#

Syntax	`userid_expires` time \| `max` \| `off`;
Predeterminado	`userid_expires off;`
Context	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#

Syntax	`userid_flags` `off` \| flag ...;
Predeterminado	`userid_flags off;`
Context	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#

Syntax	`userid_mark` letter \| digit \| = \| `off`;
Predeterminado	`userid_mark off;`
Context	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#

Syntax	`userid_name` name;
Predeterminado	`userid_name uid;`
Context	http, server, location

Establece el nombre de la cookie.

userid_p3p#

Syntax	`userid_p3p` string \| `none`;
Predeterminado	`userid_p3p none;`
Context	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#

Syntax	`userid_path` path;
Predeterminado	`userid_path /;`
Context	http, server, location

Define una ruta para la cual se establece la cookie.

userid_service#

Syntax	`userid_service` number;
Predeterminado	`userid_service IP address of the server;`
Context	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.