SMS Watchlist Solution Guide

This solution guide describes how to set up a system that will monitor the entrances to your facility and send you an SMS message when a known threat is detected.

This guide is written for Windows users. Linux users can achieve the same functionality, but they need to use the Web Console instead of the Desktop Client.

For simplicity's sake, this guide assumes that you're using a SAFR Cloud License. If you're using a SAFR On-Premises License, you'll also need to install and manage the SAFR Server.

Required Hardware and Software

Required Hardware

Required Software

Install SAFR Desktop Client

Download and install the SAFR Desktop installer for Windows from the SAFR Download Portal. The SAFR Desktop installer includes both the SAFR Desktop Client and SAFR Actions, but there's no need to install SAFR Actions for this solution guide.

If you have many cameras, you may need to install multiple Desktop Clients on different machines. Typically each machine can handle up to 8 cameras.

On every Desktop Client that you install, do the following to configure it:

  1. Select the Secure Access operator mode from the drop-down menu in the upper right corner of the Camera Feed Analyzer window.
  2. Configure the client's preference settings by selecting Preferences… from the Tools drop-down menu.
    Configure the following settings:
    • Detection Menu:
      • Enable person detector: Enable.
    • Events Menu:
      • Include Speculated Identity Events: Enable.
      • Include Secondary Events: Enable.
      • Remove identities: Click Change.
        • Remove Anonymous Identities after: Disable.
        • Remove Identities of person type after: Disable.

Install SAFR Mobile Client

Download and install the SAFR Mobile installer for Android from the SAFR Download Portal onto your Android phone. This will allow you to examine events sent to you by the SMS Watchlist Alarms Dashboard.

Camera Selection and Positioning

Because the goal of this scenario is to detect when a known threat attempts to enter the facility, every entrance to the facility should have at least one camera pointed at it. Camera placement should follow these guidelines:

Lighting Considerations

Success with recognition largely depends on lighting conditions.

Backlighting, which is when light shines from behind a subject, can cause significant difficulties in recognition and should be avoided whenever possible. However, because backlighting often can't be avoided, the cameras you use should have the following features which help alleviate backlighting difficulties:

