> 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/sdks/backend-sdk/iad/release_notes/2.0.0_release_notes.md).

# 2.0.0

**Fecha de lanzamiento:** 25 de mayo de 2026

## Resumen general

**Facephi IAD Service 2.0.0** es una versión mayor que introduce un nuevo contrato REST público para los flujos de liveness y extracción. Esta versión **no es retrocompatible** con la serie 1.x.x.

## Cambios incompatibles

### Cambios en los endpoints públicos

| Endpoint 1.x.x                   | Endpoint 2.0.0                       |
| -------------------------------- | ------------------------------------ |
| `POST /api/v1/iad/check-capture` | `POST /api/v1/iad/liveness/evaluate` |
| `POST /api/v1/iad/extract-image` | `POST /api/v1/iad/extract`           |

### Cambios en el contrato multipart

* Las solicitudes multipart ahora requieren el campo `capture`.
* Las solicitudes que solo incluyen el campo heredado `file` sin `capture` son rechazadas.

### Cambios en el payload de éxito

* Los payloads de éxito públicos ahora exponen campos de estilo Facephi como `diagnostic`, `reason`, `probability`, `score`, `faceProbability`, `sdkDuration` y `queueDuration`.
* Los campos heredados con forma de Engine, como `capture_liveness`, `capture_type`, `rejection` y `mime_type`, ya no se devuelven en las respuestas públicas de éxito.

## Novedades

### Normalización del contrato público

* Las respuestas de liveness se mapean a un contrato público estable centrado en los campos de integración de Facephi.
* Los valores públicos de `reason` de liveness se documentan explícitamente como `None`, `Unknown`, `UntrustedEnvironment`, `SuspiciousActivity`, `UntrustedDevice`, `SdkIntegrityViolation`, `UntrustedCorruptedPayload`, `UntrustedContent` y `UntrustedContentLowConfidence`.
* Los errores de validación de captura se normalizan a valores de estilo Facephi/SelphID.

### Mitigación experimental de ataques de repetición (replay)

* El servicio puede aplicar una ventana de vigencia (freshness window) a los payloads de captura entrantes.
* Las variables de entorno de inicio `FACEPHI_IAD_REPLAY_ATTACK_CHECKER_ENABLED` y `FACEPHI_IAD_REPLAY_ATTACK_TOLERANCE_TIME` activan y configuran la funcionalidad.
* La ventana de vigencia por defecto es de `300` segundos.
* Cuando se supera la ventana de vigencia, los endpoints de procesamiento de capturas devuelven HTTP `400` con `message` igual a `Replay attack detected`.

### Fiabilidad y comportamiento en tiempo de ejecución

* Los fallos de arranque del servicio se propagan a `main` en lugar de terminar desde los componentes internos de arranque.
* El manejo de señales ya no realiza operaciones no seguras para señales, como logging, lógica de apagado o `std::exit`, directamente desde los manejadores.

### Aseguramiento de calidad

* Se añadieron pruebas unitarias para el mapeo del payload de éxito público y la prevención de fugas de campos privados.
* Se añadieron pruebas unitarias para verificar el comportamiento del campo multipart obligatorio `capture`.

## Guía de migración (desde 1.x.x)

1. Actualiza las rutas de los endpoints en las integraciones cliente.
2. Cambia el nombre del campo de formulario multipart de `file` a `capture`.
3. Actualiza el análisis de las respuestas para las solicitudes de liveness correctas de forma que usen los nuevos campos públicos.
4. Valida el comportamiento de la integración con `GET /api/v1/iad/version` y pruebas de extremo a extremo en tu entorno.

## Despliegue

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:2.0.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name iad-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:2.0.0
```

## Requisitos

| Componente        | Requisito                                  |
| ----------------- | ------------------------------------------ |
| Sistema operativo | Linux x86\_64 (se recomienda Ubuntu 24.04) |
| Licencia          | Archivo de licencia válido de Facephi      |
| Docker            | Para el despliegue en contenedores         |

## Soporte

Para soporte técnico, contacta con tu representante de Facephi.

## Documentación

* [Referencia de configuración](/sdks/backend-sdk/iad.md)
* [Guía de instalación](/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [Referencia de la API](/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Registro de cambios](/sdks/backend-sdk/iad/changelog.md)