> 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/ine.md).

# INE Service

**Facephi INE Service** es un servicio REST API en C++ que permite realizar verificación de identidad mediante reconocimiento facial. El servicio está basado en el SDK SelphID, tecnología desarrollada por FacePhi. Implementa la especificación de Mexipay-INE (Instituto Nacional Electoral) de México.

El servicio expone los siguientes endpoints:

* `POST /api/v1/facial/authentication`
* `GET /api/v1/health`
* `GET /api/v1/version`

Los formatos de imagen soportados son:

* INE (0)
* JPEG (1)
* TEMPLATE RAW (2)
* BEST IMAGE TOKEN (3)

La distribución principal del servicio es un contenedor Docker basado en Ubuntu 26.04.

### Autenticación JWT

La autenticación JWT es opcional y está deshabilitada por defecto.

* Se configura al arrancar el servicio en `config.json` con `auth_enabled`, `auth_jwt_secret`, `auth_accept_authorization_header`, `auth_accept_api_key_header` y `auth_api_key_header_name`.
* Los mismos valores se pueden sobrescribir con las variables de entorno `FACEPHI_INE_REST_AUTH_*`.
* `GET /api/v1/health` y `GET /api/v1/version` permanecen públicos.
* `POST /api/v1/facial/authentication` requiere un JWT válido cuando la autenticación está habilitada.
* El servicio no expone endpoints `GET/POST /config` en tiempo de ejecución, por lo que la configuración JWT solo puede establecerse al arrancar.