ONVIF

QbProtect & ONVIF

The ONVIF standard and corresponding protocol allow seamless integration of compatible IP-based security cameras into existing security enviroments managed by Video Management Systems (VMS). The QbProtect brings the ONVIF protocol support to Qb2 device, and allows to easily use Qb2 as an advanced drop-in replacement of the security camera in already established security environments without extra non-standard configuration overheads.

QbProtect is not yet fully compliant with dedicated ONVIF profiles

Even though QbProtect is not yet fully compliant with a particular ONVIF profile, it brings crucial ONVIF functionality inherent in all security applications:

Visual observation of the scene using RTSP video stream of a 2-D projected point cloud
ONVIF events for alarms generation (e.g. motion, intrusion)

Configuration of the particular alarm rule chain is VMS specific and has to be configured by the user / integrator. Please refer to the VMS subsection below for examples!

Video Management Systems (VMS)

Due to the interoperability of the ONVIF protocol, QbProtect is not restricted to a particular VMS manufacturer and may work with any VMS supporting ONVIF, however it is actively tested against confined number of VMS systems listed in Table 1 below.

Table 1. Integration of QbProtect with VMS systems
Manufacturer	VMS
Senstar Corporation	Senstar Symphony
Milestone Systems	Milestone XProtect
Geutebrück GmbH	G-Core
Hexagon AB	HxGN dC3
Avigilon Corporation	Avigilon Unity

Integration and configuration instructions and usage examples of QbProtect with a particular VMS system can be accessed from the corresponding VMS column or the matching documentation subsection.

Video Stream (RTSP)

In addition to VMS systems support, QbProtect allows direct video stream consumption of a point cloud using the RTSP stream source link of the following format rtsp://qb2-ABC123XYZ.muc.blickfeld.com:554/local/pointcloud/core. The demonstation of direct video stream consumption using VLC player is shown in the Figure below.

Figure 1. Video stream of QbProtect point cloud using RTSP stream source link

The perspective of the RTSP video stream can be synchronized with the one configured in the WebGUI. For that navigate to the Viewer page of the QbProtect WebGUI, configure the desired view perspective and apply the keyboard shortcut kbd:[Shift+V].

In case user management was enabled on QbProtect the video stream URL should also include ONVIF/RTSP credentials pair in the following format: rtsp://user:key@qb2-ABC123XYZ.muc.blickfeld.com:554/local/pointcloud/core. Please refer to the section below to see how to obtain the required credentials pair.

User Authentication (ONVIF/RTSP)

In order to add QbProtect to a VMS or/and obtain the RTSP video stream from the device the user has to generate and provide a valid application key associated with a corresponding user account.

Both ONVIF and RTSP are relying on the QbProtect user management system. User management via ONVIF itself is not yet supported.
The application key with enabled HTTP option has to be used to establish connection with QbProtect via ONVIF (VMS systems) and/or via RTSP (video players)

The valid application key can be generated by enabling the HTTP authentication option from the user account page as shown in the figure below. Please refer to QbProtect documentation in order to learn more about user management and application keys.

Figure 2. Creating HTTP authentication application key suitable for ONVIF/RTSP connections

The resulting application key (password) in combination with the account user name (login) can be used, when prompted, as credentials pair (login/password) in the VMS or video player (e.g. VLC).

Figure 3. Resulting HTTP application key

It is only possible to generate a single application key with HTTP option enabled per user account.
The generated HTTP application key can be used as a password for VMS systems and video players.

Events

In addition to the video stream of the security scene, QbProtect also utilizes ONVIF events which can be used by various applications to fulfill a desired action. The list of supported events, their description and type are shown in the Table below.

Only for existing ONVIF setups with version JACK v2.9 and below

ONVIF events delivered with firmware version JACK v2.9 and below are considered to be legacy. They remain functional in the existing QbProtect setups after firmware upgrades; however, they will not be further expanded. To obtain the most recent list of supported events after the installation of a newer firmware release, please follow the procedure below:

Remove all existing ONVIF HTTP application keys from all configured user accounts
Reboot QbProtect

Once fulfilled, the new event list is persistently exposed for the configuration in your VMS system.

Events origininating from dynamic event sources (e.g. intrusion event from a particular security zone) are called Dynamic. Other events are called Static. The QbProtect has to be re-added into VMS in oder to expose events from dynamic sources newly configured via QbProtect WebGUI.

Table 2. QbProtect ONVIF events
Name	Description	Availability
tns1:VideoSource/MotionAlarm	Motion event in the observed security scene	Static
tns1:Blickfeld/Intrusion	Aggregated intrusion event in pre-configured security zones	Static
tns1:Blickfeld/IntrusionZone{Name}	Intrusion event in the pre-configured intrusion zone, where {Name} is replaced by the name of the configured zone (e.g., if the zone is called "Snack", then the corresponding event will be called IntrusionZoneSnack)	Dynamic
tns1:Blickfeld/HealthFailure	QbProtect is in the failed state (one or more failures). The actual root cause can be found at QbProtect diagnostics page	Static
tns1:Blickfeld/HealthWarning	QbProtect is in the warning state (one or more warnings). The actual root cause can be found at QbProtect diagnostics page	Static
tns1:Blickfeld/TamperingCovered	The mirror of QbProtect has been covered	Static
tns1:Blickfeld/TamperingMoved	QbProtect has been moved or rotated	Static
tns1:Blickfeld/Tampering	QbProtect has been either moved or covered	Static