Native Integration Available
This integration requires a Class 2 License and is available for SureView Enterprise (On-Premises) and SureView Response (SaaS). Please contact your account manager for more details.
Native Integration: Supported Features
- Get Configuration
- Live Video
- Camera Playback
- PreAlarm Recording
- PTZ
- Presets
Note: PTZ Preset compatibility depends on individual NX Witness NVRs. SureView can't guarantee compatibility across all NX Witness cameras and settings -
Alarms
Sureview Enterprise (On Premises): SMTP/Email Alarms
Sureview Response (SaaS): HTTPS Alarms
Native Integration: Requirements
SureView Package Requirements
The following packages will be deployed by your SureView Engineer
- SMTPReceiver (SureView Enterprise On-Premises Only)
- CC-DEVICE-DynamicIntegration
- CC-DEVICE-DigitalWatchdogDynamicIntegration
Note: The package is named "Digital Watchdog" but does install both the Digital Watchdog and NX Witness Device Types as they share common components.
Version Requirements
Tested against NX Witness 6.1.2.42921
Note: This is not a hard version requirement, this is the version that the integration was tested against
License Requirements
N/A - No manufacturer license required
Network Requirements
| From | To | Port | Description |
| OpsLink / Sureview Device Server | NX Witness | 7001 | API Port Video & Device Commands |
| NX Witness | Device Server (SMTP Receiver) |
25 | SMTP Alarms (Sureview Enterprise / On-Premises) |
| NX Witness | us.sureviewops.com / eu.sureviewops.com | 443 | HTTP Alarms (SureView Response / SaaS) |
The port settings can be found by:
- Logging in using the NX Witness Client
- Right click on the Server and click "Server Settings"
- Open the "General" tab to see the "Port" field
Permission Requirements
- Live View
- View Archive
- User Input
Note: These are the minimum required permissions
User Permissions can be configured on the NX Witness by logging in using the client software and:
Create the User Group for SureView
- Open System Administration (right click on the home icon in the NX Witness menu or press Ctrl+Shift+A)
- Go to User Management tab
- Click "Add Group" to created a dedicated Sureview user group
- Enter the group name "Sureview"
- Go to "Resources" tab
- Ensure that at a minimum "Live View", "View Archive" and "User Input" are ticked for all cameras
- Press Add Group
Create the User for Sureview
- Open System Administration (right click on the home icon in the NX menu or press Ctrl+Shift+A)
- Go to User Management tab
- Go to the "Users" tab
- Click "Add User"
- Provide a secure Username and Password for Sureview to use to connect to cameras (Leave "Allow insecure" unticked)
- Select the sureview permission group that you created earlier
- Press Add User
Camera Stream Requirements
Camera streams must be set to H.264
Camera Stream settings can be configured in the NX Witness Client:
- Login to the NX Witness Client Software
- Expand the Server in the side bar
- Right click on the individual camera and select "Camera Settings"
- Go to the "Advanced tab"
- Ensure both the Primary Codec and Secondary Codec is set to H.264
(Primary Codec is used for High / Highest Quality and Secondary Codec is used for Lowest / Low / Medium quality settings in SureView)
To validate the stream codec and resolution you can start playing the Live Camera in the NX Witness client and hover the cursor over the camera window. The codec information in the bottom left corner of the screen
Native Integration: Device Setup
| Field | Value |
| Title | The user facing name of the NX Witness system you are connecting to |
| Area | The Area/Site that the cameras and Alarms will be added to. |
| Type | NX Witness |
| OpsLink (If using SureView Response) | The name of your connected OpsLink+ Server |
| Host | The local IP of your NX Witness (from the perspective of the Device Server) |
| Port | The NX Witness port (7001 by default) |
| Configuration / ExtraValue |
leave blank
|
Once the device details have been added use Get Configuration to auto populate the Cameras and Alarms
Native Integration: Setup Live Camera Streaming
Camera detail will be automatically populated by Get Configuration feature
| Field | Value |
| Title |
The name of the camera that will be shown to the operator |
| Area | The Area/Site the camera will be associated with |
| Input1 | auto incremented camera number (not related to the device itself) |
| Input2 | Not used, leave as "-1" |
| ExtraValue |
NX Witness Camera ID - auto populated by Get Config. This is the unique identifier used to connect to the specific camera.
|
NX Witness Camera ID
To find the Camera ID manually, login to the NX Witness client software...
- Expand the Server in the left-hand side bar
- right click on the individual camera and select "Camera Settings"
- go to the "General tab"
- Click "More Info" drop down to expand and show more info
- Camera ID is displayed here (with a copy option)
Native Integration: Setup Email Alarms (Sureview Enterprise)
Initial SMTP Setup
Configure NX Witness to use your SureView Enterprise Server as the SMTP Server
- Open the Site Administration screen in NX Witness
- Click the Email Tab
- set your SMTP Server address as your SureView Server host address (where your Sureview SMTP Receiver service is hosted). Include the port number in the address e.g. myserver:25
Configuring alarm points
Alarm Points will be automatically added in SureView by Get Configuration or Sync with one alarm point per NX Witness camera.
-
Make a note of your Device number (ServerID) for your NX Witness device. You can find this when editing the device in SureView Device Setup
- Login to the NX Witness Client
- Go to the individual camera you want to configure an alarm for - right click and select "Camera Rules"
- Click "Add" to add a camera rule and enter the following details
-
Event
- When: Select the action to trigger the alarm such as "Motion on Camera"
- At: Select the individual camera you are configuring or ALL Cameras)
-
Action:
- Do: Send Email
- To: Leave this blank
- Additional Recipients: Add the S#@sureviewalarms.com replacing the # with the Server/Device ID found in Sureview the previous steps
- Interval of action: Set at a low figure to ensure no missed alarms
- Press OK
-
Event
- Repeat for each alarm trigger you want to send into SureView
- Press OK once complete. NX Witness is now configured to send alarms into SureView
Native Integration: Setup HTTP Alarms (Sureview Response / SaaS)
Once your NX Witness device(s) are set up, you'll need to contact SureView Support to have them enabled to receive alarms.
- Raise a support ticket listing the Device Title(s) and Device ID(s) (shown on the Device Information Setup page) for each device you want configured for alarming.
This requires a data request to be completed on our backend systems, which typically takes between 5 and 15 working days depending on demand. We'd recommend raising this ticket in good time before you need alarming to be live.
Configuring NX Witness
- Open NX Witness
- Right click on a camera in the camera tree and click "Camera Rules"
- Click Add Rule
- Give the Rule a name such as "Sureview Motion Alarm"
- In the "WHEN" section, select the triggering condition and camera such as
Motion on Camera Occurs At: Any Camera - In the "DO Action" section select HTTP(S) Request and then fill in the following details
URL https://{region}.sureviewops.com/receiver/{DeviceIdentifier}
Example
https://us.sureviewops.com/receiver/5cfacc02-7379-48fe-a745-689161010e7aMethod Post Custom Headers Key: X-Api-Key
Value: Your Sureview HTTP Alarm API Key
(You can find your API Key in Sureview by going to "Alarm Setup" then the "HTTP Alarms" tab then copying the key)Content {"type":"motion","time":"{event.time}","caption":"{event.caption}","desc":"{event.description}","deviceId":"{device.id}","deviceName":"{device.name}","site":"{site.name}"}
Change motion to whatever type of alarm you are using. This will be used as the matching Event Code which can be configured in Event Type Setup.
Content Type application/json Authentication Auto Login / Password leave blank Interval of Action Set to your preferred option (how frequently can the alarm trigger) - Press OK
Alarm Event Types
The following NX Witness Alarm Event Types can be decoded by default:
| Title | Event Code |
| Motion | motion |
| Input | input |
| Vehicle | vehicle |
| Person | person |
Troubleshooting
Preset GoTo not working
Unfortunately we have found that occasionally a camera's PTZ Presets won't be compatible with SureView. We cannot guarantee compatibility with all NX Witness camera Presets
HTTP Alarms not being received
- Ensure that the NX Witness has network access to us.sureviewops.com / eu.sureviewops.com port 443
- Ensure the HTTP URL is correct (check the DeviceID)
- Ensure the Sureview API Key entered in the custom header is correct
Comments
0 commentsPlease sign in to leave a comment.