--- title: "Configurações de biometria - Rest PKI Core" description: "Configurações de biometria do Rest PKI Core em instâncias on-premises: lote de cadastro biométrico (ConcurrentEntriesPerBatch, MaxAttemptsPerEntry, PauseDuration) e o job que cuida dos lotes." canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/settings/biometrics" locale: "pt-BR" product: "Rest PKI Core" last_updated: "2026-10-20" --- # Configurações de biometria - Rest PKI Core ## Configurações *EnrollmentBatch* (v4.1.0) Estas configurações controlam o cadastro biométrico em massa de subjects a partir de um arquivo ZIP de imagens de face, uma imagem por subject. Cada imagem é uma *entrada* (entry) do lote. O tamanho máximo do arquivo ZIP é o limite geral de upload da aplicação, `General:MaxFileSize` (padrão `104857600` (100 MiB)): aumente-o para importar lotes maiores. O arquivo é enviado em segmentos de 2 MiB ou 5 MiB, conforme o provider de blob storage, portanto `General:MaxRequestBodySize` (padrão 136 MiB) não pode ficar abaixo disso. Na seção **Bio:EnrollmentBatch**: * **MaxFileLengthOnInMemoryStorage** (v5.1.0, padrão: `1073741824` (1 GiB)): tamanho máximo, em bytes, do arquivo ZIP quando o provider de [blob storage](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/configure-blob-storage) configurado carrega o arquivo inteiro em memória a cada leitura (os providers Google Cloud Storage e Database). Quando se aplica, vale o menor entre este valor e `General:MaxFileSize`, e um arquivo maior é recusado por exceder o tamanho permitido. Use `0` para não ter limite adicional. * **UploadTicketLifetime** (v5.1.0, padrão: `7.00:00:00` (7 dias)): quanto tempo um upload pode levar, desde o início até a criação do lote a partir dele. Depois disso o upload é descartado e precisa ser refeito. Formato: `d.hh:mm:ss`. * **EntryMaxLength** (v4.1.0, padrão: `26214400` (25 MiB)): tamanho máximo, em bytes, de cada imagem do arquivo ZIP. Uma entrada com imagem maior não é cadastrada e é reportada como grande demais. * **EntriesInsertBulkSize** (v4.1.0, padrão: `1000`): quantidade de entradas que a aplicação grava de cada vez no banco de dados enquanto carrega as entradas de um novo lote. * **DatabaseCooldownTime** (v4.1.0, padrão: `00:00:01` (1 segundo)): intervalo entre cada uma dessas gravações no banco de dados, para limitar a carga sobre ele. Formato: `d.hh:mm:ss`. * **ConcurrentEntriesPerBatch** (v5.1.0, padrão: `1`): quantidade de entradas de um mesmo lote enviadas ao provedor biométrico ao mesmo tempo. Aumente conforme a capacidade do provedor. Um lote é sempre processado por uma única instância da aplicação, portanto adicionar instâncias não aumenta esse número para um lote. * **MaxAttemptsPerEntry** (v5.1.0, padrão: `5`): quantidade de tentativas de cadastrar uma entrada que falha com um erro temporário (por exemplo, uma chamada ao provedor biométrico estoura o timeout). Quando todas as tentativas falham, a entrada é reportada como falha após as novas tentativas, e é reprocessada se o lote for retomado depois de concluído. * **RetryBackoff** (v5.1.0, padrão: `00:00:30` (30 segundos)): espera antes de tentar novamente uma entrada que falhou com um erro temporário. A espera é multiplicada pelo número da tentativa, então a segunda nova tentativa espera o dobro da primeira. Formato: `d.hh:mm:ss`. * **EntryTimeout** (v5.1.0, padrão: `00:02:00` (2 minutos)): tempo máximo para todas as chamadas ao provedor biométrico de uma entrada. Uma entrada que o excede é tratada como erro temporário e tentada novamente. Valores abaixo de 1 segundo são elevados para 1 segundo, e valores acima de 5 minutos são reduzidos para 5 minutos. Formato: `d.hh:mm:ss`. * **PauseAfterConsecutiveTransientFailures** (v5.1.0, padrão: não definido): quantidade de erros temporários consecutivos, dentro de uma execução do lote, após a qual o lote entra em pausa em vez de tentar as demais entradas. Quando não definido, é 3 vezes `ConcurrentEntriesPerBatch` (3 com o padrão). Valores abaixo de `1` são tratados como `1`. * **PauseDuration** (v5.1.0, padrão: `00:05:00` (5 minutos)): quanto tempo um lote espera antes de continuar após entrar em pausa. A espera é multiplicada pelo número de execuções consecutivas sem progresso, até `MaxPauseDurationMultiplier`. Formato: `d.hh:mm:ss`. * **MaxPauseDurationMultiplier** (v5.1.0, padrão: `6`): valor máximo do multiplicador aplicado a `PauseDuration`. Com os valores padrão, a espera cresce de 5 até no máximo 30 minutos. * **MaxConsecutiveRunFailures** (v5.1.0, padrão: `10`): quantidade de execuções consecutivas sem progresso após a qual o lote é suspenso. Um lote suspenso só volta a ser processado quando um usuário o retoma ou o aborta no dashboard. * **MaxRunDuration** (v5.1.0, padrão: `00:03:00` (3 minutos)): quanto tempo uma execução de um lote trabalha em novas entradas antes de passar a vez para um novo job em segundo plano; as entradas já em andamento são concluídas antes. Encerrar uma execução dessa forma não é uma pausa e não conta como execução sem progresso, a menos que nenhuma das entradas processadas tenha chegado a um resultado. Valores abaixo de 1 segundo são elevados para 1 segundo. O limite superior é 10 minutos menos o `EntryTimeout` menos 1,5 minuto (6,5 minutos com o `EntryTimeout` padrão), e valores maiores são reduzidos a ele. Formato: `d.hh:mm:ss`. * **ProgressLogInterval** (v5.1.0, padrão: `1000`): quantidade de entradas processadas entre as linhas de progresso no log da aplicação, que mostram a taxa de processamento e o tempo estimado para a conclusão. ## Configurações *JobSchedules* Na seção **JobSchedules**: * **SweepBioEnrollmentBatches** (v5.1.0, padrão: `*/10 * * * *`): agendamento, como expressão cron, do job em segundo plano que cuida dos lotes de cadastro biométrico. Ele retoma lotes cujo processamento foi interrompido e remove cópias de arquivos de lote que nenhum lote usa mais. Por padrão, executa a cada 10 minutos.