1. Documentation
  2. KissLog on-premises
  3. KissLog.Frontend
  4. Configuration

Configuration

KissLog.Frontend behavior can be customized by updating the Configuration\KissLog.json file.

A full example of the KissLog.json configuration file can be found here.

ApplicationName

Display name of the on-premises KissLog application - used when generating HTML titles.

{
    "ApplicationName": "My logging app"
}

StaticResourcesVersion

Property used as query string parameter when loading static resources (css/javascript).

This property should be changed after an application update in order to invalidate the static files cache.

{
    "StaticResourcesVersion": "1.0.0"
}

KissLogBackend.BasicAuth.Password

The Basic HTTP authentication scheme password used to connect to KissLog.Backend application.

This property should have the same value as the same property from KissLog.Backend\Configuration\KissLog.json.

{
    "KissLogBackend.BasicAuth.Password": "_This_Password_Should_Be_Replaced_"
}

KissLog.License

The KissLog on-premises license key. Can be null.

{
    "KissLog.License": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJMaWNlbnNlSWQiOiIzNTczMDI1My00NGRhLTRiZmMtOGQ0MS1iMzUzMDRkZWUyMzciLCJMaWNlbnNlVHlwZSI6IkVudGVycHJpc2UifQ.K4htH3YOulrpVrkTJuHza81VrYloYvTsfRYzb4fpUYI"
}

KissLogBackendUrl

Root url pointing to KissLog.Backend application.

{
    "KissLogBackendUrl": "http://kisslog-backend.myapp.com/"
}

KissLogFrontendUrl

Root url pointing to KissLog.Frontend application.

{
    "KissLogFrontendUrl": "http://kisslog.myapp.com/"
}

MediaDirectoryPath

Specifies the location of the media files uploaded within the application. Path can be either relative or absolute.

{
    "MediaDirectoryPath": ""
}

Database

{
    "Database": {
        "Provider": "MySql",
        "ConnectionString": "server=localhost;port=3306;database=KissLog_Frontend;uid={user};password={pass};Charset=utf8;"
    }
}

Database.Provider

MySql

Sets the database provider to MySql.

SqlServer

Sets the database provider to MS-SQL.

Authorization

{
    "Authorization": {
        "DefaultEmailDomain": "myapp.com",
        "HS256Secret": "J6UVNS3EKG46O1S1OVJ59OZ8DH3KEP",
        "SessionCookie": { },
        "ExternalIdentityProviders": { }
    }
}

Authorization.DefaultEmailDomain

Sets the default email domain for the authenticated users (used when displaying the logged-in user).

For example, user with name mike will be displayed in the user-interface as mike@myapp.com.

Authorization.HS256Secret

Represents the signature key of the authentication JSON Web Token (JWT).

The authentication JWT must be signed with the secret provided in this property.

More details about authentication can be found here.

SessionCookie

{
    "Authorization": {
        "SessionCookie": {
            "IsPersistentFixedValue": null,
            "ExpireInMinutes": 10080
        }
    }
}

SessionCookie.IsPersistentFixedValue

null

Allows the user to specify, at login page, if he/she wants to create a persistent cookie or not.

true

Authentication will create a peristent cookie.

The user will be remembered after he/she closes the browser.

false

Authentication will create a session cookie.

The user will need to sign in again after he/she closes the browser.

SessionCookie.ExpireInMinutes

Specifies the persistent cookie expiration time.

ExternalIdentityProviders

Configuration for external identity providers authentication.

{
    "Authorization": {
        "ExternalIdentityProviders": {
            "AzureActiveDirectory": { }
        }
    }
}

AzureActiveDirectory

Configuration options for Azure ActiveDirectory authentication option.

{
    "Authorization": {
        "ExternalIdentityProviders": {
            "AzureActiveDirectory": {
                "ClientId": "eb042044-cb75-49a3-a73d-493250cf0017",
                "ClientSecret": "sM95AEDVJwh28qYRJWkyWCvFUYHAnPYHmC",
                "Authority": "https://login.microsoftonline.com/299de8ce-0c07-49d3-bea7-3b8b8bd3d2c9/v2.0/"
            }
        }
    }
}

Smtp

SMTP configuration used for sending automated emails (alert notifications).

{
    "Smtp": {
        "Host": "smtp.sendgrid.net",
        "Port": 587,
        "UserName": "",
        "Password": "",
        "EnableSsl": false,
        "From": {
            "Address": "support@kisslog.net",
            "DisplayName": "KissLog"
        }
    }
}

UserInterface

{
    "UserInterface": {
        "ForceAvatarSrc": null,
        "CreatePermalinkWithAnonymousAccess": { },
        "Applications": { },
        "Dashboard": { }
    }
}

UserInterface.ForceAvatarSrc

When a value is provided, the user avatars (displayed in the user-interface) will always use this value.

This is useful when you need to prevent any external resources loading.

null

User avatars will be generated using Gravatar (default).

some_value

User avatars will always load the provided value: <img src="some_value" />

CreatePermalinkWithAnonymousAccess

{
    "UserInterface": {
        "CreatePermalinkWithAnonymousAccess": {
            "IsEnabled": true,
            "ValidForSeconds": 7200
        }
    }
}

CreatePermalinkWithAnonymousAccess.IsEnabled

true

Permalinks created from the user interface (links to request logs) can be anonymously accessed for a limited period of time.

false

Permalinks created from the user interface can be accessed only by authenticated users.

CreatePermalinkWithAnonymousAccess.ValidForSeconds

Required when “CreatePermalinkWithAnonymousAccess.IsEnabled” is “true”.

Specifies for how long after creation the permalink can be anonymously accessed.

Applications

{
    "UserInterface": {
        "Applications": {
            "LoadHowMany": 6
        }
    }
}

Applications.LoadHowMany

Specifies how many applications should be preloaded under the /Applications section.

Dashboard

{
    "UserInterface": {
        "Dashboard": {
            "ShowReferringSites": true
        }
    }
}

ShowReferringSites

true

The list of individual referring sites will be visible under the Dashboard page.

false

The list of individual referring sites will not be visible under the Dashboard page.