White Papers

Name Required Description
for longer than the time specified, it is closed, and a
new log file is opened.
MaxFileAge Yes The time log files persist in the output folder. Files
older than this time period, specified in days, are
deleted.
The Kestrel element details the TLS connection. The following table details the Kestrel components:
Name Required Description
Endpoints Yes Details for the container listening ports.
Http / Https Yes Protocol definitions for the docker listening ports.
Pathbase Yes URI relative path with respect to the container (/
devicesvr/api/v1).
Url Yes The container protocol and listening port ( https://
*:5001").
Certificate Yes Details of the certificate used for TLS connections to
the container.
Path The location of the PKCS12 certificate (/app/certs/
test.pfx).
Password Yes Password to the PKCS12 certificate.
Use a text editor to configure the required elements. See the appsettings.json below with configurable examples in bold/italics :
{
"https port":443,
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft": "Warning",
"Microsoft.Hosting.Lifetime": "Information"
}
},
"Tenant": {
"TenantName": "
ExampleTenant ",
"TenantApiKey": " ExampleTenantKey ",
"TenantUUID": " 5568165d-216a-4631-a115-80de74f294fd ",
"SigningCertificate": {
"IssuerPublicCertsPem": " ExampleCertificate or Docker container path to the public key
certificate
",
"IssuerPrivateKeyPem": " ExampleCertificate or Docker container path to the private key " },
"JwtCertificate": {
"TrustedRootsPem": " ExampleCertificate or or the Docker container path to the trust chain of the
signing certificate
" }
},
"Upload": {
"BaseFileName": " SIEM_Output ",
"OutputLocation": " /var/dataEventRepository ",
"MaxFileSizeMb":
15 ,
"MaxActiveFileDays": 1 ,
"MaxFileAge":
3
}
},
"Kestrel": {
"Endpoints": {
"Http": {
"PathBase": “ /devicesvc/api/v1” ,
"Url”: “ http://*:5000 ”
},
"Https": {
"PathBase": “
/devicesvc/api/v1" ,
"Url": " http://*:5001 ",
28
Integration