KissLog.Frontend

About

KissLog.Frontend is a user-interface application used by developers to visualize the captured errors, logs and other metrics data.

KissLog.Frontend is generating the user-interface by consuming KissLog.Backend REST endpoints.

Authentication

KissLog.Frontend uses a JSON Web Token (JWT) for authentication.

The authentication JWT must be signed with the value provided at $.Authorization.HS256Secret property from the KissLog.json configuration file.

For the default value of $.Authorization.HS256Secret, you can use the following authentication JWT:

# $.Authorization.HS256Secret:
# 00000000-0000-0000-0000-000000000000-00000000-0000-0000-0000-000000000000

# Authentication token:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.HP79qro7bvfH7BneUy5jB9Owc_5D2UavFDulRETAl9E

Creating the JWT

The authentication JWT can be created programmatically or online (using https://jwt.io/, for example).

Generating authentication JWT
KissLog.Frontend login page

User name

Authenticated user name is used for display purposes only, and it can be specified in one of the following options:

  • at the end of the JWT, appended as @user_name

# Authentication token:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.HP79qro7bvfH7BneUy5jB9Owc_5D2UavFDulRETAl9E@user_name
  • in the JWT payload using any of these claims: “emailAddress”, “email”, “preferred_username”, “name”

Auto-login

You can automate the login process by directly passing the Authentication token in the login url, using the token=value query string parameter.

# Authentication url:
http://localhost:44080/Auth/Login?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.HP79qro7bvfH7BneUy5jB9Owc_5D2UavFDulRETAl9E

Bookmarking this url will allow for a faster login process.

Azure Active Directory

If $.Authorization.AzureActiveDirectory is configured, you can login using the Azure Active Directory OAuth flow.

KissLog.Frontend Azure Active Directory login option

For technical support, questions or any feedback, please feel free to send us a message and we will get back to you.