The basic steps in handling a backlight situation are as follows:

  1. Angle the camera slightly toward the floor to eliminate as much direct light into the camera's sensor as possible.
  2. Because people will be moving through the field of view (FOV), maintaining high shutter speed is important to obtain blur-free images. To help accomplish this, place a bound on the slowest shutter speed allowed.
  3. Turn on backlight compensation if available (it's available on the 772R), and adjust the level.
  4. If faces are still dark, adjust the exposure compensation to brighten the faces. The background will probably become overexposed, but that's OK for facial recognition.
  5. If there are specular reflections, or if faces are still too dark, turn on highlight compensation.

This approach is appropriate for situations where varying outdoor conditions also vary the amount of light reflected from faces. Light intensity is simply boosted above what the cameras would choose automatically and the image is enhanced to reduce exposer variance.

In cases where outdoor conditions generate backlight conditions and there is minimal variation in lighting from inside (e.g. there are few windows, so indoor illumination doesn't affect the lighting on subjects' faces), it's more appropriate to place the camera in fully manual mode and set the shutter speed, iris, and gain values manually to properly expose the face while allowing the background to be overexposed. When in manual mode, the camera makes no auto-adjustments and is not thrown off by momentary bursts of light due to opening doors or other momentary drastic changed in lighting. When setting your camera in manual mode, do the following:

  1. Set the shutter speed to 1/90 or higher.
  2. Open the iris, increasing the f-stop for the iris (aperture) until subjects' faces are bright enough.
  3. Focus the camera on the sweet spot of the recognition where people are most likely to face towards the camera.

Increasing the iris reduces the distance during which subjects' faces are in focus. (This is called the depth of field.) Increasing the iris increases the quality of the image but reduces the amount of time the image is in focus and viability for recognition. In either case, focus the camera on the sweet spot of the recognition where people are most likely to face toward the camera.

Install and Connect Your Cameras

For each camera you install, do the following:

  1. Within the SAFR Desktop Client's Camera Feed Analyzer window, select the camera you want to install.
  2. Select the Secure Access operator mode from the drop-down menu in the upper right corner of the Camera Feed Analyzer window.
  3. Optimize the camera location and orientation. Adjust the camera's optical zoom to ensure that subjects' faces are at least 80 pixels high from chin to forehead.
  4. Adjust the focus of the camera to the closest position where all subjects' faces are within the camera's field of view. (i.e. ensure that no one will be to the left or right of the camera view)
  5. Add the camera's video feed to your Video Recognition Gateway (VIRGO) video feeds by pressing the Add to Video Feeds button.
  6. Check your system's CPU and GPU load. If you want to install an additional camera, but doing so would increase your CPU or GPU load to 100% or greater, install an additional instance of the SAFR Desktop Client on a different machine and install the additional camera on the newly installed Desktop Client.

Additional Camera Resources

Configure SAFR to Send SMS Messages

Configure SAFR so that it can use a short message service (SMS) server to send SMS messages.

  1. Go to the Web Console's Status Page.
  2. In the Configuration section, click on Set up SMS. You'll be presented with the following dialog.
    • SMS Provider: Your SMS Provider. You can select either SAFR Cloud or Amazon SNS from the drop-down menu. The SAFR Cloud provider is much easier to set up however, so you should probably select the default SMS Provider, SAFR Cloud.
    • Test Message: Send a test message to verify that your SMS is properly configured.
      • To Phone Number: The phone number to which the test message will be sent. The number should be in the E.164 format. (e.g. +12065551313)
      • Message: The text message that will be sent.
  3. Click Apply.
  4. Verify that the specified phone received a test SMS message.

Set Up the SMS Watchlist Alarms Dashboard

To set up the SMS Watchlist Alarms Dashboard, do the following:

  1. Go to the Web Console's Report Page.
  2. Click on the SMS Watchlist Alarms Dashboard.
  3. Click Add New Alarm.
  4. Enter an Alarm Name. (e.g. "SoutheastDoor")
  5. For Sources, select Limit to specific sources, and select all the cameras that are monitoring entrances to your facility.
  6. For SMS recipients, enter the Phone Number and Name of every person you want to receive SMS notifications. (Make sure to click Add after you enter the information for each person.)
  7. Enable Separate alarms across different sources.
  8. Enable Separate alarms across different identities.
  9. Click Add at the bottom of the dialogue.
  10. Repeat steps 3-9 for each door into your facility that you're monitoring.

Register People

You'll need to register all the people that you want to be on the lookout for, either from saved photos or via a connected camera.

Register a Person Into SAFR Using a Photo

To register a person from a photo, do the following:

  1. Open the SAFR Desktop Client.
  2. Navigate to the People Window by selecting People… from the Tools drop-down menu.
  3. Click the Add face button near the top of the People Window.
  4. Select the photo image located on your hard drive.
  5. Any photo that has sufficient quality for recognition will show a purple oval around the face with the option to click and add a name. Type a name if desired.

Note: It's very helpful to use as high quality a photo as possible.

Register a Person Into SAFR Using a Connected Camera

To register a person using a connected camera, do the following:

  1. Open the SAFR Desktop Client.
  2. Select the Learn and Monitor operator mode from the drop-down menu in the upper right corner of the Camera Feed Analyzer window.
  3. Select a connected camera from the Camera Selector drop-down menu.
  4. Show the subject's face to the selected connected camera and wait for the overlay oval around their face to display the message "Click face to register".
  5. Click the face and enter the subject's name.

Note: Don't forget to change the operator mode to Secure Access if you want to use the camera as part of the SMS Watchlist Alarms.

Configure a Registered Person as a Threat

To configure a registered person as a threat, do the following:

  1. Open the SAFR Desktop Client.
  2. Navigate to the People Window by selecting People… from the Tools drop-down menu.
  3. If you want to see most recently added people, sort by Enrollment Date, and set sort order to Descending in order to see the neewly added entries.
  4. You can remove people already marked as Threat or Concern from view by filtering on ID Class for No Concern.
  5. For each person you want to configure as a threat:
    1. Double-click the person.
    2. Choose Threat or Concern from the ID Class menu list.
    3. In the Desktop Client, that person will now be marked with a red oval overlay to indicate a Threat or an amber oval overlay to indicate a Concern.

Test Your SMS Watchlist

To test the system that you have just set up, do the following:

  1. Register yourself with SAFR, as described above.
  2. Configure yourself as a threat, as described above.
  3. Hide your face from all connected cameras.
  4. Show your face to a connected camera and wait for SAFR to recognize you.
  5. Upon recognition, you should see the following:
    • A red oval should be drawn around your face in SAFR's video feed, indicating that you're a threat.
    • Your phone should receive an SMS message.
  6. Note that the SMS message contains a link to the event that caused the SMS Watchlist Alarm to be triggered. If you tap on the link, the SAFR Mobile Client will start and you'll be shown the triggering event.

If you don't see the red oval, try the following troubleshooting steps:

  1. If you see errors with the login, ensure that your account information is correct.
  2. Contact RealNetworks technical support.

See Also