Skip to main content

 

Cisco Meraki Documentation

How to Use Vision Portal Integrations: Access Control

Overview

You can now view Physical Access Control events linked to your cameras in the Meraki Vision Portal.

Meraki Vision is a portal for viewing cameras focused on core physical security tasks. The portal lets you easily switch between cameras to watch video, perform motion searches, and share footage. Physical Access Control integration adds the following capabilities:

  • Find and view events of persons trying to enter your facilities
  • See and respond to monitor points for doors, windows, controllers and other hardware
  • Remotely unlock doors for visitors or staff
  • Navigate to key resources (users, doors, controllers) inside your physical Access Control system when needed

To reach the portal, navigate to vision.meraki.com and sign in with your Meraki dashboard credentials. The Meraki Vision portal is displayed on the screen after browsing to vision.meraki.com

Key features

Physical Access Control integration into Vision Portal introduces these new capabilities:

  • View and search events
    • Access control events visible on camera timeline
    • Searchable Access Control event activity log
    • View event details for complete context
  • Response in real-time
    • Remotely unlock doors instantly with the click of a button
    • New events are shown in real-time using Webhooks
    • Historical events are fetched alongside video for improved investigations
  • Simplicity at scale
    • Link your MV Camera Networks and Access Control Solution easily using our open API
    • Configurable for the entire Organization
    • Pair one or more cameras to each door
    • Toggle on/off certain features (with more to come!) 

Tour of the interface

Default Vision Portal experience

In the Vision Portal, use the left menu to select the MV camera network you want. Browse and select cameras to view, create and review video walls, and manage exported footage.

The network selector and network page menu options are highlighted in the Vision Portal UI.

The left navigation pane shows a mini-map and a list of all cameras in the network. Use the search bar to enter a name or tag to find a specific camera. When you select a camera, its stream appears in a focused view on the Video Player.

The Video Actions menu at the top right lets you manage motion events, exports, and the sharing of video clips or streams.

The Video Timeline at the bottom of the Vision Portal helps you search for historical video or motion events.

The navigation pane, video actions, video player, and video timeline sections are highlighted in the Vision Portal UI

Camera view with Access Control Integration enabled

After enabling Access Control Integration in the Vision Portal, use the Video Timeline to search for past Access Control events.

The access control event options on the video timeline are highlighted in the Vision Portal UI

The Video Actions menu at the top right now includes an option to manage Access Control events. Opening the Event details drawer shows detailed information such as event description, access groups, timestamp, and more.

The Video timeline, Access Control option, and Event details sections are highlighted in the Vision Portal UI

Navigate to Access Control > Activity log to search for and review all access control events for the selected camera.

The access control section is highlighted in the Vision Portal UI. The access control section is expanded to show the Activity log tab, search bar, and events list.

Navigate to Access Control > Controls to remotely control access to associated doors. To remotely grant access, select the Allow access action button.

The access control section is highlighted in the Vision Portal UI. The access control section is expanded to show the Controls tab and the available control actions.

Step-by-step instructions

Set up the Integration

App selection and API key registration

To get started:

Navigate to Organization > Configure > Integrations and select the partner application. The Genea Security ecosystem partner application is displayed in the Integration app list after navigating to Organization > Configure > Integrations.

 

After selecting the app, follow the setup prompts specific to each partner application. (unique to each partner application) The following sections provide more details. 

App permissions

The App permissions Scope section is shown within the dashboard after selecting the desired Integrations under Organization > Configure > Integrations.

Permissions for Access Control features are adjusted within the app integration view, after adding the application.

  • Read mappings of cameras to doors (required)
  • Read door, user attributes, and Access Control events (required)

Each Access Control Integration requires default read-only permissions for user, door, and controller access event types, though naming may vary by partner application. These permissions are displayed in a read-only state to inform administrators that this behavior applies to all Vision Portal users by default.

  • Issue commands to Access Control devices - on/off (off by default)

Administrators can enable or disable remote door unlocking for all users with camera viewing permissions. This is a global setting and cannot be assigned to specific users or groups.

Genea Security

For additional information, refer the Genea Security ecosystem partner application page in the Cisco Meraki Marketplace.

Adding the Genea Security app integration
  1. Navigate to Organization > Configure > Integrations and select Genea Security from the apps list. 

  1. Select Add and enter your API key. 

  1. Adjust the Scope permissions and map cameras to physical security resources defined in the Genea Security application. 

  1. If the list is empty, configure the Meraki Integration in Genea and map MV cameras to physical security resources. 

  1. Return to the Genea Security app integration page and select Refresh data to populate and verify the resource mappings. 

The Genea Security application details page is displayed after selecting it from the Organization > Configure > Integration page's apps list.

