Brivo Setup Wizard

This article explains the steps for using the Brivo setup wizard. User Role required to access these settings: Account Owner or IT Support.

Before you begin the setup wizard, you will need:

  • Your Brivo OnAir Administrator login.
  • An account on the Brivo API Platform.
  • An API key.
  • The Brivo integration enabled in your account.

To start the wizard:

  1. Go to Tools > Account.
  2. Select Integrations from the left-hand menu.
  3. Select the Enabled Integrations tab.
  4. Click Manage Settings.

Step_1_1.png

Click on each of the steps below to follow the Brivo integration setup wizard.

Step 1: Confirm you are Ready

This step is for you to confirm you have everything you need before you begin setting up the integration and to authorize WhosOnLocation to link to your Brivo account.

Step_1_2.png

Tick each box to acknowledge and select Get Started.

Step 2: Link to Brivo

To link WhosOnLocation and Brivo, you will need to work in both accounts at the same time.

WhosOnLocation requires your Brivo Client ID and Client Secret which are generated by creating an Application in Brivo. The steps on creating these are below.

And an API Key can be obtained through request to Brivo.

Please Note: Some details that are unique to the Brivo or WhosOnLocation account have been blurred so that they are not mistakenly entered in your accounts.

2019-05-03_9-50-21.png

  1. Login to Brivo OnAir- You can do this by selecting the blue Brivo OnAir hyperlink, or going to brivo.com, and entering your login details.

    Step_2_1.png
  2. Navigate to Setup > Account > Account Settings.

    step_22.png
  3. Click on the Application Management tab.
  4. In the Create a New Application box fill in the new application with the Name and Description as "WhosOnLocation".

    step_23.png
  5. Select the type of authentication for the application, 3-Legged is recommended and the rest of the setup steps refer to this type.

    step_24.png

    Mirror 
    your chosen authentication method to the Brivo OAuth Settings box on the right side of this wizard.

    step_25.png
  6. When using the 3-legged application type, you need to enter the Redirect URI in Brivo. Copy the URI provided in the WhosOnLocation steps to the New Application in Brivo. This is unique to your WhosOnLocation account.

    step_26.png
  7. In Brivo, click Create Application to save.

    step_27.png

    The new application will be created and listed under Account Owned Applications.
  8. Once created, clicking the small blue Application Details icon will display the Client ID and Secret.

    step_28.png

    step_212.png

    Copy these to the Brivo OAuth Settings box on the right side of this wizard.

    step_29.png
  9. Assigned API Keys can be found in your Brivo developer portal, copy this to the Brivo OAuth Settings box on the right side of this wizard.

    You can get to the Developer Portal by selecting the blue hyperlink, or going to brivo.com/apps/mykeys, and entering your login details.

    step_210.png
    Please Note: If you do not have a Brivo API Key, you will need to request this from Brivo.
  10. Click Continue to move to the next step.

Step 3: Authorize with Brivo

Now that you have linked your WhosOnLocation and Brivo accounts, you need to authorize WhosOnLocation to access the data from your Brivo account.

  1. Select Authorize Now.

    Step_3_1.png

    You will be re-directed to log into your Brivo API.
  2. Login in to your API.
  3. Select Submit to authorize.

    step_32.png

You will be taken back to WhosOnLocation and automatically to the next step.

Step 4: Syncing to Brivo

Your Brivo data will now be synced with WhosOnLocation, this may take a few minutes. WhosOnLocation will import your SitesDoors, and Users into the Brivo integration so that you can match them with existing data in your WhosOnLocation account.

To separate your employees from service providers, create a group called Service Providers in Brivo and add any service providers to that group. You do not have to give that group access to any doors.

step_3_3.png

When complete, the spinning hourglass will become a tick and you can click Continue.

Step 5: Mapping Brivo Sites to WhosOnLocation

In order to ensure that your reporting is accurate, your site permissions are carried over, and your users are matched correctly, you will need to match your Brivo sites to your WhosOnLocation locations; this is called mapping.

You can map multiple Brivo sites to one location or leave some unmapped if you’re not using them with this integration.

Please Note: You will not be able to map doors or users that are set up in unmapped sites.

To map your sites to locations, drag and drop your Brivo Site to the matching WhosOnLocation Location from left to right on your screen.

Once your sites are matched to your locations correctly, click Continue.

Please Note: You can re-map your sites at any time once the setup is complete.

Step 6: Where are your Brivo Doors Located

The Doors you have set up in your Brivo account are matched to Location Access Control Points (LACPs) in your WhosOnLocation account. The LACP is used to identify Sign In/Out Kiosks and other areas that a person might sign into and out of a location.

You can match multiple doors to one LACP where required, e.g. one door in and one door out for the same LACP.

To match your doors to LACPs, simply select the corresponding LACP from the drop down list next to the door.

step_6_1.png

Once your doors are matched with your LACPs, click Continue.

Please Note: You can re-map your doors at any time once the setup is complete.

Step 7: Sync Config

Set up how you want to configure your sync of people in Brivo and WhosOnLocation. The Master Database will determine which system is used to push information through to the other. If you have all your people set up in WhosOnLocation and want to import them into Brivo, choose WhosOnLocation as the Master Database or vice versa.

Please Note: The initial sync will only match existing users in each database. To import users, you will need to set up the sync schedule in the Brivo Sync Settings once the Wizard is complete.

WhosOnLocation Master Database

When WhosOnLocation is selected you have three options for syncing; All, Selected, or Off.

2019-05-03_10-46-37.png

Sync Employees

All – All employees from all locations matched with Brivo sites will be synced.

Selected – Choose the locations you want to sync employees with Brivo from.

Off – No employees will be synced. Choose this option if you are only syncing service providers or not ready to sync employees.

Sync Service Providers

All – Sync all service providers in your account with Brivo.

Selected – Service providers with the Brivo Sync role type assigned will be synced with Brivo. This will be automatically generated in the system and can be applied after you complete the wizard.

Off – No service providers will be synced. Choose this option if you are only syncing employees or not ready to sync service providers.

Brivo Master Database

When Brivo is selected as the master database you have two options for syncing; Selected and Off.

2019-05-03_11-02-32.png

Sync Employees

Selected – Choose the groups in Brivo that you want to sync and select the location new employees should be added to by default. Their default location can be overridden using rules later.

Off – No employees will be synced.

Sync Service Providers

Service Providers in Brivo need to be added to a group called Service Providers before syncing. This will allow WhosOnLocation to identify them as service providers and import/match them to service provider profiles.

Selected – Choose the groups in Brivo, including the Service Provider group, that you want to sync. The location permissions are added by the organization in WhosOnLocation.

Off – No service providers will be synced.

Step 8: Match Users between WhosOnLocation and Brivo

Your Brivo Users are now being automatically matched with employees and/or service providers in your WhosOnLocation account.

Users are matched based on their name and any users that are not matched can always be matched manually or automatically later.

If your employees and/or service providers have not been set up in the non-master database, they will not be matched. These, and any new, employees and/or service providers will be imported to the non-master database through scheduled syncs once set up. Click here for more information on setting this up.

2019-05-03_11-05-54.png

It may take a few minutes to match all users depending on how many records there are. When complete, the spinning hourglass will become a tick and you can click Continue.

Step 9: Finished

Your Brivo integration setup is now complete. Click Finish to confirm this.

2019-05-03_11-09-02.png

You will be taken to the Brivo integration settings page where you can configure the sync settings, adjust the matching of sites, doors, and users, and set up sync rules.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request