Insight App preconfiguration

The Insight clients can be preconfigured. On iOS and Android, this is done via an MDM server. On Windows, a local config.json file is stored in the installation directory.

Recommendation

Only the settings necessary for the initial connection/login should be stored in the config.json. The entire settings are stored in the config.json on the server.

Insight Mobile App Configuration

The Insight Mobile App can be configured via a Mobile Device Management System (MDM). The most important function is pre-assigning the server URL or config.json content.

We cannot test all MDM systems, but there is the AppConfig Community, whose members could be supported. Microsoft Intune is not listed, but has already been successfully tested.

The configuration is appended to the user profile on the client side and can be queried using userData.emmAppConfig.

Parameters

Parameter	Example	Description
insightClientConfigUrl	https://customer-server.com	Fixed configuration of the server URL.
insightClientConfigUrl1	https://external.customer-server.com	Overwrites insightClientConfigUrl.
insightClientConfigUrl2	https://internal.customer-server.com	Overwrites insightClientConfigUrl and insightClientConfigUrl1.
insightClientConfig	{"server":"https://customer-server.com","oidc":{"clientId":"insight-app","server":"https://customer-idp.com"}}	Initial client config (config.json content)
insightUser	${username}	The login user can be pre-assigned on the login screen. Only works without OIDC.
insightProfile		Placeholder, not currently in active use.

Insight Electron App Configuration

Insight Electron for Windows can be preconfigured via config.json. The config.json must be stored in a customer-config folder in the installation directory of the Electron client.

Example folder structure:

├─ insight-client
|   ├─ insight-electron.exe
|   └─ customer-config
|       └─ config.json

Example config.json

{
  "server": "https://customer-server.com"
}

Example config.json with oidc

{
  "eamType": "standalone",
  "server": "https://customer-server.com",
  "oidc":{
    "clientId":"insight-app",
    "server":"https://customer-idp.com",
    "scope": "openid"
  }
}

Handle multiple environments