Gallagher access control integration

About the Gallagher integration

Integrate Gallagher with Robin so that a badge swipe at a Gallagher-controlled door checks users into Robin automatically. This article shows how to set up and use the integration.

How it works

When users swipe their badges at Gallagher-controlled doors, Robin checks them into the office automatically. This makes check-in faster and adds data to attendance and usage analytics.

• If a user has a desk reservation, Robin checks them into their desk and shows them as "Checked in or confirmed on-site".
• If a user has no desk reservation when they swipe their badge, Robin creates a visit, checks it in and shows the user as "Confirmed on-site".
• Admins see a real-time list of who is in the office on the Daily Roster, and see who checked in with a badge swipe.
• Badge data shows in analytics as a desk check-in, as a count toward "confirmed on site", or both. It also shows the check-in method.

Before you start

Know these points before you set up the integration:

• An operator must create the REST Client.
• An operator is a cardholder assigned to an operator group. The operator group gives them operator privileges.
• You must give Robin the API key that the interface shows. Robin needs it to connect.

Part 1: Set up Gallagher

In Gallagher, create a REST Client, configure the Command Centre for cloud connection and find the email field.

Set up the Gallagher REST API

To create a REST Client in the Configuration Client:

1. Go to Configure > Services & Workstations. A new window opens.
2. Right-click an empty space and select New > REST Client.
3. Give the REST Client a name.
4. Go to the API Key tab.
5. In the drop-down menu, select the REST Client Operator named "REST Operator". This operator is preconfigured for you.
6. Leave Client Certificate Thumbprint empty.
7. Copy the key in the API Key field. You give this key to Robin in Part 2.
8. Because the REST Client has no client certificate, make sure the REST API allows that:
   1. In the Services and Workstations window, open the server properties.
   2. Go to the Web Services tab.
   3. Under REST API, select Enable REST Clients with no client certificate.

Configure Gallagher Command Centre for cloud connection

To turn on cloud connectivity, configure 2 items in the Command Centre:

1. Create the "Command Centre Cloud" item:
   1. Open Configuration > Configure > Services & Workstations.
   2. In the new window, right-click and select New > Command Centre Cloud.
   3. On the General tab, give it a name.
   4. On the Configuration tab, select the Enable Gallagher API Gateway box, then select the Region closest to you.
   5. Select Apply to save the configuration.
2. Let the "REST client" use the cloud API gateway, so it can connect through the Gallagher API gateway:
   1. Go to Configuration client > Configure > Services & Workstations.
   2. Select the REST client you want to connect.
   3. Go to the Connections tab.
   4. Under Cloud API Gateway, select Allow connection via Gallagher API Gateway.

Find the email field identifier

In addition to the API key and Gallagher API Gateway region, you must give Robin an email field identifier. This is the field where Gallagher stores user email addresses.

To find the email field:

1. Go to Command Centre > Viewers > Cardholder Viewers.
2. Find the Cardholder Details section.
3. Find the field that stores email addresses (usually labeled email). You give this field name to Robin in Part 2.

You can set up the integration first without the email field, but Robin does not pull or process badge events until you give Robin the field.

When you complete these steps, Gallagher is configured for API and cloud connectivity with Robin.

Part 2: Set up Robin

In Robin, connect your Gallagher account, enter the email field and choose where badge swipes check people in.

1. In the Robin web dashboard, go to Manage > Integrations.
2. Under Add Connectors, search for Gallagher. You can also select By category and find Gallagher under Access Control.
3. Select Set up next to Gallagher. The Gallagher integration page opens.
4. In the Authentication section, open Select a cloud region to connect and select your Gallagher API Gateway region: Gallagher US or Gallagher AU.
5. In the Gallagher API key field, enter your public Gallagher API key and select Authenticate. When your Gallagher account connects, you see a table that maps Gallagher Door IDs to buildings and floors.
6. In the Configuration section, enter the email field name from Part 1 in Email field identifier and select Save. Until you do, the Authentication section shows Email field identifier not provided.
7. In the table, configure the buildings, doors and floors where you want automatic check-ins through Gallagher.