---
title: Gallagher Command Centre
slug: acs-gallagher
createdAt: 2026-05-11T07:34:24.000Z
---

# Integration Guide

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/unNtVyj5SJq5t_Ij8AJoh_gallagher-splash-card.png" size="60" width="780" height="310" position="flex-start" alt="Gallagher" sha="f952f35cf6755235f40a11f14b726124a435ec74" initialPath="/assets/integration-guide/gallagher/gallagher-splash-card.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-splash-card.png" showCaption="false"}

:::hint{type="info"}
This integration connects Sine with Gallagher Command Centre, allowing visitor and access data to sync between the two systems. It enables organizations to manage physical access control for visitors directly from their existing Gallagher security infrastructure. This guide is intended for system integrators and IT administrators responsible for configuring and maintaining the connection between Sine and Gallagher Command Centre.
:::

# Overview

Sine integrates with Gallagher Command Centre to automatically provision and revoke visitor access credentials, with destination mapping that controls access by floor or location. The integration supports Sine QR Code credentials, which can be printed on visitor badges or sent via SMS, and Physical Assets credentials, such as HID proximity cards, which are managed in Sine and assigned to visitors on check-in.

# How It Works

Sine integrates with Gallagher Command Centre via API to provision and revoke access credentials in real time, allowing visitors to move through Gallagher-controlled doors using credentials issued directly from a Sine visit record.

## QR Code

Visitors are issued a Sine QR Code credential that can be scanned at compatible Gallagher readers, allowing entry without a physical access card.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/BvO2Ige5ETjjKMmAiio0a_gallagher-overview.png" size="120" position="flex-start" alt="gallagher-overview" sha="c707c6b6bf204afe2bb5d7edfbe11407ea92efd5" initialPath="/assets/integration-guide/gallagher/gallagher-overview.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-overview.png" showCaption="false"}

**Check-in Flow:**

::::WorkflowBlock
:::WorkflowBlockItem
The visitor initiates check-in through Sine using a kiosk, the mobile app, the web check-in flow, or a printed QR poster.
:::

:::WorkflowBlockItem
Sine provisions a unique QR code credential, scoped to the visitor's assigned access groups for the duration of their visit.
:::

:::WorkflowBlockItem
Once the visit is approved following security and compliance checks, Sine activates the QR code credential in Gallagher Command Centre.
:::

:::WorkflowBlockItem
Sine delivers the QR code to the visitor via SMS or displays it on their printed badge.
:::

:::WorkflowBlockItem
The visitor presents the QR code at a Gallagher reader with QR/barcode scanning support, and the door unlocks.
:::
::::

**Check-out Flow:**

::::WorkflowBlock
:::WorkflowBlockItem
The visitor checks out through the Sine app, at a kiosk, by notifying their host, or automatically on exiting the geofence area.
:::

:::WorkflowBlockItem
Sine revokes the QR code credential in Gallagher Command Centre, preventing any further use for entry.
:::
::::

# Requirements

## Sine Requirements

- **Integration enablement**: Ensure you have a Sine subscription that supports the Gallagher Command Centre integration and that the integration is enabled on your account. Additional fees may apply.

## Gallagher Command Centre Requirements

- **Command Centre**: You need a Gallagher Command Centre system running version 8.30 or higher.
- **Command Centre API Licensing**: API access to Command Centre requires one of the following licensing approaches.
  - **Sine integration partner license**: A single Sine partner license covers all required API access. This is the recommended approach for simplified onboarding.
  - **Gallagher individual API licenses**: Purchase individual Gallagher licenses for each required capability.
    - **C12784 - Licence REST Cardholder API (required)**: This license is required for the visitor check-in flow. It allows Sine Core to create cardholder records in Command Centre.
    - **C12772 - Licence REST Alarms and Events API**: This license is needed to detect when visitors leave your site by scanning their QR code at an exit gate.
    - **C12814 - Licence Schindler Call by Profile**: This license is required for Schindler elevator control.
