Documentation Index

Fetch the complete documentation index at: https://docs.lobster-world.com/llms.txt

Use this file to discover all available pages before exploring further.

Web settings

Prev Next

Go to Administration > Base settings > Web.

Web view of Lobster Data Platform with fields for the separate http server, paths, threads, context path, security, GZIP compression, proxied paths, and HTTP response headers.

The Web view configures the web server of the Lobster Data Platform. The web server exposes the HTTP interfaces of the platform.

Click Apply to save your changes:

  • Immediate: changes take effect right away.

  • Cluster-wide: in a cluster, Apply propagates the changes to all nodes.

  • Persistent: the platform writes your values to the corresponding XML configuration. The settings persist after a system restart.

NOTE  When you save changes, the web server restarts in the background. The current connection drops, and the platform reconnects automatically. After a change to Server port or Context path, you may need to enter the URL again.

Fields

Field

Description

Separate http server

Runs _pro on a separate web server. When disabled, _pro shares the web server with _data.

Path to pro.xml1

Path to the configuration file pro.xml.

You can specify the path relative to the _pro home directory. Use the variable ${pro.home} for this.

The file must exist on the host and must be readable. In a cluster, this applies to all nodes.

Default: ${pro.home}/config/etc/pro.xml

Server port1

Port for the separate web server. The value must differ from the port of _data.

Default: 9080

Min. threads1

Minimum number of server threads.

Default: 10

Max. threads1

Maximum number of server threads.

Default: 500

Context path1

URL path under which the application is reachable.

On a separate web server, you can use the root context /. On a shared web server, choose a unique path such as /_pro. The path / is already used by _data.

Default: /

Force SSL

When enabled, the web server requires HTTPS for all incoming requests. Plain HTTP requests are rejected.

Default: disabled.

GZIP compression

Turns GZIP compression for HTTP responses on or off.

Default: enabled.

Proxied paths

List of path mappings that the separate web server forwards to the main server. Use this to expose selected paths of _data through the _pro web server.

Each entry has two parts:

  • Pattern (left field): the incoming path pattern. Use * as a wildcard, for example /partner/*.

  • Target (right field): the destination URL. Use the placeholder {MainServer} for the base URL of _data, for example {MainServer}/partner/.

Click + to add a mapping. Click the trash can to remove one.

Replaces the legacy fields Profile path (request) and Profile path (trigger).

Initial response headers

HTTP response headers that the web server sets on every response. Define each header as a name/value pair.

Click + to add a header. Click the trash can to remove one. See Add recommended headers below to populate this list with a recommended security baseline.

Custom response header

Additional HTTP response headers, added on top of Initial response headers. Define each header as a name/value pair.

Click + to add a header. Click the trash can to remove one. See Add recommended headers below to populate this list with a recommended security baseline.

1 Required only when Separate http server is enabled.

The Add recommended headers button sits at the bottom of the view. Click it to populate Initial response headers and Custom response header with a recommended HTTP security baseline. These headers typically lead to a Grade A rating in common security scanners.

The button appends the following entries to Initial response headers:

  • Content-Security-Policy: baseline policy starting with default-src 'none';

  • Permissions-Policy: fullscreen=(), geolocation=(), camera=()

  • X-Frame-Options: sameorigin

The button appends the following entries to Custom response header:

  • Access-Control-Allow-Origin: none

  • Referrer-Policy: strict-origin

  • Strict-Transport-Security: max-age=63072000

  • X-Content-Type-Options: nosniff

  • X-XSS-Protection: 1; mode=block

NOTE  The button appends to the existing lists. After clicking, review both lists. Remove duplicates and any entries that conflict with your configuration.