IRIS+™ VMS Gateway Integration Guide

overview video streams are transmitted from the genetec media gateway to the iris+ edge, where video analytics are performed the resulting analytics events, along with associated metadata, are forwarded to the iris+ core and stored in a centralized database to enable real time communication, the iris+ vms gateway establishes a websocket connection with the iris+ core, ensuring continuous reception of analytics events these events are then relayed to the genetec security center (gsc) using the platform sdk to trigger corresponding events and the media sdk to deliver overlay metadata when conducting searches via the iris+ client embedded within the gsc, results are displayed in the gsc media player, with overlays dynamically retrieved from the iris+ core supported genetec security center versions security center 5 12 security center 5 13 genetec iris+™ certificate requirements to enable the integration, a specific iris+™ certificate must be installed in genetec certificate name iris+™ certificate genetec part number gsc 1sdk irisity enterprise connection requirement single connection for genetec server and an additional two connections per running genetec security desk to verify the certificate open the genetec security center config tool from the main menu, select about navigate to certificates and ensure that at least 3 irisity certificates are present verify genetec certificate enable genetec integration in iris+™ portal before you begin verify that your iris+™ account is active, at least one admin user is configured, and an edge device is properly connected, before proceeding add genetec cameras to the iris+™ edge device iris+™ edge connects to live video streams using rtsp connection strings provided by the genetec media gateway steps to add cameras prepare a list of rtsp connection strings for all cameras you intend to use in iris+™ log in to the iris+™ portal identify and select the edge device where the cameras will be connected navigate to the physical view tab and click camera add each camera's rtsp connection string to the corresponding configuration fields note make sure “udp support” is turned on complete all the required fields save camera generating an iris+™ service account token to integrate genetec with iris+™, a service account must be created within iris+™ this account generates a token, which is used to establish the connection between the iris+™ platform and genetec to generate a token log in to your iris+™ account navigate to the settings tab click the users tab click the + add button and select create service account enter a service account name such as “genetec integration” enter a description (optional) click create service account from the user's list, select the created service account user , click the arrow next to the name to expand the view, and select get token define token expiration if required (by default, the token never expires) click get token and note the generated token (to be used in the iris+™ vms gateway configuration) close the window configure api key (for on premise iris+™ core deployments only) note perform this step only if you are hosting the iris+™ core on premise log in to the iris+™ portal and navigate to the console select api keys from the menu click + add to create a new api key provide a descriptive name for the api key and select it to open the configuration options under permissions, enable read access for both camera and event key click the save button to apply the changes expand the newly created api key entry and click the copy button to copy the key value save this api key securely — it will be required later during integration download integration components please download the iris+ vms gateway for the genetec server and the iris+ genetec embedded plugin for the genetec security desk from the following links iris+ vms gateway iris+ genetec embedded plugin install integration components to integrate iris+™ with genetec, you must install the necessary integration components the iris+™ vms gateway should be installed on a server that has network access to both the genetec vms server and the iris+™ core api (whether hosted by irisity or by the customer) this server can either be the genetec vms server itself or a dedicated server with the appropriate connectivity install genetec sdk install the genetec security center sdk corresponding to your security center version for genetec 5 12, install security center 5 12 sdk for genetec 5 13, install security center 5 13 sdk note ensure you download the correct sdk version matching your genetec deployment install iris+™ vms gateway the iris+™ vms gateway is a windows service that facilitates communication between iris+™ and genetec sdk, allowing iris+™ generated events to be forwarded to genetec note health events are not yet supported and will be included in a future release installation steps if a previous version of the iris+™ vms gateway is installed, uninstall it run the iris+™ vms gateway installer as administrator in the installation window, provide the following information vms type select genetec security center address ip address of the genetec vms server port the default is 5001, unless otherwise configured user genetec vms login username password genetec vms login password core integration check the box for receive analytics events from the core iris+™ url for on prem enterprise deployments https //api irisplus app, for irisity hosted deployments https //api irisplus ai iris+™ account token use the token generated in section 3 1 3 click apply and proceed through the installation process until completion after installation, the iris+™ vms gateway the service will automatically start and attempt to connect to the genetec vms to retrieve the camera list verification steps wait approximately one minute after installation open the following log file c \program files (x86)\irisity ab\iris+vms gateway\logs\vmsgateway service xxxxx part confirm the log file contains a list of camera names from the genetec vms, and the events websocket is connected, or check for error messages common issues & troubleshooting • incorrect installation details check if ip address, port, or credentials were entered incorrectly during setup refer to section 5 1 3 for updating the configuration • genetec server configuration issues ensure appropriate licenses, camera configurations, firewall rules, and genetec services are in place and operational • permission issues if the service starts but does not operate correctly, verify that the iris+™ vms gateway has the necessary windows permissions adjust the windows service settings to run as a user with sufficient privileges, then restart the service updating configuration parameters if you need to update integration settings after installation, you do not need to uninstall the iris+™ vms gateway a configuration utility is provided locate the shortcut on the desktop labeled iris+™ vms gateway settings launch the utility to access and modify the service settings update the necessary fields and click apply to save changes install the iris+™ genetec embedded plugin the iris+™ genetec embedded plugin enables the integration of iris+™ event data directly within the genetec security desk environment this component must be installed on any workstation where genetec security desk is in use install genetec sdk install the genetec security center sdk corresponding to your security center version for genetec 5 12, install security center 5 12 sdk for genetec 5 13, install security center 5 13 sdk note ensure you download the correct sdk version matching your genetec deployment once genetec security desk and the corresponding sdk are installed, ensure the genetec security desk application is closed before proceeding with the installation installation steps launch the iris+™ genetec plugin installer when prompted, complete the following fields iris+™ portal url enter the full url of your iris+™ portal for irisity hosted deployments https //portal irisplus ai for on premises deployments use your organization’s internal portal url or leave the default url provided by the installer api key if your iris+™ account is hosted by irisity, please contact irisity support to obtain your api key if your iris+™ account is hosted locally (on premise), use the api key generated in section 3 1 4 token use the service account token generated in section 3 1 3 click next and proceed through the remaining steps to complete the installation once installed, the plugin will allow iris+™ event data to be visualized and interacted with from within the genetec security desk interface map cameras in genetec to iris+™ in genetec security center, each camera is identified by two key attributes camera name guid (globally unique identifier) to enable iris+™ to correctly recognize and associate cameras from genetec, the iris+™ vms gateway automatically extracts the camera names and guids and saves them to the following file c \program files (x86)\irisity ab\iris+vms gateway\geneteccameras ini here is an example of the output file (3 cameras) steps to map cameras in iris+™ to enable analytics for specific cameras in iris+™, perform the following steps in the iris+™ portal define each camera navigate to the appropriate edge device or system view identify the camera you introduced in section 3 1 2 to configure for analytics set the external id in the camera configuration window, locate the field labeled external id copy the corresponding guid for the camera from the geneteccameras ini file and paste it into the external id field note this guid mapping is critical for ensuring that iris+™ analytics are correctly associated with the cameras within genetec security center enabling alarms in genetec security desk to receive iris+™ analytics generated alarms in genetec security desk, you need to configure custom events, alarms, and event to action rules in genetec security center these settings allow genetec to respond appropriately to various detection rule types deployed in iris+™ define custom events for each iris+™ detection rule type implemented (e g , moving in an area, crossing a line), you must define a genetec custom event each event acts as a placeholder for corresponding rule triggers sent by iris+™ note a single custom event per rule type is sufficient, regardless of how many cameras or sensors are using that rule to define a custom event open the genetec security center config tool select tasks from the main menu navigate to system > general settings click on events > custom events click the ‘+’ icon to add a new custom event in the create dialog \ enter a meaningful name that identifies the iris+™ rule type (e g , person moving in an area ) \ note the generated custom event id (value field) — this will be used later in iris+™ rule configuration click save and then apply define alarms next, define an alarm for each iris+™ rule type that you plan to monitor each alarm will be linked to a custom event and displayed in the security desk when triggered to define an alarm in the config tool, go to tasks > alarms click the ‘+ alarm’ icon to create a new alarm provide a descriptive name (e g , iris+ person moving in an area) click apply in the alarm properties tab recipients assign the operators or workstations that should receive the alarm video display option set to playback play define how many seconds before the alarm the video should begin playing content cycling set the interval for cycling through camera recordings click apply to save changes link custom events to alarms via automation rules to ensure that a custom event triggers the appropriate alarm, define an event to action rule in the automation settings to link the custom event to its alarm navigate to the config tool and select the automation tab click the ‘+’ icon to add a new automation rule the event to action wizard will open under the "when" section \ choose the custom event you previously created ( e g , person moving in an area ) under the "do this" section \ select trigger alarm as the action \ then, choose the corresponding alarm from the list ( e g , iris+ person moving in an area ) click save to complete the configuration repeat the above process for each iris+™ detection rule type you plan to deploy within your environment linking iris+™ analytics events to genetec custom events to ensure that iris+™ detection rules are correctly associated with the corresponding custom events in genetec security center, the rule configuration in iris+™ must be aligned with the custom event id defined in genetec configure rule external id in iris+™ in the iris+™ portal, navigate to the rules tab for the relevant camera select the detection rule you want to associate with a genetec alarm in the rule settings, locate the field labeled external id enter the custom event id exactly as defined in genetec (e g , 59) important press enter after typing the value do not type anything else in this field click save to apply the configuration note this step ensures that when this rule is triggered in iris+™, the associated event is properly recognized and handled by the genetec security center accessing the iris+™ portal from the genetec security desk once the iris+™ genetec embedded plugin is successfully installed, an iris+™ icon is added to the genetec security desk home screen to access the iris+™ portal from the security desk home screen, click the iris+™ icon a new tab will open displaying the iris+™ login window enter your iris+™ account credentials and click log in using iris+™ investigation feature in the genetec security desk client investigate module the investigate module enables users to search for relevant events of interest and view associated video clips based on defined search criteria search capabilities you can initiate searches using the following methods interactive map view specific cameras the module provides a customizable panel that allows you to refine your search and retrieve the most relevant results using various tools, including map based or camera based search selection of applicable rules and parameters identification of objects (e g , vehicle type and color) definition of a specific timeframe or period how to use log in to iris+™ click on the investigate tab select the camera(s) of interest from the camera tree define your search criteria (e g , search for red vehicles) review the search results and double click on a desired result a short video clip of the selected event will automatically play via the genetec security desk video recorder contact irisity support customer support technicalsupport\@irisity com mailto\ technicalsupport\@irisity com