Configuring the appsettings.json file
The settings for this module are located in a file named appsettings.json.
This file contains all the parameters needed to configure the NDD Print Host Proxy Reverse according to the installation environment.
File location
After installation, the appsettings.json file will be available in the following directory:
C:\Program Files\NDDigital\nddPrint\HostProxyReverse\Host.FilesReceiver
There are other appsettings.json files in different folders, but only this one should be used to configure the module.
File Structure
The structure is organized so that each feature has specific parameters, allowing them to be modified as needed.
The main features and their functions are described below.
Kestrel
will take over the ports previously managed by Nancy. Thus, all requests from the NDD Print Agent will be captured by the proxy and forwarded to the ports defined during the installation of the new services. These services (NDD Print Host NPL Receiver and NDD Print Host NSL Receiver) will process the data packets.
Do not change this setting unless there is a port conflict.
Rate Limiting
A mechanism that limits the rate of requests to control the allowed quantity, preventing overload or abuse (e.g., DDoS attacks or excessive calls).
Parameters:
|
Parameter |
Description |
Default value |
|---|---|---|
|
PermitLimit |
Number of requests allowed within the specified range. |
2 |
|
WindowSeconds |
Time interval (in seconds) for counting requests. |
1 |
|
QueueLimit |
Maximum quantity of requests that can be queued in a queue. |
0 |
Example:
With the default settings, 2 requests are allowed every second, with no additional queue.
SerilogEnabled
Flag to enable the application's logging feature, which captures and records log data.
Configuration:
-
False → Disabled (default)
-
True → Enabled, with structured logging.
Local dos logs:
When enabled (True), records are written to:
C:\Windows\Temp\NDDigital\nddPrint\Host\Traces
Required Configuration
The registry keys must be configured correctly to ensure that processing works properly.
|
Key |
Description |
|---|---|
|
NplConsolitationInterval |
Sets the processing interval for NPL files. |
|
NplNslSendInterval |
Sets the processing interval for NSL files. |
|
LogTransformEnabled |
When set to Recommendation: Keep it disabled, since Files Receiver is already responsible for this activity. |
|
ProxyReverseApiEnabled |
When set to |
|
EnabledRetryNPLProcess |
When set to |
|
NPLRetryConsolidationLimit |
Sets the maximum quantity of files to be reprocessed. |
|
EnableConsolidateBigFiles |
When set to |
Configurações adicionais
|
Parameter |
Description |
Default Value |
|---|---|---|
|
SerilogEnabled |
Enables logging and error logging. |
|
|
ProxyReverseApiEnabled |
Enables the use of a Reverse Proxy for file processing. |
|
|
NplFileBigLengthMb |
Maximum size (in MB) for an NPL file to be considered “large.” |
|
|
NslFileBigLengthMb |
Maximum size (in MB) for an NSL file to be considered “large.” |
|
|
TimerLogTransformInSeconds |
Interval (in seconds) for moving files from the |
|
|
MaxFilesToTransfer |
Maximum quantity of files transferred per run. |
|
|
DeleteErrorFiles |
When set to |
|
|
TimerRemoveBigFilesInSeconds |
Interval (in seconds) for cleaning up large files that will not be consolidated. |
|
|
DeleteBigFiles |
When set to |
|
|
MaxBigFilesToRemove |
Maximum quantity of large files removed per run. |
|
Note:
We recommend keeping these configurations at their default values. Make changes only if there is a specific requirement for the server; in that case, please contact technical support for review.