Gallagher access control integration

Overview

Integrate Gallagher with Robin to allow Gallagher-controlled doors to check users into Robin with a badge swipe automatically. This guide will walk you through the steps to set up and start using the integration.

How it works

When users swipe their badges at the Gallagher-controlled doors, they'll be automatically checked into the office via Robin, streamlining the check-in process and enriching attendance and usage analytics.

• If a user has a desk reservation or assignment, they'll be checked into their desk. 
• If a user does not have a desk reservation or assignment when they swipe their badge, a visit will be created, checked in, and reflected as being in the office for the day. 
• Admins can view this data in Analytics. 

Important notes before getting started

• An operator must create the REST Client.

• An operator is a cardholder assigned to an operator group, which grants them operator privileges.

• The API key displayed in the interface must be passed to Robin for a successful connection.

How to set it up - Part 1: Setup steps in Gallagher 

Gallagher REST API setup

To create a REST Client in the Configuration Client, follow these steps:

1. Navigate to Configure → Services & Workstations. This opens a new window.

2. Right-click on an empty space and select New → REST Client.

3. Assign a name to the REST Client.

4. Go to the API Key tab.

5. Select the REST Client Operator named "REST Operator" in the drop-down menu. (This has been preconfigured for you)

Configuring Gallagher command center for cloud connection

You need to configure two key items in the Command Center to enable cloud connectivity:

1. Create the "Command Center Cloud" item.
2. Enable the "REST client" to use the cloud API gateway.

How to create the Command Center for Cloud

1. Open Configuration > Configure > Services & Workstations. 
2. In the new window, Right-click and select New > Command Center Cloud. 
3. On the General tab, assign a name. 
4. On the Configuration tab:
   • Check the Enable Gallagher API Gateway box
   • Select the region closest to you.
5. Click Apply to save the configuration. 

How to enable the REST client for the Cloud API gateway

To allow a REST client to connect via the Gallagher API gateway:

1. Go to Configuration client > Configure > Services & Workstations. 
2. Select the REST client you want to connect. 
3. Navigate to the Connections tab.
4. Select Allow connection via the Gallagher API Gateway.

Email field identifier

In addition to the API key and Gallagher API Gateway region, you must provide an email field identifier. This field represents where user email addresses are stored within Gallagher.

Steps to identify the email field:

1. Navigate to Command Centre → Viewers → Cardholder Viewers.
2. Locate the Cardholder Details section.
3. Identify the field where email addresses are stored (commonly labeled as "email"). This field name needs to be passed to Robin.

Notes:

• The integration can initially be set up without specifying the email field. However, until the field is provided to Robin, badge events will not be pulled or processed.
• By following these steps, you will successfully configure Gallagher for API and cloud connectivity, ensuring seamless integration with Robin.

Part 2: Setup steps in Robin

1. In the web dashboard, navigate to Manage > Integrations on the left.
2. Scroll down to the "Access Control" section on the Integrations page. 
3. Locate Gallagher and click Connect to begin the setup process.  

4. Click Connect account under the authentication section.

   

5. Enter your public Gallagher API key.

6. After successfully connecting your Gallagher account, you'll see a table mapping Gallagher Door IDs to the designated buildings and floors.

7. Use the table to configure the relevant buildings, doors, and floors where you want to enable automatic check-ins via Gallagher.