> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/midapi-v2/biometric-user.md).

# Biometric User

Ciclo de vida del usuario biométrico: alta a partir de su template facial, autenticación contra el template que custodia el servicio, mantenimiento de ese template y baja.

El alta y la autenticación son llamadas distintas y no hay alta implícita: autenticar un `userId` que no está registrado devuelve `404`. Una vez registrado, el integrador deja de enviar el template de referencia en cada petición; el servicio lo custodia y lo compara contra la captura de la operación que se le indique.

#### Ámbito del identificador

El `userId` es único dentro del consumer que lo registró, o dentro de toda la plataforma si la plataforma está configurada para registrar usuarios a ese nivel. Ese ajuste es de plataforma y determina qué consumers ven un usuario ya registrado: con ámbito de plataforma, los consumers hermanos operan sobre el mismo padrón; con ámbito de consumer, cada uno tiene el suyo y un `userId` registrado por otro se comporta como inexistente.

#### La baja es lógica

Dar de baja a un usuario libera su identificador sin borrar el registro anterior, y un alta posterior con el mismo `userId` crea un registro nuevo. Un usuario dado de baja se comporta como inexistente para autenticar y para actualizar, y repetir la baja devuelve `404`: es la señal que delata un `userId` mal escrito.

#### Aprovisionamiento

Las cuatro rutas exigen que el consumer esté aprovisionado con el servicio `BIOMETRIC_USER`. La autenticación exige además `FACIAL_MATCHING`, y se exigen los dos: tener solo uno devuelve `403`.

#### Vida útil del template

El template que se envía al alta y al actualizar tiene una vida útil configurable para el tenant, contada desde su captura. Un template más antiguo que ese plazo se rechaza con `403` y hay que volver a capturarlo. Sin el parámetro configurado no se aplica ningún límite temporal. No se aplica al autenticar, porque ahí la captura sale de almacenamiento.

#### Servicios disponibles

* [**Register User**](/api-rest/midapi-v2/biometric-user/register-user.md): Registra un usuario a partir de su template biométrico.
* [**Authenticate User**](/api-rest/midapi-v2/biometric-user/authenticate-user.md): Autentica a un usuario registrado contra la captura de una operación.
* [**Update Template**](/api-rest/midapi-v2/biometric-user/update-template.md): Sustituye el template biométrico de un usuario registrado.
* [**Delete User**](/api-rest/midapi-v2/biometric-user/delete-user.md): Da de baja a un usuario registrado.