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 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.