Fields

Default Printer

The default printer to use when printing and creating pdf disk files via the web service. Options available are generated from the machine web service running on.

Default Records per Response

The default number number of records in a set that will be returned. For large datasets this should be set to 2000.

Max Records per Response

The maximum number of records in a set that will be returned. Once the maximum is reached, following records can be returned in the next set. For large datasets this should be set to 2000.

Max Workers

The maximum number of worker processes that can be started. If Blank, the maximum allowed will be set to the server's CPU Core Count * 2. This is always capped to the number of web sessions allowed for the system.

Access Token Expiry (Mins)

The number of minutes before an Access Token will be expired.

Note that Outh2 tokens will be expired after a period of inactivity, whereas Basic tokens will exist for the entire duration regardless of inactivity.

Refresh Token Expiry (Hrs)

The number of hours before a Refresh Token will be expired.

Refresh Token Grace Period (Secs)

Grace period, default and maximum 60 seconds for refresh/access-tokens to avoid refresh race conditions.

Allow Basic Authentication

Determines whether Basic Authorisation is allowed. Basic authorisation is not recommended for web or mobile access. Basic authorisation should only be used from apps when OAuth is not available, such as Microsoft BI or Excel. Select from:

• No - Basic Authorisation is not allowed.
• Trusted Only - Basic Authorisation is only allowed for IP addresses listed as Trusted IPs.
• All - Basic Authorisation is allowed.

Sync Connectivity to System

If Selected (default) then the connectivity settings will be written from the web service configuration JSON file to the WS Monitor Settings on WebService start-up if not previously set.

Trusted IPs

The list of Trusted IPs is used when running Web Services without SSL. This lists the IPs that requests will be accepted from. These can either be an explicit IPV4 or IPV6 address, or can be a range using the CIDR notation in either IPV4 or IPV6.

Host / Alias

These are used when using a reverse proxy. The Host represents the Host/IP of the Web Service, and the Alias represents the Host/IP of the proxy server.

When a user makes a request to a proxy server (Alias) with IP address x.x.x.x, this then maps the request to where the Web Service exists on (Host) y.y.y.y. Normally when a response is made any references to the Host would be written out based on y.y.y.y, however when using a proxy server it is the address x.x.x.x that should be used. The Host/Alias relationship tells the Web Service that when it gets a request from Host y.y.y.y it will write any responses with the Alias x.x.x.x.