Home/Video/Camera/Guides/SAFR Camera Admin Guide
Table of Contents
1 Introduction
2 SAFR Camera Configuration
3 Digital Video Recording (DVR) Settings
4 Camera Settings
5 Image Settings
6 SAFR Server System Settings
7 Troubleshooting

2 SAFR Camera Configuration

This section describes functionality and configuration specific to SAFR Camera. The focus is on settings exposed in the SAFR SCAN Web Console. As such, this section follows the structure of SAFR SCAN Web Console.

As described above in “Camera vs. Software”, SAFR offers two products for performing facial recognition. Common functionality that is shared between both products are fully documented in SAFR Administration Guide.

2.1 Live Page

The Live tab displays the camera view of the SAFR Camera device, and is the default tab of the SAFR Camera Web Console. You can view events and enroll new faces from this page.

2.1.1 Events

Events appear on the right. Color indicates the following:

Color

Meaning

Description

Grey

Unrecognizable

Insufficient quality for a match. SAFR will not attempt to match if quality is too low. This may happen if face size is too small or too dark to be deemed acceptable quality to attempt a match.

Purple

Stranger

Face was of sufficient quality but no match was found.

Green

Known/No-concern

Face matched in watchlist and marked as “No Concern”.

Red or Yellow

Known/Threat or Concern

Face matched in watchlist and person ID Class was set to Threat or Concern. Many of SAFR’s capabilities allows for special handling of persons based on ID Class.

Strangers in the Live page will appear with an “Enroll” button. Click the enroll button to add the face to the watchlist.

A black background with green text

Description automatically generated

2.1.1.1 SAFR Event Types

SAFR has many event types. This section documents only those event types applicable to SAFR Camera. See SAFR Administration Guide for information on all event types.

2.1.1.1.1 Person Event

Person event is generated based upon appearance of a face. Color and text will vary depending on the conditions.

A screenshot of a person's face

Description automatically generated

Analytics also appear in person events when enabled. Following shows event with age, gender and sentiment enabled.

A screenshot of a black background

Description automatically generated

2.1.2 Event Face Image Selection

SAFR Camera will capture the best quality face that appears while a person is in view. For each face that appears in the camera view, an event is generated. An event is not just a single point in time but has start and and end time. When a new face appears in the camera view, an event is started. SAFR tracks the face from frame to frame. With each frame, SAFR evaluates the face image against various metrics such as face size, center pose, sharpness, contrast and occlusion. If SAFR finds a better face, the event image is updated. SAFR also updates data such as age estimate and sentiment while a face is still in view. When the face leaves view of the camera, the event is updated with an end time and no further updates are made.

In SAFR Desktop, options exist to enroll a stranger face from the event or to update an existing stored identify with the best face obtained during the event. See SAFR Software Administration Guide for more details.

2.2 People Page

The People tab allows you to manage and configure your enrolled people. You can also enroll people using saved face images.

2.2.1 Enroll a Person Using a Face Image

Do the following to enroll someone using a saved face image:

  1. Click Add. You will see an empty dialog as shown below.
    A screenshot of a computer

Description automatically generated
  2. Click Choose File and select the face image from your local computer, tablet, or phone. The face image should be of good quality with at least 150 pixels from ear to ear.
  3. Click on the Edit button in the upper right corner of the newly added person's record.
  4. Enter the following information:
  5. Enter the person's First name and Last name.
  6. Set ID Class if desired.
  7. Click Save Changes. The person will be added to the Person Database.

2.2.2 Edit Person Records

To edit the records of people already enrolled in the Person Database, click on the Edit button of their record, as indicated by the arrow below.

  • Name, Person Type and ID Class fields are for filtering.
  • Add and Delete buttons allow adding new and deleting persons.
  • Refresh will reload. The page does not update automatically like the Live page does.
  • Click anywhere except the image or click the pencil icon to edit a record.
  • Click anywhere on the face image to select a record (multiple records can be selected at once for deletion).

💡If faces do not appear, its likely due to setting to persist synced person face images disabled on server.

Person has many attributes. Below are just some. The Desktop software has additional properties that cannot be edited on the SAFR Camera Web Console.

A screenshot of a computer

Description automatically generated

2.3 Operation Settings

2.3.1 Monitoring

Monitoring mode: Specifies how SAFR Camera processes its camera view video feed. See the Operator Modes documentation in the SAFR Software Administration Guide for full descriptions of the available Operator Modes.

Below is a summary of the monitoring modes:

• All Events Monitoring (default) – Report all events including unrecognizable faces. Unrecognizable events are not reported until person is in view for at least 1.5 seconds (configurable)

• Enrolled Monitoring – Only record events for known recognized persons

• Enrolled and Stranger Monitoring – Record events for known recognized persons and strangers. Strangers are defined as a face that was of sufficient quality to attempt to recognize, but no match was found.

• Threat/Concern and Stranger Monitoring – Record events for strangers and known people marked as Threat or Concern.

