Dell Trusted Device Installation and Administrator Guide v5.5

PDF

Customize the API URIs

If your organization requires custom API notation, use the following example to customize the API URIs for your Event Repository.

NOTE: If the Version element is not included in your appsettings.json, default URI values for Device Registration, Event Posting, and Health are applied.

Table 1. URIs
Name	Required	Description
Device Registration	Yes	The URI through which the Trusted Device agent registers with the Event Repository.
Event Posting	Yes	The URI through which the Trusted Device agent sends events to the Event Repository.
Health	Yes	The URI that prints the health status of the Event Repository to a browser.

Use a text editor to configure the required elements. See the appsettings.json below with configurable examples in bold

{
    "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 the Docker container path to the public key certificate",
            "IssuerPrivateKeyPem": "ExampleCertificate or the Docker container path to the private key"
        },
        "JwtCertificate": {
            "TrustedRootsPem": "ExampleCertificate 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",
                "Certificate": {
                    "Path": "/app/certs/test.pfx",
                    "Password": "Password@123"
                }
            }
        }
    },
    "AppSettings": { 
        "Version": 2, 
        "UrlPrefix": {
            "Health": {"Prefix":"path/to/health"},
            "Registration": {"Prefix":"path/to/registration"},
            "EventUpload": {"Prefix":"path/to/eventupload"} 
        } 
    }
}