After selecting the Genea Security app from the Organization > Configure > Integration page and clicking the Add button, a Connect to Genea pop-up is shown to input the API key information.

The Genea Security app integration overview is displayed under  Organization > Configure > Integration after completing the integration configuration.

Creating a Genea API key

This API key must first be created inside of the Genea platform and will require at minimum the following permissions to operate correctly:

The section to create an API key within the Genea platform's dashboard is displayed.

Permission Group Permission Access Level
User Management All Read
Location Management All Read
Hardware Management All Read
Access Control Management All Read
Control Center Management Door - Quick Grant Full
Key Management All Read
Webhook Management All Full
Integration Management All Read

Removing an app integration

  1. Navigate to Organization > Configure > Integrations and select the integration
  2. On the configuration details page, select Remove in the top right and confirm the action when prompted. 

This action is irreversible and will require a complete setup and configuration to use the integration again.

The remove Integrations pop-up window is shown for the Genea Security application after selecting the remove button for this app under Organization > Configure > Integrations

API Key management best practices

An API key is not a unique one-to-one application mapping, and anyone with access to the key can use the key to perform actions granted to Meraki. Avoid sharing or storing API keys in plain text, in accessible locations, or through email or SMS. Use cloud-based password managers to securely manage and share API keys. 

Find and play back video for Access Control events

Access Control event information in Vision Portal provides greater visibility into activity within secured spaces.

Navigate access events on the timeline

The Video timeline is shown within the Vision Portal. The Timeline is being searched for motion or access events by moving the slider forwards and backwards.

The camera timeline lets you do the following:

  • Play or pause video
  • Move forward or backward by frame or 10-second interval
  • Adjust video playback speed when viewing historical footage
  • Adjust the time resolution to view a window of 15 minutes, 30 minutes, 1 hour, 4 hours, 12 hours, 1 day, 3 days, or 1 week
  • Adjust the visibile time period forward or backward according to the current time resolution
  • Return from historical footage to the live view from the camera. 
  • Download a screenshot
  • Switch to larger viewing modes, Theater or Fullscreen, for improved focus

Orange bars on the timeline indicate periods of detected motion. Hover over these bars to view the motion recap image for the corresponding time.

The timeline now displays Access Control events alongside video navigation controls and motion detection data. In the single camera view of the Meraki Vision Portal, Access Control events appear as blue circles below the orange bars for motion events.

Hover over these Access Control events on the timeline to view a quick view of the Access Control event information.

A specific access event is hovered over on the Vision Portal's Video Timeline to see detailed event information.

Access Control event information may vary based on the integration partner and event type.

Select an Access Control event on the timeline to open the Event Details drawer, which displays detailed information about the event.A specific access event is clicked on within the Vision Portal's Video Timeline. An Event Details drawer opens from the right side of the Vision Portal UI.

View Access Control events in the activity log

A specific access event is selected in the Vision Portal by navigating to Access Control > Activity Log to see Event Details.

The timeline displays access control events, and you can also review the events in a list under the Access Control Activity Log drawer. Select an event to view detailed information. Quick links to key resources such as users, doors, and controllers in the access control partner's application help you review and manage events.  

Access control event information may vary based on the integration partner and event type.

Unlock doors remotely

The Vision Portal's "Allow Access" control button is clicked to remotely unlock a door by navigating to Access Control > Controls.

If someone needs help entering a facility, select the Allow Access button to remotely unlock the door. You can use remote unlocking for common situations such as the following: 

  • An employee who forgot their badge
  • A delivery person who needs entry to deliver mail and packages
  • A maintenance worker who arrives for a service call at a remote building or substation
  • A parent or guardian who picks up their child after hours

As this button is available inside your camera view, you can review the live or historical footage and verify that the person should have access before you remotely unlock the door for access into a secure location. 

Manage permissions for Physical Access Control features during the integration setup, as explained in the App Permissions section earlier in this document.

To administer permissions to the Vision Portal interface, refer to the Managing permissions to the interface section in the Vision Portal: Introduction article.

As of July 2024, there are a few restrictions today when configuring your Meraki Organization(s) for integration with Physical Access Control partner solutions:

  • Each Organization can only have one Physical Access Control partner integration configured
  • Each Organization can only link to a Physical Access Control partner integration using a single API key
  • Each Organization will establish a Webhook subscription with the Physical Access Control partner integration. Each vendor may have limits on the number of Webhook subscriptions allowed. See each vendor's documentation for the maximum number of Webhook subscriptions they support

Additional resources

Use the Feedback button on the top-right corner to send Meraki your thoughts on the interface.

You can find general FAQs in the MV Smart Camera FAQ article.

  • Was this article helpful?