Configurar o NDD Print Host Proxy Reverse | Help Center

Configuração do arquivo appsettings.json

As configurações deste módulo estão localizadas em um arquivo chamado appsettings.json.
Esse arquivo reúne todos os parâmetros necessários para configurar o NDD Print Host Proxy Reverse conforme o ambiente de instalação.

Localização do arquivo

Após a instalação, o arquivo appsettings.json ficará disponível no seguinte diretório:

C:\Program Files\NDDigital\nddPrint\HostProxyReverse\Host.FilesReceiver

Existem outros arquivos appsettings.json em pastas diferentes, mas apenas este deve ser usado para configurar o módulo.

Estrutura do arquivo

A estrutura é organizada de forma que cada feature possua parâmetros específicos, permitindo a alteração conforme a necessidade.
A seguir, estão descritas as principais features e suas funções.

Kestrel

Assumirá as portas anteriormente gerenciadas pelo Nancy. Assim, todas as requisições do NDD Print Agent serão capturadas pelo proxy e encaminhadas para as portas definidas na instalação dos novos serviços. Esses serviços (NDD Print Host NPL Receiver e NDD Print Host NSL Receiver) processarão os pacotes de informação.

Não altere esse parâmetro exceto em caso de conflito de portas.

RateLimiting

Mecanismo de limitação de taxa de requisições que controla a quantidade permitida, prevenindo sobrecarga ou abuso (ex.: DDoS ou excesso de chamadas).

Parâmetros:

Parâmetro	Descrição	Valor padrão
PermitLimit	Número de requisições permitidas no intervalo definido.	2
WindowSeconds	Intervalo de tempo (em segundos) para contagem das requisições.	1
QueueLimit	Quantidade máxima de requisições que podem aguardar na fila.	0

Exemplo:

Com os valores padrão, são permitidas 2 requisições a cada 1 segundo, sem fila adicional.

SerilogEnabled

Flag para ativar a função de log da aplicação, que captura e registra dados de log.

Configuração:

False → Desativado (padrão)
True → Ativado, com geração de logs estruturados.

Local dos logs:

Quando habilitado (True), os registros são gravados em:

C:\Windows\Temp\NDDigital\nddPrint\Host\Traces

Configuração necessária

É necessário que as chaves do registro estejam configuradas corretamente para garantir o funcionamento adequado do processamento.

Chave	Descrição
NplConsolitationInterval	Define o intervalo de processamento dos arquivos NPL.
NplNslSendInterval	Define o intervalo de processamento dos arquivos NSL.
LogTransformEnabled	Quando definido como `true`, move os arquivos da pasta `tempNplPrintLogs` para a pasta `Logs`. Recomendação: manter desativado, pois o Files Receiver já é responsável por essa movimentação.
ProxyReverseApiEnabled	Quando definido como `true`, habilita a nova rotina de processamento dos arquivos NPL.
EnabledRetryNPLProcess	Quando definido como `true`, habilita o reprocessamento dos arquivos que foram movidos para a pasta error.
NPLRetryConsolidationLimit	Define a quantidade máxima de arquivos que serão reprocessados.
EnableConsolidateBigFiles	Quando definido como `true`, habilita a consolidação de arquivos grandes.

Configurações adicionais

Parâmetro	Descrição	Valor Padrão
SerilogEnabled	Habilita o registro de logs e erros.	`false`
ProxyReverseApiEnabled	Habilita a utilização do Proxy Reverse para o processamento dos arquivos.	`false`
NplFileBigLengthMb	Tamanho máximo (em MB) para que um arquivo NPL seja considerado "grande".	`10`
NslFileBigLengthMb	Tamanho máximo (em MB) para que um arquivo NSL seja considerado "grande".	`10`
TimerLogTransformInSeconds	Intervalo (em segundos) para mover arquivos da pasta `TempNplPrintLogs` para `Logs`.	`300,//5 minutos`
MaxFilesToTransfer	Quantidade máxima de arquivos transferidos por execução.	`2000`
DeleteErrorFiles	Quando `true`, remove automaticamente arquivos que apresentarem erro durante o processamento.	`false`
TimerRemoveBigFilesInSeconds	Intervalo (em segundos) para a limpeza de arquivos grandes que não serão consolidados.	`120,//2 minutos`
DeleteBigFiles	Quando `true`, remove arquivos cujo tamanho excede o limite configurado.	`false`
MaxBigFilesToRemove	Quantidade máxima de arquivos grandes removidos por execução.	`20`

Atenção:

Recomenda-se manter essas configurações com os valores padrão. Realize alterações apenas se houver necessidade específica do servidor; nesse caso, entre em contato com o suporte técnico para análise.

Last updated: July 14, 2026