Serviço INE

Facephi INE Service é um serviço de API REST em C++ que permite realizar Verificação de Identidade por meio de Reconhecimento Facial. O serviço é baseado no SDK SelphID, tecnologia desenvolvida por FacePhi. Implementa a especificação de Mexipay-INE (Instituto Nacional Eleitoral) do México.

O serviço expõe os seguintes endpoints:

• POST /api/v1/facial/authentication

• GET /api/v1/health

• GET /api/v1/version

Os formatos de imagem suportados são:

• INE (0)

• JPEG (1)

• TEMPLATE RAW (2)

• BEST IMAGE TOKEN (3)

A distribuição principal do serviço é um contêiner Docker baseado em Ubuntu 26.04.

Autenticação JWT

A autenticação JWT é opcional e está desabilitada por padrão.

• É configurado ao iniciar o serviço em config.json com auth_enabled, auth_jwt_secret, auth_accept_authorization_header, auth_accept_api_key_header e auth_api_key_header_name.

• Os mesmos valores podem ser substituídos pelas variáveis de ambiente FACEPHI_INE_REST_AUTH_*.

• GET /api/v1/health e GET /api/v1/version permanecem públicos.

• POST /api/v1/facial/authentication requer um JWT válido quando a autenticação está habilitada.

• O serviço não expõe endpoints GET/POST /config em tempo de execução, por isso a configuração JWT só pode ser definida ao iniciar.