> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vu-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prueba de vida y biometría facial en Identity Link

> Entiende cómo funciona la prueba de vida anti-spoofing en el flujo FULL FLOW de Identity Link y cómo interpretar los resultados.

La prueba de vida (liveness) es un control de seguridad que verifica que la persona frente a la cámara es real y presente en el momento de la verificación. En VU Identity Link, la prueba de vida se ejecuta automáticamente dentro del flujo FULL FLOW, comparando el rostro capturado en vivo con la foto del documento presentado.

## Cuándo se activa la prueba de vida

La biometría facial solo se incluye en el tipo de flujo `FULL FLOW`. Si creas un Link con tipo `ID ONLY`, el usuario solo capturará el frente y reverso del documento, sin prueba de vida.

| Tipo de flujo | Captura documental | Prueba de vida |
| - | - | - |
| `FULL FLOW` | Sí | Sí |
| `ID ONLY` | Sí | No |

### Rama adaptativa: solo selfie

Desde la versión 2.2.0, un Link `FULL FLOW` con [flujo adaptativo](/identity-link/enlaces#flujo-adaptativo) puede resolverse en una de dos ramas para un cliente que ya se verificó antes:

| Rama (`method`) | Qué hace el usuario |
| - | - |
| `DOCUMENT` | Flujo completo: documento + prueba de vida |
| `FACE` | Solo la prueba de vida, sin repetir la captura documental |

La rama se resuelve en el servidor y se persiste una sola vez. Puedes leerla en `GET /verifications/{id}/status?include=operationGuid`, en el campo `method`. La prueba de vida se ejecuta en ambas ramas: lo que la rama `FACE` omite es la captura del documento, nunca el control biométrico.

## Anti-spoofing en Identity Link

El sistema aplica controles anti-spoofing en dos capas:

1. **Anti-spoofing facial**: detecta intentos de suplantación con fotos, videos, máscaras o pantallas.
2. **Anti-spoofing documental**: verifica que el documento capturado no sea una foto de pantalla o una copia impresa.

La activación de estos controles depende de la configuración de tu compañía. Consulta el estado de los servicios con el endpoint de salud.

## Estado de los servicios de anti-spoofing

```bash theme={null}
curl -X GET https://api.identity.vu-one.com/api/v1/health/status
```

### Respuesta de ejemplo

```json theme={null}
{
  "auth": {
    "status": "UP"
  },
  "biometrics": {
    "status": "UP",
    "components": {
      "antiSpoofingDocServiceIndicator": {
        "status": "UP",
        "details": { "antiSpoofing-doc": "Available" }
      },
      "antiSpoofingFaceServiceIndicator": {
        "status": "UP",
        "details": { "antiSpoofing-face": "Available" }
      },
      "ping": { "status": "UP" },
      "refreshScope": { "status": "UP" },
      "sopServiceIndicator": {
        "status": "UP",
        "details": { "antiSpoofing-face": "Available" }
      }
    }
  }
}
```

| Nodo | Qué informa |
| - | - |
| `auth.status` | Disponibilidad del servicio de autenticación (`UP` o `DOWN`) |
| `biometrics.status` | Disponibilidad agregada del servicio de biometría |
| `biometrics.components.antiSpoofingDocServiceIndicator` | Anti-spoofing documental. Su `details` indica `Available` o `Not Available` |
| `biometrics.components.antiSpoofingFaceServiceIndicator` | Anti-spoofing facial |
| `biometrics.components.sopServiceIndicator` | Servicio SOP |
| `biometrics.components.ping` | Conectividad básica con el motor biométrico |
| `biometrics.components.refreshScope` | Estado del refresco de configuración |

El endpoint devuelve **200** cuando el servicio está operativo y **503** cuando no lo está, con el mismo esquema en ambos casos. Si algún indicador muestra `DOWN`, las verificaciones que dependan de ese servicio fallarán hasta que se restaure.

## Interpretación de resultados

Durante el flujo FULL FLOW, recibirás eventos de webhook específicos para la etapa de registro facial:

| Evento | Significado |
| - | - |
| `verification.register.successful` | La prueba de vida se completó correctamente; el rostro en vivo coincide con el documento |
| `verification.register.failed` | La prueba de vida falló; posible intento de spoofing o rostro no coincide |

El evento final `verification.successful` solo se dispara si tanto la captura documental como la prueba de vida pasaron todos los controles.

<Note>
  La verificación **no** expone puntuaciones biométricas ni banderas separadas de liveness. El resultado consolidado vive en `status` (`success` o `failed`); cuando falla, `errorMessage` describe la causa. Consulta también los eventos de webhook granulares para saber en qué etapa se produjo el fallo.
</Note>

## Acceso a los frames de la selfie

Puedes recuperar las imágenes capturadas durante la prueba de vida mediante los endpoints de imágenes:

```bash theme={null}
# Listar todas las imágenes de una verificación
curl -X GET https://api.identity.vu-one.com/api/v1/verifications/6ba7b810-9dad-11d1-80b4-00c04fd430c8/images \
  -H "Authorization: Bearer <token>"

# Obtener una imagen específica por su ID
curl -X GET https://api.identity.vu-one.com/api/v1/verifications/images/3b4c5d6e-7f80-91a2-b3c4-d5e6f7081920 \
  -H "Authorization: Bearer <token>"
```

Los identificadores están en el objeto `images` de la verificación: `addFront` y `addBack` son las caras del documento, y el array `register` contiene los frames de la selfie tomados durante la prueba de vida, útiles para auditoría manual o revisión de casos borderline.

## Configuración de anti-spoofing a nivel de compañía

La bandera `antiSpoofing` de tu compañía controla si los controles anti-spoofing están activos. Es un ajuste administrado por VU y de solo lectura para la API: se expone dentro del bloque `company` de `GET /links/{id}`.

```bash theme={null}
curl -X GET https://api.identity.vu-one.com/api/v1/links/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer <token>"
```

<Note>
  `PATCH /users/me/company` no acepta `antiSpoofing`. Los ajustes de compañía que sí puedes modificar son `name`, `color`, `logo`, `linkConfig` y `verificationConfig`. Para cambiar la política anti-spoofing, contacta a tu responsable de cuenta en VU.
</Note>

<Tip>
  VU Identity Link utiliza tecnología de prueba de vida certificada iBeta Level 2, cumpliendo con los estándares más exigentes de la industria para prevenir ataques de presentación (PAD).
</Tip>

<Note>
  Si necesitas solo extracción de datos documentales sin verificación facial, crea siempre Links de tipo `ID ONLY`. Esto reduce la fricción para el usuario final en casos donde la biometría no es requerida.
</Note>


## Related topics

- [Identity Link API: guía de integración completa](/identity-link/introduccion.md)
- [Webhooks de Identity Link: eventos del ciclo de verificación](/identity-link/webhooks.md)
- [Documentación técnica de VU](/index.md)
- [VU Cloud Services](/vucs/introduccion.md)
- [Leer resultados KYC de verificaciones de identidad](/identity-link/kyc.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.