- **QR Reader**: If you plan to use QR codes for access, you need a compatible QR access reader. Confirm compatibility with Gallagher or your Access Control Integration Partner. A reader similar to [this one](https://www.amazon.com/LBS-Outdoor-Control-Wiegand26-Scanner/dp/B08BRTD547) is suggested.
- **Credential pool**: If you plan to issue physical access cards, ensure you have an available credential pool.
- **Testing environment**: Set up a sandbox environment or another safe testing space before configuring the integration in production.
- **Cardholder templates**: Configure the visitor cardholder division and templates in Command Centre before proceeding.
- **Network connectivity**: Determine how you will connect Sine to your on-premise Command Centre system.
  - **Direct API access**: This method requires network firewall access to the Command Centre API from outside your network.
  - **Gallagher API Cloud Gateway**: You can configure the Gallagher API Cloud Gateway on the Gallagher Command Centre system (available from v8.60 onwards).

# Configuration

## Gallagher Command Centre Configuration

### Network Configuration

The integration supports both a local, isolated Gallagher Command Centre deployment and the Gallagher API Cloud Gateway. The requirements for each option differ slightly, so review the following networking configurations carefully:

::::::Tabs
:::Tab{title="Direct API connection"}
To use the integration with your local network, configure your network to:

- Allow incoming access from the internet for our API servers by whitelisting our NAT IP addresses. Refer to [this page](https://sine.support/en/articles/2103291-firewall-rules-and-whitelisting) for an up-to-date list of IP addresses.
- Allow outbound calls from the CallbackSignature software to our API servers. Depending on your firewall setup, this may require exposing all internet access.
:::

:::::Tab{title="Gallagher API Cloud Gateway"}
As an alternative to whitelisting IP addresses, you can configure the Gallagher API Cloud Gateway on the Gallagher Command Centre (from v8.60 onwards).

::::WorkflowBlock
:::WorkflowBlockItem
Navigate to the `Configure > Services and Workstations` menu.
:::

:::WorkflowBlockItem
Right click and select `New > Command Centre Cloud`.
:::

:::WorkflowBlockItem
Navigate to the `Configuration` tab.
:::

:::WorkflowBlockItem
From the first `Region` dropdown at the top, select the `Command Center Cloud` option.
:::

:::WorkflowBlockItem
Select the `Enable Gallagher API Gateway` checkbox.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/X36WIb4etjZxza5nd2hLq_gallagher-api-gateway.png" size="75" position="flex-start" alt="gallagher-api-gateway" sha="388d386be1e2db97a670bfde77c7f8ab8c61ffce" initialPath="/assets/integration-guide/gallagher/gallagher-api-gateway.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-api-gateway.png" showCaption="false"}
:::

:::WorkflowBlockItem
Select `OK` to save.
:::

:::WorkflowBlockItem
From the `Services and Workstations` window, open the REST Client you configured previously.
:::

:::WorkflowBlockItem
In the `Connections` tab, select the `Allow Enable connection via Gallagher cloud API Gateway` checkbox.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/HT1U95-RejFuq0BJfP4w0_gallagher-api-gateway-checkbox.png" size="75" position="flex-start" alt="gallagher-api-gateway-checkbox" sha="2e5e807fde7a942448509da1090a5710b0fd01b5" initialPath="/assets/integration-guide/gallagher/gallagher-api-gateway-checkbox.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-api-gateway-checkbox.png" showCaption="false"}
:::

:::WorkflowBlockItem
Select `OK` to save.
:::
::::
:::::
::::::

### REST API Configuration

Sine Core communicates with Gallagher Command Centre via a REST API client. In this section, you will complete the following:

### Enable Web Services

::::WorkflowBlock
:::WorkflowBlockItem
Log on to Gallagher Command Centre and open the `Configuration Client`.
:::

:::WorkflowBlockItem
Click on the `File > Server Properties` menu option.
:::

:::WorkflowBlockItem
In the window that appears, click on `Web Services` in the sidebar.
:::

:::WorkflowBlockItem
Update the REST API section to match the following screenshot. `8904` is the default base port, but your network specialist may specify a different one for you to use.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/m1uRwKgd8At5IXzQn7395_gallagher-web-services.png" size="75" position="flex-start" alt="gallagher-web-services" sha="532b58e95a1cddea2f27ca4279cc8b3db18ff5f3" initialPath="/assets/integration-guide/gallagher/gallagher-web-services.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-web-services.png" showCaption="false"}
:::

:::WorkflowBlockItem
Click `Manage Certificates` and confirm that the `Server Certificate` is set to `Default Internal Certificate`.
:::

:::WorkflowBlockItem
Apply your changes and close the `Server Properties` window.
:::
::::

### Create an Operator Group

Create an operator group specifically for the integration with Sine Core. This user should be created following the [principle of least-privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege) to help keep your access control system secure. For more information on Gallagher operator privileges, [see their official documentation](https://gallaghersecurity.github.io/cc-rest-docs/ref/events.html#topic-Operator-privileges).

:::::WorkflowBlock
:::WorkflowBlockItem
In the `Configuration Client` menu, click on `Manage > Operator Privileges` and leave the window open while you continue.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/Kx0LrEoSgf-RCo2cjOra__gallagher-operator-privileges.png" size="75" position="flex-start" alt="gallagher-operator-privileges" sha="48b47939150281d849395d61fc478b1a4d770fb9" initialPath="/assets/integration-guide/gallagher/gallagher-operator-privileges.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-operator-privileges.png" showCaption="false"}
:::

:::WorkflowBlockItem
Navigate to the `Manage > Operator Group` menu.
:::

:::WorkflowBlockItem
Right click and select `New > Operator Group`.
:::

::::WorkflowBlockItem
Click the `Operator Privileges` item in the sidebar and configure the required privileges as shown in the following image. You can drag and drop privileges from the window you opened in step 1.

:::hint{type="warning"}
Do not use `Advanced User` for the REST Operator, as this grants an unnecessarily high access level to the Sine Core integration. [Gallagher recommends](https://gallaghersecurity.github.io/cc-rest-docs/ref/events.html#topic-Operator-privileges) that 'to protect Command Centre from accident and malice, you should strive to grant your REST clients the fewest and lowest-level privileges you can.'
:::

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/L70_55zSDSO3nusME4nyG_gallagher-operator-privilege-details.png" size="75" position="flex-start" alt="gallagher-operator-privilege-details" sha="b285cd5f283326ff426eebca9c8f5db9199b407c" initialPath="/assets/integration-guide/gallagher/gallagher-operator-privilege-details.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-operator-privilege-details.png" showCaption="false"}
::::

:::WorkflowBlockItem
Click `OK` to save your changes and close the window.
:::

:::WorkflowBlockItem
In the `Operator Groups` window, right click on the operator you created and select `Copy`.

You can return to this window if you lose your clipboard content, but note that a REST Client without an Operator will not be able to save.

This copy action prepares the operator for assignment to the REST Client you will create in the next section.
:::
:::::

### Configure the REST Client

::::WorkflowBlock
:::WorkflowBlockItem
Navigate to `Configure > Services and Workstations`.
:::

:::WorkflowBlockItem
Right click and select `New > REST Client`.
:::

:::WorkflowBlockItem
Click `General` in the sidebar and name the REST Client so it's easy to recognise as being associated with Sine Core.
:::

:::WorkflowBlockItem
Click `Event Response` in the sidebar. You can generate actions for any event Group / type by selecting from the dropdowns at the bottom.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/vcnO5mOTOlzUwTkuoj6_4_gallagher-event-response.png" size="75" position="flex-start" alt="gallagher-event-response" sha="a65bd1dc94f4337e1b1c5796daefa33c2f10b738" initialPath="/assets/integration-guide/gallagher/gallagher-event-response.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-event-response.png" showCaption="false"}
:::

:::WorkflowBlockItem
Navigate to the `Alarm Instructions` tab. You can assign instructions for any event Group / type by selecting from the dropdowns at the bottom.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/GN1pcURyCeUWcf15aWyMZ_gallagher-alarm-instructions.png" size="75" position="flex-start" alt="gallagher-alarm-instructions" sha="4e4b282cc08b81e925aa32c4fe530c3e1b0da4a2" initialPath="/assets/integration-guide/gallagher/gallagher-alarm-instructions.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-alarm-instructions.png" showCaption="false"}
:::

:::WorkflowBlockItem
Navigate to the `API Key` tab:

- An API Key is generated for the current REST Client.
- To assign the REST Client Operator you copied earlier, right click in the blank area and select `Paste`.
- If any changes are made to the REST Client Operator, press the `Refresh Operator Privileges` button to update.
- Copy the API Key. You will need it to configure the Sine Core Gallagher Integration.
- The API Key must be kept secret.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/8TITzZG1QIMWiXSFQJE43_gallagher-api-key.png" size="75" position="flex-start" alt="gallagher-api-key" sha="b03927c9f0a85683cb797b4e09f14122fdf125ba" initialPath="/assets/integration-guide/gallagher/gallagher-api-key.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-api-key.png" showCaption="false"}
:::

:::WorkflowBlockItem
Navigate to the `Connections` tab:

- Select `Enable IP Filtering`. This allows a restricted list of IP addresses to connect to your Gallagher Command Centre server.
- If using the direct connection method, input the Sine Core IP addresses listed at [https://sine.support/en/articles/2103291-firewall-rules-and-whitelisting](https://sine.support/en/articles/2103291-firewall-rules-and-whitelisting).
- Refer to the [Network requirements](https://app.archbee.com/docs/mCTukUO8DcS2Qle_mDUH-/6Rg3paDqn31wzJWA3LBlH#U2mog) section for more information.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/8TITzZG1QIMWiXSFQJE43_gallagher-api-key.png" size="75" position="flex-start" alt="gallagher-api-key" sha="b03927c9f0a85683cb797b4e09f14122fdf125ba" initialPath="/assets/integration-guide/gallagher/gallagher-api-key.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-api-key.png" showCaption="false"}
:::

:::WorkflowBlockItem
Once all required configuration has been completed, click `OK` to save your changes and close the window.
:::
::::

### Other Requirements

Configure the following additional items in Gallagher Command Centre before setting up the integration in Sine Core:

### Card Types

Create a new Card Type specifically for use with Sine Core.

::::WorkflowBlock
:::WorkflowBlockItem
Navigate to `Configure > Card Types`.
:::

:::WorkflowBlockItem
Right click and select `New > Access Group`.
:::

:::WorkflowBlockItem
Configure the Card Type as required.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/3hlVZVy_Vzew-kVEFUhnC_gallagher-card-types.png" size="75" position="flex-start" alt="gallagher-card-types" sha="d0494b151c48f9a17e10931537c43436b08c50e1" initialPath="/assets/integration-guide/gallagher/gallagher-card-types.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-card-types.png" showCaption="false"}
:::
::::

### Divisions

Visitors need to be saved to a Gallagher Division. The Gallagher REST Operator must have access to, and the ability to create, cardholders in that division.

::::WorkflowBlock
:::WorkflowBlockItem
Navigate to `Configure > Divisions`.
:::

:::WorkflowBlockItem
Right click and select `New > Division`.
:::

:::WorkflowBlockItem
Configure the Division as required.
:::
::::

### Access Groups

Your Gallagher Command Centre should already contain one or more access groups for your building. Before you begin setting up the Gallagher integration in Sine Core, confirm that your access groups are sufficient for mapping to your Sine Core host groups.

Access Groups are used to provision access for Sine Core visitors after they check in at a kiosk or via the web client.

::::WorkflowBlock
:::WorkflowBlockItem
Navigate to `Manage > Access Groups`.
:::

:::WorkflowBlockItem
Right click and select `New > Access Group`.
:::

:::WorkflowBlockItem
Configure the Access Group as required.
:::
::::

### Personal Data Fields

Sine Core requires that 2 Personal Data Fields (PDFs) be created in Gallagher and assigned to the Access Groups used for visitors.

Assign these PDFs to the Gallagher Access Groups configured in Sine Core for visitors.

It is important to configure the Personal Data Fields exactly as described in the steps below. If these PDFs are not named correctly or assigned to the Access Groups, the integration will fail to create cardholders upon completion of check-in.

::::WorkflowBlock
:::WorkflowBlockItem
Navigate to `Configure > Personal Data Fields`.
:::

:::WorkflowBlockItem
Right click and select `New > Personal Data Field` to create a PDF called `Email` and configure it as `Email` Type.
:::

:::WorkflowBlockItem
Select `New > Personal Data Field` again to create the second required field.
:::
::::

### QR Reader Configuration

If you are using Sine QR Codes for access control, you must install and configure a compatible QR Reader in Gallagher Command Centre before the integration will function correctly.

::::WorkflowBlock
:::WorkflowBlockItem
Install and configure a compatible QR Reader on the Gallagher Controller as a 3rd Party Reader.
A Universal Card Format (UCF) must also be configured so that the Controller recognises the Wiegand format when a credential is read by the QR Reader.
:::

:::WorkflowBlockItem
**Gallagher QR Reader Universal Card Format configuration** — Create a new QR Reader UCF and assign it to every Controller that has QR Readers attached to it:

- Navigate to `Configure > Universal Card Formats`.
- Right click and select `New > Universal Card Format`.
- Navigate to the `Format` tab.
- Configure the format according to your QR reader requirements.
- Select `OK` to save your UCF configuration.
- Navigate to `Configure > Hardware`.
- Click the `+` button to the left of your Command Centre to expand it and locate your controller.
- Double click the controller name to configure it.
- Navigate to the `Card Formats` tab.
- Drag and drop the UCF you configured in the previous steps.
- Select `OK` to save. Remember to assign the UCF to every controller that has a QR Reader attached to it.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/CSzqJ5Z5rLKOyiqVOfRK9_gallagher-card-formats.png" size="75" position="flex-start" alt="gallagher-card-formats" sha="86af1a388d958b3ad2d352ae26263a90c76e2309" initialPath="/assets/integration-guide/gallagher/gallagher-card-formats.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-card-formats.png" showCaption="false"}

- The Fingertec QR reader is known to work with Gallagher Controllers and Sine Core QR Codes. These readers can be sourced from [Fingertec Australia Resellers](https://www.fingertecaustralia.com.au/resellers).

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/uOhkkeLybuOms7Z6aAJZS_gallagher-fingertec-reader.png" size="75" position="flex-start" alt="gallagher-fingertec-reader" sha="17df842ccf194b707330f747bce27d75b7c8b1d6" initialPath="/assets/integration-guide/gallagher/gallagher-fingertec-reader.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-fingertec-reader.png" showCaption="false"}

- Experience has shown that the input voltage may need to be regulated down to 9 volts DC.
- These readers are wired into a Gallagher HBUS 2 Door Module Wiegand Variant or a Gallagher 4R or 8R Module.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/CxJ03P_BgPb87x1FyeKJR_gallagher-hbus.png" size="75" position="flex-start" alt="gallagher-hbus" sha="2c305b0c6000ec9e1c5f03103784dfab7ef085ec" initialPath="/assets/integration-guide/gallagher/gallagher-hbus.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-hbus.png" showCaption="false"}

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/xQegi80Nlsl6VwSioGIgD_gallagher-qr-ucf.png" size="75" position="flex-start" alt="gallagher-qr-ucf" sha="59a45dfb1ba8dc6a9c5884dd3ef2b5a5670ef028" initialPath="/assets/integration-guide/gallagher/gallagher-qr-ucf.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-qr-ucf.png" showCaption="false"}
:::
::::

### Check-out Callback Service

As part of the setup completed by your integration partner, the Gallagher Check-out Callback Service is installed on the Gallagher Command Centre server. This service notifies Sine Core when a check-out event occurs in Gallagher.

- This service is relevant for organisations that want to use an Access Gate QR Code scan to trigger a check-out in Sine Core.
- In conjunction with your Gallagher Visitor Group rules, activating this callback service gives you control over how and when visitors are checked out.

::::WorkflowBlock
:::WorkflowBlockItem
**Generate Sine Core API Key** — In the Sine Core Dashboard, navigate to `Team` and generate an API key. You must be a Team Admin for the site you are setting up to access this option.
:::

:::WorkflowBlockItem
**Download and Install the Callback Service** — [Download the Callback Service installer and documentation](https://drive.google.com/file/d/1dwcPqxdpSTuqSsbd0ZNaOIxsMw-_6Ct6/view?usp=sharing), then follow the installation steps provided.
:::

:::WorkflowBlockItem
**Update Gallagher Command Centre Connection Settings** — For the callback functionality to work, update your Gallagher Command Centre configuration by updating the Connection Settings.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/VteNg-m80eYWowpmVLxz0_gallagher-callback-config-settings.png" size="75" position="flex-start" alt="gallagher-callback-config-settings" sha="8d2ca5b00bbec5823fecc38223d647233a7b5df7" initialPath="/assets/integration-guide/gallagher/gallagher-callback-config-settings.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-callback-config-settings.png" showCaption="false"}
:::
::::

## Sine Configuration

### General Setup

::::WorkflowBlock
:::WorkflowBlockItem
**Admin permissions** — Ensure you have `Team` or `Site Admin` permissions. These permissions are required to configure integrations.
:::

:::WorkflowBlockItem
**Log in** — Log in to the Sine admin dashboard at [https://dashboard.sine.co](https://dashboard.sine.co).
:::

:::WorkflowBlockItem
**Select site** — Navigate to the `Locations` tab and click on the site you want to configure the integration for.
:::

:::WorkflowBlockItem
**Add integration** — In the Site menu, click the `Integrations` menu item. Click the `Add integration` button and select `Command Centre` from the list of available integrations. If the integration does not appear in the list, contact support.
:::

:::WorkflowBlockItem
**Name integration** — Enter a name for the integration. You can use any name, but choose something that helps you identify its purpose.
:::
::::

### Connect to Gallagher Command Centre

Choose the appropriate connection method and licensing option.

- **Sine Licensing** — Toggle on the `Sine Licensing` setting to use the Sine integration partner license for simplified onboarding with Gallagher Command Centre.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/WSrp7qT20lFgw-ZF0KIys_sine-licensing.png" size="75" position="flex-start" alt="sine-licensing" sha="6fde6e519f6cc6cb82124fbbc097db317461c9df" initialPath="/assets/integration-guide/gallagher/sine-licensing.png" githubPath="docs/assets/integration-guide/gallagher/sine-licensing.png" showCaption="false"}

You can connect to Command Centre using two methods. The preferred method is via the Gallagher Cloud API Gateway. For more information on the Cloud API Gateway, see the [Gallagher website](https://products.security.gallagher.com/security/global/en/products/software/command-centre-cloud-api-gateway/p/INT141).

::::::Tabs
:::::Tab{title="Gallagher Cloud Gateway"}
::::WorkflowBlock
:::WorkflowBlockItem
For `Base URL`, enter the official Gallagher Cloud API Gateway: `https://commandcentre-api-au.security.gallagher.cloud`.
:::

:::WorkflowBlockItem
Enter your `API Key`. This value is sourced from the Gallagher REST Client within the Command Centre Configuration Client. Copy the API Key from the Configuration Client and paste it into this field.
We recommend leaving `Ignore SSL Certificate Check` disabled when connecting via the Cloud API Gateway.
:::

:::WorkflowBlockItem
Click `Test Connection` to verify that the connection to your Gallagher Command Centre is working. When the test completes, a list of results is displayed confirming whether the connection was successful or helping you diagnose any problems.
:::

:::WorkflowBlockItem
Once you have verified that the configuration is correct, click `Create`.
:::
::::
:::::

:::::Tab{title="Direct API Connection"}
Connect directly to the Gallagher instance using its externally accessible IP address and port number, in the format `xxx.xxx.xxx.xxx:PORT`.

- `xxx.xxx.xxx.xxx` is the IP address of the Gallagher server that Sine Core will communicate with via the Gallagher REST API.
- `PORT` is the port used for the connection (the default is `8904`).

:::hint{type="info"}
The Gallagher IP address must be routable from Sine Core to the Gallagher server.
:::

::::WorkflowBlock
:::WorkflowBlockItem
The Gallagher server should have a fixed IP address on the LAN. Configure the internet router to port forward the designated port (`8904` by default) from the WAN to the Gallagher server on the LAN by specifying the internal IP address.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/VTQvsXHGT0s5Ya6Iz0Mu3_gallagher-port-forward.png" size="75" position="flex-start" alt="gallagher-port-forward" sha="4cf36543da2943d555bb126c83f78209dc37bece" initialPath="/assets/integration-guide/gallagher/gallagher-port-forward.png" githubPath="docs/assets/integration-guide/gallagher/gallagher-port-forward.png" showCaption="false"}
:::

:::WorkflowBlockItem
Enable `Ignore SSL Certificate Check` if you are using a self-signed certificate, since the Gallagher integration will not be able to validate the certificate in this case.
:::

:::WorkflowBlockItem
Click `Test Connection` to verify that the connection to your Gallagher Command Centre is working. When the test completes, a list of results is displayed confirming whether the connection was successful or helping you diagnose any problems.
:::

:::WorkflowBlockItem
Once you have verified that the configuration is correct, click `Create`.
:::
::::
:::::
::::::

### Integration Settings

### Credential Configuration

Controls the type of access control credential that is generated when the integration runs.

Select your preferred credential type below.

::::::Tabs
:::::Tab{title="Sine QR Code"}
Generates and attaches a QR code to a visitor's pass. The integration runs when a pass is created or expired, or when the visitor checks out.

::::WorkflowBlock
:::WorkflowBlockItem
**Provision credentials on invitation** — By default, visitor credentials are provisioned at check-in. If you enable this toggle, the QR code included in the visitor's invitation email is provisioned in Gallagher Command Centre and activated closer to the visitor's invitation start time. Use this option to provide a more seamless experience by provisioning car parking access or access to secure areas before the visitor arrives. Note: if you enable this toggle and also want to provision credentials on check-in, you will need to create a separate integration.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/lknRqPyfPLqAaxlybscZn_provision-on-invitation-toggle.png" size="75" position="flex-start" alt="provision-on-invitation-toggle" sha="08ccb35ca52a000d1f42178a90ae25edc1d030f3" initialPath="/assets/integration-guide/gallagher/provision-on-invitation-toggle.png" githubPath="docs/assets/integration-guide/gallagher/provision-on-invitation-toggle.png" showCaption="false"}
:::

:::WorkflowBlockItem
**Badge Style** — Select the style of printed badge to use when this integration runs. Some access control readers require a specially formatted Access badge style rather than the default name badge style.
:::

:::WorkflowBlockItem
**Send QR Code by SMS** — If the visitor's mobile number is available, send them a QR code credential via SMS. This can serve as a useful backup to a badge printer.
:::

:::WorkflowBlockItem
**Provision credential on check-in** — Select one or more visitor types for which the integration should provision credentials in your access control system when the visitor checks in using Sine. Ensure that the `Host Selection Required` checkbox is ticked for any visitor types used in access control integrations. Without this setting, visitors would be issued access credentials without requiring host approval. You can review which of your visitor types have `Host Approval Required` enabled in the `General` tab of your site settings.
:::

:::WorkflowBlockItem
**Grace Period** — A visitor may use Sine to check out before leaving the location but still need to use their credentials to exit. You can set a grace period to ensure their access control credentials are not deprovisioned immediately after check-out in Sine.
:::
::::
:::::

:::Tab{title="Physical Assets"}
Activates a physical asset (for example, an HID card) in your Gallagher Command Centre system. The integration runs when an asset is assigned, returned, or marked as lost.

- **Asset type** — Select the asset type applicable to this integration. You can create new asset types on the assets page in the Sine Core Dashboard.

::Image[]{src="https://api.archbee.com/api/optimize/cIIINwBBlIs0Au1Y_bwqP/XcAEiQfIPF0cbUO-ifhhx_asset-types.png" size="75" position="flex-start" alt="asset-types" sha="9948c7af5630a38ed4cabebd9c506f0555d1785d" initialPath="/assets/integration-guide/gallagher/asset-types.png" githubPath="docs/assets/integration-guide/gallagher/asset-types.png" showCaption="false"}
:::
::::::

### Basic Configuration

::::WorkflowBlock
:::WorkflowBlockItem
**Card Type** — Select a `Card Type` from your Gallagher system to use when creating visitor credentials.
:::

:::WorkflowBlockItem
**Division** — Select the `Division` that the card will be assigned to.
:::
::::

### Personal Data Fields

::::WorkflowBlock
:::WorkflowBlockItem
**Check-in photo** — Map the PDF from your Gallagher system that will contain the visitor photo.
:::

:::WorkflowBlockItem
**Company name** — Map the PDF from your Gallagher system that will contain the company name.
:::
::::

### Access Group Mapping

You must map at least one host group or zone to a Gallagher access group for the integration to work.

- **Access type** — Select how you want to map visitor credentials to your Gallagher access groups:
  - By mapping the Sine Core host group to a Gallagher access group.
  - By mapping the Sine Zone to a Gallagher access group (available only if the Zones feature is enabled for your account).
    For each type (host group or zone) that you want to map, click `Create Mapping`. You will be prompted to select:

::::Tabs
:::Tab{title="The Sine Core host group and the Gallagher access group you want assigned to a visitor of those hosts."}

:::

:::Tab{title="The Zone and the Gallagher access group you want assigned to a visitor entering that zone."}

:::
::::

- You will also be prompted to enter any optional PDF values you may want added to the visitor's details in your Gallagher system. These are intended for the Schindler Elevator Integration.

### Messages

- **Visitor failure message** — If the access control integration fails for any reason, this message is displayed to the visitor.

### Notifications

- **Send integration failure notifications** — If the integration fails, you can enter one or more email addresses to be notified of the failures and their corresponding details.

# Testing

::::WorkflowBlock
:::WorkflowBlockItem
**Create a test check-in** — Create a test visitor check-in using a visitor type configured for the integration.
:::

:::WorkflowBlockItem
**Verify credential provisioning** — Verify that the visitor profile is created in the vendor system and that credentials are provisioned correctly.
:::

:::WorkflowBlockItem
**Test credential access** — Test the credential at a compatible reader to confirm that access is granted.
:::

:::WorkflowBlockItem
**Verify credential revocation** — Check out the test visitor and verify that access credentials are revoked after the configured grace period.
:::

:::WorkflowBlockItem
**Check failure notifications** — Monitor the integration failure notifications to confirm that they are working correctly.
:::
::::

***

*Need help? Contact Sine Support at* **[support@sine.co](mailto\:support@sine.co)**
