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 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.

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

In this chapter:

Configure Genetec Web SDK and Media Gateway

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

websdk

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

mediagw

Important

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

Create Alarm in Genetec Security Center

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

alarm_properties

Tip

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

Tip

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

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

alarm_identity

Enable Genetec Integration in FindFace

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

  1. 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.

    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 PLUGINS
    # ==============================================================================
    # Uncomment lines below to enable plugins. Please consult documentation for
    # a plugin specific settings.
    ...
    # =============== Genetec ================
    INSTALLED_APPS.append('ffsecurity_genetec')
    
  2. Migrate the main database architecture from FindFace to PostgreSQL and re-create user groups with predefined rights.

    sudo findface-security migrate
    sudo findface-security create_groups
    
  3. Restart findface-security.

    sudo systemctl restart findface-security.service
    

Configure Endpoints in FindFace

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

  1. Navigate to the Preferences tab. Click Genetec.

    genetec_config_en

  2. In the Server and Media sections, specify settings of the Web SDK and Media Gateway endpoints.

    Important

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

  3. In the Ids section, specify the logical id of the Alarm entity that will be triggered in Genetec Security Center when a face recognition event occurs in FindFace.

    genetec_config_id_en

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

Import Cameras from Genetec Security Center

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

genetec_cameras_en

This action will create a group of cameras Genetec listing all the cameras from Genetec Security Center.

genetec_group_en

To view this list of cameras, navigate to the Cameras tab on the FindFace 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

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