Development tools component

Table of contents

Description

This component adds debug/development functionality to the Runtime:

• A dashboard to start application and manage the server (settings),
• session debug tools to debug/inspect the current running session,
• a connection to Studio to start applications modelled in Studio.

Installation

This component is enabled by default, but can be disabled:

To disable this component, the development-tools profile should be disabled. More information on how to configure the application using Spring Profiles can be found here : Application configuration with Spring Profiles.

Configuration

Shortcut properties

To enable editing of shortcut properties create a file named application-shortcuts.properties in the Blueriq config location. Enable the shortcuts Spring profile to make the properties available to the Runtime.

Runtime user properties

To enable editing of Runtime user properties create a file named users.properties in the Blueriq config location. You can configure editing behaviour by adding properties to application-development-tools.properties

# When true, user property passwords will be cryptographically hashed when stored
blueriq.development.user-properties.store-password-hashed=true

Usage

See the cookbook Using the development dashboard for more information.

Content Security Policy

When using the development tools component, and therefore the development tools dashboard and toolbar, it is required to have the default development tools CSP header configured. When overriding the CSP header else outside of the Blueriq Runtime it is possible that the development tools dashboard and toolbar will not work as expected. For more information please visit the Security: Clickjacking protection page.

Using the development tools with HTTPS

When using https when accessing the runtime and development tools some http headers has to be set in the reverse proxy, for more info : Using a reverse proxy server