Especificações técnicas

1. Introdução

Facephi INE Service é um serviço REST API em C++ ao qual podem ser enviados arquivos de imagem para seu processamento e obter o resultado do processo de reconhecimento facial. O serviço oferece um endpoint para autenticar duas fotos faciais.

2. Requisitos de hardware

	Requisito mínimo	Requisito recomendado
CPU	2 núcleos com suporte para o conjunto de instruções SSE4.2, >=2GHz	16 núcleos, com suporte à ISA AVX2
RAM	4 GB	8 GB
Disco	4 GB	SSD 4 GB
Rede	100 Mbps	1 Gbps

3. Requisitos de software

• Linux x86_64 (Ubuntu 24.04 ou superior) com Docker 24.0 ou superior.

• Imagem do contêiner em tempo de execução baseada em Ubuntu 26.04.

4. Versão do SDK

A versão atual do SDK é SelphID SDK 6.20.0.

5. Endpoints REST

O serviço expõe os seguintes endpoints:

• POST /api/v1/facial/authentication

• GET /api/v1/health

• GET /api/v1/version

O serviço não expõe endpoints GET/POST /config em tempo de execução.

6. Autenticação JWT

A autenticação JWT é opcional e está desabilitada por padrão. Quando está habilitada, o serviço valida tokens HS256 com um claim exp não expirado.

Chaves de inicialização:

• auth_enabled

• auth_jwt_secret

• auth_accept_authorization_header

• auth_accept_api_key_header

• auth_api_key_header_name

Variáveis de ambiente de sobrescrita:

• FACEPHI_INE_REST_AUTH_ENABLED

• FACEPHI_INE_REST_AUTH_JWT_SECRET

• FACEPHI_INE_REST_AUTH_ACCEPT_AUTHORIZATION_HEADER

• FACEPHI_INE_REST_AUTH_ACCEPT_API_KEY_HEADER

• FACEPHI_INE_REST_AUTH_API_KEY_HEADER_NAME

Endpoints públicos acessíveis sem autenticação:

• GET /api/v1/health

• GET /api/v1/version

• Solicitações de preflight OPTIONS

Endpoint protegido:

• POST /api/v1/facial/authentication

A configuração da autenticação JWT só pode ser definida na inicialização, já que o serviço não expõe endpoints de configuração em tempo de execução.