*Plugin – HTTP Server

Owned by Tom Polman
Last updated: Sept 21, 2022
3 min read

Configuration Article | CA-20220905-MH-01

VDG Sense | Setup | Plugins | HTTP Server

The HTTP Server plugin is the gateway for the VDG Sense Webpage, IOS/Android apps and third-party systems which integrate VDG Sense. It is also responsible to handle all HTTP calls to the SensePluginManager.

Configuration

The HTTP Server plugin can be found in the ‘Plugins’ tab. Because it is an essential part of the VDG Sense system it cannot be deactivated.

General

The ‘General’ tab hold the main settings of the HTTP Server.

 

  • Address
    SenseVideoManager Management server address

    • Defaults to 127.0.0.1 (localhost). When used with Redundant API it should be changed.

  • Bind Address

    • Defaults to 127.0.0.1 (localhost), which means it only accepts connections from localhost and not from any external source. Set to 0.0.0.0 to accept remote connections.

IMPORTANT: Changing ‘Bind Address’ setting requires SensePluginManager to be restarted

  • Port

    • TCP Port to access the HTTP Server (and VDG Sense webpage and IOS/Android app)

  • MaxConnections

    • Max number of simultanious API connections.

  • ConnectionTimeout

    • Timeout parameter to close connection if there is no activity. A value of ‘0’ means, never close connection.

  • MaxMultiPartCount

    • Set to 10 to reduces SensePluginManager memory load in combination with FlinQ

  • SessionSetupTimeout

    • Value in milliseconds, increase value when having issues with API login in larger systems

Logging

The log level can be selected here. To log the incoming HTTP callsl only ‘LogRequest’ should be checked. This is normally enough for basic debugging.

Advanced

 

SkipLicenseTimeout

This parameters is used in combination with the API Call ‘GetLicensePlate‘. This valu is in milliseconds and defines the max timeout between the time a license plate is scanned and when this API call is done.

Enable cookie only sessionkey

Enabled by default and prevents the use of the sessionkey as parameter in API commands. Due to security reasons it is recommend to enable this.

Enable digest authentication

Disabled by default for API connectivity. This relates to IOS, Andriod, Sense webpage and third party connectivity. It is preferred to use HTTPS access if possible.

API AlwaysUseLatestVersion

Commands are processed using latest API version

Add MAC address

Disabled by default and adds the <macaddress> field from API:getDivaList call. On multi-NIC servers this call could be slow and could interfere with Third-Party integrator operations. In most cases mac-address information is not required by integrators.

APIVersion
Select API version

Transcoding

This menu holds transcoding settings for image requests via the API.

  • TranscodingEnabled
    When enabled, Sense will transcode all images that are requested via the HTTP Server. When disabled, the resolution of the image will be the same as the input resolution of the camera. If an image request (e.g. getLiveImage) is done with imagewidth or imageheight specified, the image will be transcode to the specified requested resolution.

  • TranscodingQuality

  • ImageWidth
    Width of transcoded image

  • ImageHeight
    Height of transcoded image

Access Control

These are advanced settings in the HTTP headers of API calls. Please contact VDG Support for more information.