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.