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. Also see the ideal camera position for tailgating detection. The setup can be done from any web browser:
- Configure Openpath and optional 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. - Assign each Camera to an Entry.
Tell Camio which cameras see which entries at:
https://camio.com/settings/integrations/openpath - Create Outbound Webhooks from Openpath to Camio.
This requires your Openpath Administrator's credentials at:
https://camio.com/settings/integrations/openpath/webhooks
Steps 2 and 3 are shown in this screencast:
Settings
- Ether sign in to Openpath with a read-only User Role OR enter your Openpath orgId at:
https://camio.com/settings/integrations/openpath - 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:
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. |
entry.authenticated.failed | Show invalid card attempts. | |
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
}
Comments