API de búsqueda facial 1:N: detección de duplicados

La búsqueda facial es una potente función que te permite buscar un rostro concreto en todas tus sesiones de verificación de identidad aprobadas. Esta capacidad ayuda a identificar cuentas duplicadas, prevenir el fraude y reforzar tus medidas de seguridad. La lección de la Academy sobre cómo leer un resultado de verificación llega a la búsqueda facial y las listas de bloqueo en el minuto 6:53.

​

Integración automática de la búsqueda facial

La búsqueda facial se realiza automáticamente durante las comprobaciones de prueba de vida en las sesiones de verificación, para detectar usuarios duplicados y contrastar con rostros de la lista de bloqueo.

​

Detección automática de duplicados

Cuando un usuario completa una prueba de vida durante la verificación de identidad:

• Su biometría facial se compara automáticamente con la de todos los usuarios verificados anteriormente
• El sistema identifica posibles cuentas duplicadas según la similitud facial
• Las coincidencias se marcan según los umbrales de similitud que hayas configurado
• Puedes revisar y actuar sobre los posibles usuarios duplicados

​

Integración con la lista de bloqueo

La búsqueda facial se integra a la perfección con la función de lista de bloqueo:

• Durante la verificación, los rostros se contrastan automáticamente con tu lista de bloqueo
• Si se encuentra una coincidencia con un rostro de la lista de bloqueo, la verificación se rechaza automáticamente
• Esto impide que usuarios problemáticos ya identificados creen cuentas nuevas
• Ayuda a mantener la integridad de tu proceso de verificación

​

El selfie tomado durante la captura del documento

Mientras el usuario fotografía su documento, la cámara frontal le toma un selfie (Silent Capture). Cada vez que se evalúa el documento, ese selfie pasa por la misma búsqueda 1:N que el selfie de la prueba de vida:

• Se compara con tu lista de bloqueo de rostros y con los usuarios ya aprobados en tu aplicación, con los mismos umbrales de similitud y la misma precedencia que la búsqueda de la prueba de vida.
• Una coincidencia con la lista de bloqueo genera FRONT_CAMERA_FACE_IN_BLOCKLIST (siempre Rechazado) o POSSIBLE_FRONT_CAMERA_FACE_IN_BLOCKLIST (siempre Revisión). Una coincidencia con un usuario aprobado genera FRONT_CAMERA_DUPLICATED_FACE o POSSIBLE_FRONT_CAMERA_DUPLICATED_FACE, además de FRONT_CAMERA_DUPLICATED_FACE_NAME_MISMATCH cuando ese usuario aprobado fue verificado con otro nombre y FRONT_CAMERA_DUPLICATED_FACE_DOCUMENT_MISMATCH cuando el documento de identidad de ese usuario muestra otra fecha de nacimiento. Consulta las advertencias de la verificación de identidad.
• Las coincidencias aparecen en los detalles de la sesión, en la tarjeta de verificación de identidad, y se devuelven en id_verifications[].document_selfie_face_matches de la decisión de la sesión. Usa el mismo formato de entrada que liveness_checks[].matches. El campo es null en sesiones antiguas o cuando la búsqueda no se ejecutó, y un arreglo vacío cuando se ejecutó y no encontró nada. match_image_url es una URL prefirmada que caduca.
• Solo se usa el rostro más grande del selfie, y solo cuando el detector está seguro de que es un rostro. Se busca un selfie por documento: el del anverso o el del reverso cuando el del anverso no contiene un rostro claro.
• El selfie solo se compara. Su plantilla biométrica nunca se almacena, así que las sesiones posteriores nunca se comparan con ella. Para vetar a una persona a partir del selfie de una sesión, añádelo a tu lista de bloqueo de rostros desde la página de la sesión.

La búsqueda tiene su propio interruptor y sus propias acciones en el paso de Verificación de identidad, en la pestaña Reglas del paso (Búsqueda facial con captura silenciosa), o con document_selfie_face_search_enabled y las acciones document_selfie_duplicated_face_* en la configuración de funciones del flujo. Está activada por defecto; la acción de rostro duplicado es Aprobar por defecto (la advertencia se sigue informando) y las comprobaciones cruzadas de nombre y documento son Revisión por defecto, igual que sus equivalentes de la prueba de vida. La búsqueda necesita el selfie, así que solo se ejecuta cuando Silent Capture está activada. Desactivar la búsqueda facial en el paso de prueba de vida también desactiva esta búsqueda: esa exclusión es una decisión sobre el rostro de la persona, por lo que abarca todos los selfies de la sesión.

​

La regla de discrepancia de documento

La regla de discrepancia de documento (DUPLICATED_FACE_DOCUMENT_MISMATCH para el selfie de la prueba de vida, FRONT_CAMERA_DUPLICATED_FACE_DOCUMENT_MISMATCH para Silent Capture) marca un rostro duplicado solo cuando el documento de identidad del usuario coincidente muestra una fecha de nacimiento distinta. No se marca a la misma persona que presenta un documento distinto, por ejemplo un pasaporte después de un documento de identidad. Tampoco se marca un documento renovado. Dos sesiones que comparten el mismo número de documento del mismo país nunca se marcan.

​

Desactivar la búsqueda facial automática

La búsqueda facial automática está activada por defecto en todos los pasos de prueba de vida. Si tu postura de privacidad lo exige, puedes desactivarla por flujo desde la pestaña Reglas del paso de Prueba de vida en la Business Console (modo simple y avanzado), o con face_search_enabled: false en el nodo LIVENESS o AGE_ESTIMATION de la configuración de funciones del flujo. Con el interruptor desactivado, el selfie de la prueba de vida se sigue puntuando para la prueba de vida y se compara 1:1 con el retrato del documento en la coincidencia facial, pero nunca llega al índice de rostros:

