.. _genetec:


*******************************************
Configure Integration
*******************************************

Integration with Genetec Security Center is implemented via the ``findface-genetec`` plugin. By default, the plugin is disabled.

Before getting started with the integration on the FindFace Multi side, deploy the Genetec Web SDK and Media Gateway packages, and create an ``Alarm`` entity that will be triggered in Genetec Security Center when a face recognition event occurs in FindFace Multi.

.. important::
   For the Genetec-FindFace integration to work, you also need to purchase a proper license from Genetec (license part number ``GSC-1SDK-Ntech-FindFace``) and activate it in Genetec Security Center. 

   |genetec_certificate|

   .. |genetec_certificate| image:: /_static/genetec_certificate.png
       :scale: 60%


.. rubric:: In this chapter:

.. contents::
   :local:

.. _websdk-media:
 
Configure Genetec Web SDK and Media Gateway
================================================

To enable and configure Web SDK, use Genetec Config Tool. For details, refer to :menuselection:`Security Center Administrator Guide -> Chapter 52: Role Types -> Web-based SDK configuration tabs`.

    |websdk|

    .. |websdk| image:: /_static/websdk.jpg
        :scale: 60%

When enabling and configuring Media Getaway in Genetec Config Tool, refer to :menuselection:`Security Center Administrator Guide -> Chapter 24: Video Deployment`.  

    |mediagw|

    .. |mediagw| image:: /_static/mediagw.jpg
        :scale: 60%

.. important::
   Make sure that the firewall is configured so that the ports for the WebSDK and Media Gateway are open.



.. _alarm:

Create Alarm in Genetec Security Center
===================================================

Create and configure a new ``Alarm`` entity in Genetec Config Tool. Refer to :menuselection:`Security Center Administrator Guide -> Chapter 48: Alarms -> Creating Alarms` for details.

    |alarm_properties|

    .. |alarm_properties| image:: /_static/alarm_properties.jpg
        :scale: 60%

.. tip::
   On the :guilabel:`Properties` tab, select the :guilabel:`Video display option` that suits your needs the best. Available options are :guilabel:`Live`, :guilabel:`Playback`, etc.

.. tip::
   To enable alarm procedures and auto rotation of video right within the alarm pop-up window, enable :guilabel:`Content cycling`.

When configuring the integration in FindFace Multi, you will have to enter the alarm logical id that is specified on the :guilabel:`Identity` tab.

    |alarm_identity|

    .. |alarm_identity| image:: /_static/alarm_identity.jpg
        :scale: 60%

Enable Genetec Integration in FindFace Multi
====================================================

To enable the Genetec integration in FindFace Multi, do the following:

#. Enable the ``findface-genetec`` plugin. To do so, open the ``/etc/findface-security/config.py`` configuration file and uncomment the ``INSTALLED_APPS.append(‘ffsecurity_genetec’)`` line. Make sure that at least one of the following parameters is specified: ``SERVICE_EXTERNAL_ADDRESS`` or ``EXTERNAL_ADDRESS``.

   .. code::

      sudo vi /etc/findface-security/config.py

      ...
      # SERVICE_EXTERNAL_ADDRESS is prioritized for FFSecurity webhooks and Genetec plugin.
      # EXTERNAL_ADDRESS is used instead if SERVICE_EXTERNAL_ADDRESS is not provided.
      # You must provide either SERVICE_EXTERNAL_ADDRESS or EXTERNAL_ADDRESS in order
      # to be able to work with FFSecurity webhooks and Genetec plugin.
      SERVICE_EXTERNAL_ADDRESS = 'http://127.0.0.1'
      # EXTERNAL_ADDRESS is used to access objects created inside FFSecurity via external links.
      EXTERNAL_ADDRESS = ''

      ...
      # FINDFACE SECURITY PLUGINS
      # ==============================================================================
      # Uncomment lines below to enable plugins. Please consult documentation for
      # a plugin specific settings.
      ...
      # =============== Genetec ================
      INSTALLED_APPS.append('ffsecurity_genetec')

#. Migrate the main database architecture from FindFace Multi to :program:`PostgreSQL` and re-create user groups with :ref:`predefined <users>` rights.

   .. code::

      sudo findface-security migrate
      sudo findface-security create_groups

#. Restart ``findface-security``.
 
   .. code::

      sudo systemctl restart findface-security.service


Configure Endpoints in FindFace Multi
=============================================

To establish connection between FindFace Multi and Genetec Security Center, do the following:

#. Navigate to the :guilabel:`Preferences` tab. Click :guilabel:`Genetec`.

    |genetec_config_en|

    .. |genetec_config_en| image:: /_static/genetec_config_en.png
        :scale: 60%

    .. |genetec_config_ru| image:: /_static/genetec_config_ru.png
        :scale: 60%

#. In the :guilabel:`Server` and :guilabel:`Media` sections, specify :ref:`settings <websdk-media>` of the Web SDK and Media Gateway endpoints.

   .. important::
      The ports for the WebSDK and Media Gateway need to be open.

#. In the :guilabel:`Ids` section, specify the :ref:`logical id <alarm>` of the ``Alarm`` entity that will be triggered in Genetec Security Center when a face recognition event occurs in FindFace Multi.

    |genetec_config_id_en|

    .. |genetec_config_id_en| image:: /_static/genetec_config_id_en.png
        :scale: 60%

    .. |genetec_config_id_ru| image:: /_static/genetec_config_id_ru.png
        :scale: 60%


#. Click :guilabel:`Save`. If the connection to Genetec Security Center is successfully established, you will see the :guilabel:`State` change to :guilabel:`Configured`.


Import Cameras from Genetec Security Center
===============================================

Once the connection to Genetec Security Center is established, import cameras. To do so, click :guilabel:`Cameras` on the :guilabel:`Genetec` tab. Click :guilabel:`Import`.

    |genetec_cameras_en|

    .. |genetec_cameras_en| image:: /_static/genetec_cameras_en.png
        :scale: 60%

    .. |genetec_cameras_ru| image:: /_static/genetec_cameras_ru.png
        :scale: 60%

This action will create a :ref:`group of cameras <cameras>` ``Genetec`` listing all the cameras from Genetec Security Center.

    |genetec_group_en|

    .. |genetec_group_en| image:: /_static/genetec_group_en.png
        :scale: 60%

    .. |genetec_group_ru| image:: /_static/genetec_group_ru.png
        :scale: 60%

To view this list of cameras, navigate to the :guilabel:`Cameras` tab on the FindFace Multi navigation bar. If you want to exclude a camera from face recognition, simply deactivate it in the list.

Create Watch Lists and Dossiers in FindFace Multi
===========================================================

After you have configured the endpoints and camera settings, finish the integration by creating a :ref:`dossier database <guests>`. Notifications about face recognition events will be automatically sent to Genetec Security Center. See :ref:`gsc`.