NOTE: Software-based ACS Integrations are a licensed feature from Alcatraz and are not required for a functioning Alcatraz system. Contact AAI Sales for more information.
Requirements
Alcatraz Platform Software |
v3.1.1 (On-prem or Cloud*) |
Genetec Synergis Genetec WebSDK |
v5.10.4, 5.11.4, and 5.12.4 |
Genetec License | GSC-1SDK-ALCATRAZ-ROCK |
* Cloud-hosted Platforms require an ACS Integration Proxy application to be installed on the same network as the access control system server. Contact AAI Support to obtain this software.
Notes on Operation
In the current implementation, the ACS Integration will delete profiles that do not have at least one badge that is also present in the ACS. Profiles will be deleted if all associated cards are deleted in the ACS. This includes the scenario whereby a cardholder's 'lost' card is deleted before a replacement card is added.
Genetec User Creation
The following procedure describes creating a User in Security Center that the Alcatraz Platform will use for syncing with the Genetec system via the WebSDK.
Role Creation
- In the Genetec Config Tool, navigate to "System" and then "Roles"
- Click
Add an entity
, give it a name, select a partition, and clickNext
. - Review the Role and click
Create
to continue. - Finally, you will see the default port and URI settings.
User Creation
- In the Genetec Config Tool, under "User Management," create a User and assign them the role created above.
Alcatraz Proxy Service Installation (Cloud-Hosted Only)
Cloud-hosted Platforms require an ACS Integration Proxy application to be installed on the same network as the access control system server. Contact AAI Support to obtain this software.
- In the Alcatraz Admin Portal, download the certificate in PEM format, as shown in the "Genetec Integration Configuration" section below.
- Copy the certificate to the server where the Proxy Service will be installed. In the screenshot below, the certificate was placed in the "C:\Program Files\Certificate" directory.
- Run the Alcatraz Proxy installation file 'as an administrator'.
- Configure the following directory items and click
Next
:- Installation Directory: C:\Program Files\Alcatraz AI\Proxy (default)
- Data Directory: C:\ProgramData\Alcatraz AI\Proxy (default)
- Certificate Directory: C:\Program Files\Certificate (default)
- Certificate Name: "acs_public_certs.pem" (default)
- Click
Next
on the "Certificate Settings" screen. - Enter the hostname or IP address and the port number (3300) that the ACS Integration service will use to connect to the Alcatraz Platform. For example, "acs.us.alcatraz.ai:3300".
- Click
Next
to complete the installation.
Genetec Integration Configuration
WARNING: Due to the current operation of the ACS Integration service, a false URL needs to be initially configured for the Genetec connection until the facility code mapping step can be completed. If this is not done, ALL profiles will be deleted, as they will not be able to sync to badge numbers in the Genetec system. Contact AAI Support for assistance if you have existing profiles that you do not want to lose.
It is recommended that a VM Snapshot is generated and the system is backed up before attempting to configure an ACS Integration.
Main Settings
Click Enable ACS Integration
and followed by Edit ACS Configuration
:
Enter the following details:
- ACS Integration: Genetec
- Host URL:
- (new installation) https://<DNS_or_IP_of_Genetec>:4590/WebSdk
- (existing profiles) https://badURL (IMPORTANT! - SEE WARNING ABOVE)
- Username: {the Security Center User created previously}
- Password: {the Security Center User created previously}
- Custom Field: {unused}
- Schedule Full Sync: {daily time for full sync}
- Send Security Events: {Optionally send Alcatraz Security Events to Security Center}
- Use Proxy: {Enable for Cloud-hosted*, Disable for On-Prem}
Notes:
- Click
Test Connection
to verify communications with Genetec. If the integration comes ‘online’, clickSave
. If a false URL was entered, just clickSave
and confirm communications later in the process. - ACS Integration status can be seen at the top of the “Account” page and in the “ACS Integration” section under “Account.”
- *Cloud-hosted systems will need to download a PEM certificate. This certificate is required during the installation of the Proxy Service to secure the communications between the Proxy and the Cloud Platform. See earlier in this article for more details regarding installing the Proxy service.
Facility Code Mapping
Assign facility codes to card formats for the badges that the Alcatraz Platform should sync with Genetec.
ACS Integration Logs
The ACS Integration section contains ACS Integration logs and a button to initiate a full sync.
Map Genetec Card Readers to Rocks
Click Add Reader
and map each Rock to a reader in Genetec.
Update the "False" URL (if needed)
This step is only required if a "False" URL was entered above for the WebSDK to prevent profiles from being deleted.
Once all configurations are completed, update the WebSDK URL to the proper address and click Save
:
- Host URL: https://<DNS_or_IP_of_Genetec>:4590/WebSdk