• No se ejecuta ninguna búsqueda, así que la sesión no recibe ningún veredicto de duplicado, lista de bloqueo o lista de permitidos y su liveness_checks[].matches queda vacío. Las reglas de rostro duplicado, discrepancia de nombre, discrepancia de documentos y de rostro entre organizaciones no tienen nada sobre lo que actuar y se ocultan en la Consola.
• No se almacena ninguna plantilla biométrica del selfie, así que las sesiones posteriores no pueden compararse con esta y no hay nada que la retención de plantillas biométricas deba conservar después de eliminar la sesión.
• El selfie no se usa para resolver una persona biométrica compartida en las comprobaciones entre organizaciones.
• Tampoco se busca el selfie tomado durante la captura del documento (sin riesgo de lista de bloqueo ni de duplicado FRONT_CAMERA_*): la exclusión abarca todos los selfies de la sesión. El interruptor propio del paso de verificación de identidad (ver más arriba) también puede desactivar esa búsqueda por separado.

A qué paso pertenece el interruptor. El interruptor está en el paso que captura el selfie, así que un paso de prueba de vida o de estimación de edad responde por sí mismo. Un paso de coincidencia facial no tiene uno propio: cuando un usuario repite el selfie allí (por ejemplo, después de que le pidas que reenvíe ese paso), la repetición sigue el ajuste del paso de prueba de vida, así que una exclusión también mantiene fuera del índice el nuevo selfie. Si tu flujo se ramifica en más de un paso de prueba de vida, el ajuste que se aplica es el de la rama por la que realmente pasó la sesión, y la lectura de rostros entre organizaciones sigue ese mismo paso. Los flujos existentes mantienen el comportamiento actual hasta que decidas excluirte. El cambio se aplica a las sesiones iniciadas después de guardar el flujo; las plantillas almacenadas por sesiones anteriores permanecen en el índice hasta que esas sesiones se eliminan o se purgan. El interruptor no afecta a la API de búsqueda facial independiente, que llamas de forma explícita.

​

Acceso por API

La función de búsqueda facial también está disponible a través de nuestra API, que te permite:

• Enviar búsquedas faciales de forma programática
• Integrar capacidades de coincidencia facial en tus propias aplicaciones
• Crear flujos personalizados de detección de fraude
• Crear sistemas automatizados de detección de duplicados

​

Funciones principales

• Alta precisión: los algoritmos biométricos avanzados ofrecen resultados de coincidencia fiables
• Umbrales configurables: personaliza la sensibilidad de la coincidencia según tu tolerancia al riesgo
• Análisis exhaustivo: busca entre todos tus usuarios verificados
• Resultados rápidos: procesa las búsquedas con rapidez incluso con bases de datos de usuarios grandes
• Centrada en la privacidad: la coincidencia usa plantillas faciales numéricas limitadas a tu aplicación; el índice nunca sale de tu tenant

​

Umbrales configurables

Puedes personalizar la sensibilidad de la búsqueda definiendo distintos umbrales para las puntuaciones de similitud:

​

Cómo funciona

​

Sesiones eliminadas y plantillas biométricas conservadas

Eliminar una sesión elimina por defecto su vector facial, así que la persona sale del índice y puede volver a verificarse sin que se la marque como duplicada. Las aplicaciones que eliminan sesiones poco después de aprobarlas pero aun así necesitan detectar registros repetidos pueden activar la retención de plantillas biométricas. Didit conserva entonces una plantilla biométrica sin imágenes asociada al usuario después de eliminar la sesión, y esa plantilla participa en la búsqueda facial y en la detección automática de duplicados exactamente igual que el rostro de una sesión activa. Una coincidencia con una plantilla conservada se informa con source: "retained_template", el vendor_user_id y el vendor_data del usuario propietario y un biometric_template_id. No incluye ID de sesión, imagen de la coincidencia, datos de identidad ni estado de sesión, porque la sesión que produjo el rostro ya no existe. Las plantillas conservadas nunca se añaden a la lista de bloqueo; las entradas de la lista de bloqueo de rostros mantienen su propia entrada biométrica independiente. La plantilla permanece hasta su caducidad programada, la eliminación del usuario, una solicitud de borrado por privacidad o una purga explícita mediante la API de plantillas biométricas o Listas → Plantillas biométricas en la Consola.

​

Porcentaje de similitud

El porcentaje de similitud es la métrica principal para determinar posibles coincidencias:

• Porcentaje alto (normalmente 90% o más): indica una alta probabilidad de que los rostros pertenezcan a la misma persona.
• Porcentaje medio (70-89%): sugiere posibles coincidencias que pueden requerir más revisión.
• Porcentaje bajo (por debajo del 70%): probablemente indica personas distintas.

El umbral exacto que define una “coincidencia” se puede configurar según tus requisitos de seguridad. Subir el umbral reduce los falsos positivos, pero puede aumentar los falsos negativos.

​

Casos de uso

• Prevención del fraude: identifica a los usuarios que intentan crear varias cuentas
• KYC reforzado: añade una capa adicional de verificación a tu proceso de KYC
• Cumplimiento normativo: cumple los requisitos de detección de cuentas duplicadas
• Control de acceso: verifica la autenticidad de los usuarios en zonas de alta seguridad
• Fuerzas del orden: ayuda a los organismos autorizados a identificar personas de interés