How to connect Openpath to Camio tailgating detection, contact tracing, and visual verification

When you associate cameras with entrances, your can use access control events as search query terms. For example, you can quickly review every time Bob unlocked a door across any building on campus with the query https://camio.com/app/#search;q=bob_jones_entry.unlocked. 

Set up in 3 steps

The Openpath + Camio integration requires no network changes, no on-site visits, and no software installations. The setup can be done from any web browser:

  1. Create a read-only User Role.
    If you'd like Camio to lookup user name and email for search and alerts, then create a read-only user role to be used by Camio when performing those lookups.
  2. Assign each Camera to an Entry.
    Tell Camio which cameras see which entries at:
    https://camio.com/settings/integrations/openpath
  3. Create Outbound Webhooks from Openpath to Camio.
    https://camio.com/settings/integrations/openpath/webhooks

Settings

  1. Ether sign in to Openpath with a read-only User Role OR enter your Openpath orgId at:
    https://camio.com/settings/integrations/openpath
    Screen_Shot_2019-06-29_at_2.35.58_PM.png
  2. Enter the numeric Openpath entryId values for each camera that has a view onto an access-controlled entrance and press the Save button. If you've entered a read-only userId for lookups, then you can select from the drowdownlist as in this redacted example:
    Screen_Shot_2019-07-29_at_5.49.53_PM.png

The use of a read-only userId and token is optional and used only to a) list available entryId values with descriptions and b) translate userId values into people's names.

Searching

The access control events are indexed by userId, userId_event, event, and status. For example:

Example Search URL event or status code Description
https://camio.com/app/#search;q=entry.unlocked entry.unlocked Show every entry.unlocked event across all doors.
https://camio.com/app/#search;q=987_entry.unlocked entry.unlocked Shows every time userId 987 requested entry.unlocked event.
https://camio.com/app/#search;q=SUCCESS__ACCESS_GRANTED SUCCESS__ACCESS_GRANTED Show every time the access status was "SUCCESS__ACCESS_GRANTED"
https://camio.com/app/#search;q=entry.ajar.started  entry.ajar.started Show anytime a door was left ajar.
https://camio.com/app/#search;q=entry.ajar.ended entry.ajar.ended Show times at which a door ajar was closed again.
https://camio.com/app/#search;q=entry.forcedOpen entry.forcedOpen Show any opening of a door without authorized access.

https://camio.com/app/#search;q=entry.authenticated.failed

entry.authenticated.failed Show invalid card attempts.

https://camio.com/app/#search;q=entry.authorized.failed

entry.authorized.failed Show attempts forbidden by hour-of-day or other constraints.

 

API

For large deployments, the same settings are also accessible via the Camio API. The example above would be: 

curl \
  -H "Content-Type: application/json" \
  -d '{"cameraMap":{"117550000798386757677:7CDD90CE5753:7CDD90CE5753.0":{"entryId":4557},"117550000798386757677:7CDD90CE5754:7CDD90CE5754.0": {"entryId":4558}},"orgId":663,"token":"xyzpdqz","userId":123}' \
  -X PUT https://camio.com/api/users/:user/settings/integrations/openpath

The JSON above formatted for legibility:

{
  "cameraMap": {
    "117550000798386757677:7CDD90CE5753:7CDD90CE5753.0": {
      "entryId": 4557
    },
    "117550000798386757677:7CDD90CE5754:7CDD90CE5754.0": {
      "entryId": 4558
    }
  },
  "orgId": 663,
  "token": "xyzpdqz",
  "userId": 123
}

Have more questions? Submit a request

Comments