*Plugin – HTTP Server
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 addressDefaults 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 imageImageHeight
Height of transcoded image
Access Control
These are advanced settings in the HTTP headers of API calls. Please contact VDG Support for more information.