• Learn and Monitor – Auto-enroll faces as they appear in front of the camera. This creates a new identify for every face as long as the quality thresholds for learning are met. This mode is most useful for various reports that learn faces such as Traversal Reports or Queue Reports.

  • Note: If you want to enroll specific faces from camera, use “Enroll” option from the Events view.

Additional analytics: Enables additional analytics; age, gender and sentiment analysis. These analytics are estimated from the face image appearing in the camera view. Their accuracy will depend upon the source image quality. No biometric signature is needed to compute.

A screenshot of a computer screen

Description automatically generated

Data is reported in user interface as shown below and persisted with event so it is available in various reports or with exported event data.

A screenshot of a black background

Description automatically generated

Sentiment and Smile are reported as follows:

  • During event (while face is in view): Display current sentiment and show smile indicator if smiling.
  • After event (face left the view): Display average sentiment and % of time smile was detected.

2.3.2 DVR

Settings to enable recording of video to local Micro SD card and optionally to an AWS account. See Digital Video Recording (DVR) Settings section below for information on configuring DVR.

2.3.3 Camera

Camera settings offers advanced features to control the exposure and shutter speed of the camera. See Camera Settings below for information about settings in this page.

2.3.4 Image

Image settings offers features to control the picture. Image settings involve digital processing and should be reserved only when desired results cannot be achieved with Camera Settings. See Image Settings below for information about settings in this page.

2.4 System Settings

2.4.1 SAFR Server

Specifies the SAFR Server, if any, that SAFR Camera is connected & managed by.

⚠️ if SAFR Camera is managed by a SAFR Server, many of SAFR Camera’s settings won't be locally configurable anymore; they'll only be configurable via the SAFR Server.

There are four possible values for the SAFR Server field.

  • None: SAFR SCAN isn't connected to a SAFR Server.
  • SAFR Server: SAFR Camera is connected to a locally deployed (i.e. an on-premises) SAFR Server.
  • SAFR Cloud: SAFR Camera is connected to a SAFR Server in the cloud.
  • Custom: SAFR Camera is connected to a locally deployed SAFR Server that has custom SAFR service endpoints. There are two scenarios where you might want to use custom SAFR service endpoints:
    • The SAFR Server has custom domain names for each service endpoint.
    • You want to use an unsecure HTTP connection, rather than the default HTTPS connection. We do not recommend using HTTP connections, but this may be useful in debugging.

2.4.2 Behavior when Connected to SAFR Server

2.4.2.1 Persons

When you connect to SAFR Server, the local faces database on SAFR Camera will be combined with face database on SAFR Server. If SAFR finds that two face are similar, those faces will be automatically merged into a single identify. See Software SAFR Administration Guide for information on merging and unmerging faces.

2.4.2.2 Events

Events will be uploaded from SAFR Camera to SAFR Server. This occurs in real time. Events will typically appear on SAFR Server within milliseconds of being created and will be updated in real time.

If networking between SAFR Camera and SAFR Server is unavailable, events will be cached on SAFR Camera until the connection is restored. When connection is restored, cached events will be uploaded to SAFR Server and cleared from local cache. SAFR Camera is capable of storing the latest 2,000 events with images and up to 28,000 more most recent events without images.

2.4.2.3 Configuration

When connected to SAFR Server, many of the configuration can be modified on the connected SAFR Server. Use SAFR Server Web Console or SAFR Desktop to manage those settings.

2.4.3 Video Streams

Configure and manage the video stream profiles produced by the camera.

2.4.4 Network

Manually configure the device's network settings.

Note: SAFR automatically configures its network settings when the device is first turned on and contacts a DHCP server. However, you can manually configure your device's network settings here if you need to override the DHCP server.

2.4.5 Date and Time

Settings to configure NTP time synchronization server or manually set the device's date and time.

2.4.6 Update

Allows you to update both the SAFR SCAN software and the SAFR SCAN device's firmware to the latest versions. If available, SAFR will get updates directly from SAFR update server. If not, firmware can be downloaded from http://safr.real.com/firmware.

2.4.7 Reset

Allows you to either reboot the SAFR SCAN device or reset its settings to their default values.

There's no need to reboot or reset your SAFR SCAN device during the normal operation of your device, but rebooting or resetting the device can be useful if you encounter an unexpected behavior while operating the device.

2.5 Security Settings

2.5.1 System Login

The login credentials to be used to log in to SAFR Camera. This is where you can change the password.

2.5.2 Video RTSP Access

When video RTSP access is enabled, remote connections are able to view SAFR Camera’s camera feed in realtime. This is disabled by default because remote viewing isn't necessary or appropriate for most access control use cases.

2.5.3 SSL

Allows you to manually configure your SSL (Secure Sockets Layer) settings.

2.5.4 802.1x

Allows you to enable 802.1x authentication.

2.5.5 Firewall

Allows you to manually configure your firewall settings.

2.5.6 VPN

Enables you to connect the camera to a remote VPN service using OpenVPN to facilitate remove management of the camera behind NAT firewalls.