Skip to main content

El Objeto Validación Biométrica

Descripción​

El objeto Validación Biométrica representa el proceso de verificar identidades de usuarios a través de datos biométricos dentro de tus proyectos Verifik. Este objeto contiene toda la información necesaria para rastrear y gestionar solicitudes de verificación biométrica, incluyendo reconocimiento facial y detección de vida.

Atributos​

client​

Tipo: ObjectId
Requerido: Solo Lectura

La cuenta del cliente propietaria de esta validación biométrica. Esto se establece automáticamente según tu token de autenticación.

project​

Tipo: ObjectId
Requerido: No

El proyecto donde se está realizando esta validación biométrica. Este es el _id generado al crear un proyecto.

projectFlow​

Tipo: ObjectId
Requerido: Sí

El flujo de proyecto donde se está realizando esta validación biométrica. Este es el _id generado al crear un flujo de proyecto.

livenessSession​

Tipo: ObjectId
Requerido: No

La sesión de detección de vida asociada con esta validación biométrica. Esto rastrea el proceso de verificación de vida del usuario.

appRegistration​

Tipo: ObjectId
Requerido: No

El registro de aplicación vinculado a esta validación biométrica. Esto conecta la validación a un proceso de registro de usuario específico.

status​

Tipo: String
Requerido: Sí

Estado actual del proceso de validación biométrica. Puede ser:

  • "new" - Solicitud de validación creada pero aún no procesada (por defecto)
  • "pending" - Validación en progreso
  • "completed" - Validación biométrica completada exitosamente
  • "failed" - Validación biométrica fallida
  • "expired" - Sesión de validación expirada

identifier​

Tipo: String
Requerido: Sí

Identificador único para el usuario o sesión (ej. email, teléfono, o ID personalizado).

type​

Tipo: String
Requerido: Sí

El tipo de validación biométrica que se está realizando:

  • "validation" - Validación de identidad biométrica general
  • "login" - Verificación biométrica durante autenticación de usuario
  • "onboarding" - Verificación biométrica durante registro de usuario

expiresAt​

Tipo: Date
Requerido: No

Fecha y hora de expiración para la sesión de validación.

redirectUrl​

Tipo: String
Requerido: No

URL para redireccionar después de validación exitosa.

webhookUrl​

Tipo: String
Requerido: No

URL de webhook para notificaciones de estado de validación.

requires2FA​

Tipo: Boolean
Requerido: No

Indicador si se requiere autenticación de dos factores.

ipAddress​

Tipo: String
Requerido: No

Dirección IP del usuario realizando la validación.

sendViaEmail​

Tipo: Boolean
Requerido: No

Indicador para enviar enlace de validación por correo electrónico.

email​

Tipo: String
Requerido: No

Dirección de correo electrónico a la cual enviar el enlace de validación (requerido si sendViaEmail es true).

language​

Tipo: String
Requerido: No

Idioma para plantillas de correo electrónico (en/es). Por defecto "en".

biometricData​

Tipo: Object
Requerido: No

Contiene los datos biométricos y resultados de verificación:

  • faceImage - Imagen facial codificada en Base64
  • template - Datos de plantilla biométrica
  • quality - Puntuación de calidad de imagen
  • livenessScore - Puntuación de detección de vida

verificationResults​

Tipo: Object
Requerido: No

Contiene los resultados de verificación:

  • livenessDetection - Resultado de detección de vida
  • identityMatch - Resultado de coincidencia de identidad
  • qualityScore - Puntuación de calidad general
  • antiSpoofing - Resultado de detección anti-suplantación

riskScore​

Tipo: Number
Requerido: No

Puntuación de evaluación de riesgo para la validación.

createdAt​

Tipo: Date
Requerido: Sí

Marca de tiempo de cuándo se creó la validación biométrica.

updatedAt​

Tipo: Date
Requerido: Sí

Marca de tiempo de cuándo se actualizó por última vez la validación biométrica.

completedAt​

Tipo: Date
Requerido: No

Marca de tiempo de cuándo se completó exitosamente la validación biométrica.

Objeto de Ejemplo​

{
  "_id": "biometric_validation_123456789",
  "client": "client_123456789",
  "project": "project_123456789",
  "projectFlow": "flow_123456789",
  "livenessSession": "liveness_123456789",
  "appRegistration": "reg_123456789",
  "status": "completed",
  "identifier": "user@example.com",
  "type": "validation",
  "expiresAt": "2024-01-15T11:30:00Z",
  "redirectUrl": "https://example.com/success",
  "webhookUrl": "https://example.com/webhook",
  "requires2FA": false,
  "ipAddress": "192.168.1.1",
  "sendViaEmail": true,
  "email": "user@example.com",
  "language": "en",
  "biometricData": {
    "faceImage": "base64_encoded_image",
    "template": "biometric_template_data",
    "quality": "good",
    "livenessScore": 0.95
  },
  "verificationResults": {
    "livenessDetection": "passed",
    "identityMatch": "passed",
    "qualityScore": 0.95,
    "antiSpoofing": "passed"
  },
  "riskScore": 0.05,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:32:00Z",
  "completedAt": "2024-01-15T10:32:00Z"
}