Configuration

The configuration file, located at %ProgramFiles%\\Megaladata\Client\server.json, specifies the URL for connecting to the Megaladata Server.

Default values:

{
    "wsport": null,
    "host": null
}

Resulting URL:

• http: ws://web-server-host:8080
• https: wss://web-server-host:8443

The encryption of the ws protocol is determined by the presence of http encryption.

Parameters

host

The address of the Megaladata server host. If the value is null, the web server host address is used.

{
    "wsport": null,
    "host": "md.domain.org"
}

Resulting URL:

• http: ws://md.domain.org:8080
• https: wss://md.domain.org:8443

wsport

The port for connecting via the websocket protocol. If the value is null, port 8080 is used.

{
    "wsport": 9999,
    "host": null
}

Resulting URL:

• http: ws://web-server-host:9999
• https: Unsecured websocket connections are prohibited.

wssport

The port for connecting via the websocket secure protocol. If the value is null, port 8443 is used.

{
    "wssport": 9443,
    "host": null
}

Resulting URL:

• wss://web-server-host:9443

wsproxy

Connecting to the Megaladata server via a websocket proxy. In this case, host and wsport|wssport will be the same as the host address and the web server port.

{
    "wsproxy": true,
    "host": null
}

Resulting URL:

• ws://web-server-host:443/ws/

path

The connection path to WebSocket when using wsproxy. Default is ws/.

{
    "wsproxy": true,
    "path": "any/",
    "host": null
}

Resulting URL:

• wss://web-server-host:443/any/

secure

Always use encryption when connecting to the Megaladata server.

If the parameter is not specified, when connecting to the web server via http, the connection to the Megaladata server will be unencrypted.

If the parameter is set to true, the connection will always be encrypted—using the websocket secure protocol on port wssport.

{
    "host": "megaladata-server-host",
    "secure": true
}

Resulting URL:

• without wsproxy: wss://megaladata-server-host:8443
• with wsproxy: wss://web-server-host:443/ws/

openid

This parameter defines the OpenID authentication mode. If you do not specify the parameter or set it to auto, the system will request OpenID parameters from the server when you access the login page. This determines whether external authentication is possible and whether the Login with OpenID button is displayed.

If you set the parameter to none or false, the system will not request OpenID configuration. As a result, OpenID authentication will be unavailable, and the Login with OpenID button will not appear.

If you set the parameter to force, the system will immediately redirect the user to the external OpenID authentication page. If authentication fails, the login page will reappear with an error message. Local authentication remains available only if you include the username and password in the Megaladata Server connection URL.

Important: For Team and Standard editions, the value of openid can only be none; for Megaladata Enterprise, the parameter is not set by default.

Read on: Megaladata Desktop for Windows