Admin permissions are necessary in order to configure this integration. (See Step 1).
Please whitelist the following IP addresses for inbound and outbound communication:
Verify your Unity instance public IP and port. Please whitelist the port alongside the above IPs.
How does Avigilon work with Envoy?
Envoy will send a record of every visitor who signs in on the iPad into the Avigilon event log. Envoy will automatically create an identity in Avigilon for each new visitor.
You can configure Envoy to apply a certain identity type, site location, building, and/or role for your visitor records. You can then utilize all of Avigilon’s features for your visitors, such as badge provisioning, security alerts, and more.
Step 1: Create an admin account in Avigilon
Giving Super admin access would be easiest; however, if your team would prefer not to give that access, the login credentials being used would need the following permissions:
Tokens Edit Last Area
Step 2: Whitelist IP addresses
In order for the application to work and connect to your Avigilon instance, please allowlist the following IP addresses:
Step 3: Install the Avigilon App in Envoy
Navigate to Apps > All Apps.
Under Access Control, find Avigilon.
Enter your Avigilon account login credentials and publicly available IP address/name (and port, if necessary), and click “next step.”
Enter information about how you would like visitors to be assigned Identities in Avigilon. The identity type and identity role are required.
Step 4: Setup Employees (Protect ) options and Badge Event Data
If your company has Envoy Protect enabled, please continue with the setup by selecting your options to enable Envoy Protect and or opt-out specific employees from the automation.
Protect Enabled: This option will enable all options in the section to be configured. Disabling this option will disable all options regardless of their state (e.g., "Disabled During Sign Out" toggled on).
Exclude Employees: This option allows you to select employees to entirely exclude from Envoy Protect functionality.
Enable During Sign In: This option will enable employee badges during sign in with Protect.
Disable During Sign Out: This option will disable employee badges during sign-out from Protect.
Share Badge Data with Envoy [Optional]: This feature enables the ability to configure an XML Collaborator using your uniquely generated URL. The XML Collaborator will pass Envoy badge event data from ACM usage.
Step 5: Complete the Setup
Please click Complete Setup to save your configuration
Envoy Protect + Avigilon application
❗️DISCLAIMER: Avigilon identities (employees) need to be enabled or disabled depending on your Envoy Protect Avigilon configuration. Please plan ahead to pre-configure Token Status depending on your preferred configuration.
How does the integration work?
The employee has answered the preconfigured questions by the Envoy admins.
They pass screening based on the set of rules
(i.e. Have you been in contact with someone feeling ill over the past 14 days?)
The employee will be approved to come into work
When the employee goes to the office, the employee will need to "Sign-In" in order for their badge access to be reactivated to allow them to enter the building.
How to enable badge event data in Avigilon?
Find "Setup & Settings" > "Collaboration" within your Avigilon account.
Select to add the new Collaborator under "Host"
Find and input the URL like the following: https://envoy-plugin-avigilon.apps.envoy.com/external/subscription?id=xxxxxxxxxx
How do Envoy entries look in Avigilon?
Sign yourself in as a test visitor to ensure that your visitor entry is sent to the Avigilon event log.
Log into your Avigilon instance.
Your test visitor record will appear in the event log.
Note: Visitor name will appear in the source column and the last name and first name columns correspond to your Avigilon admin name.
You can search for all of your visitors based on the identity type.
You can also examine and adjust each visitor’s individual identity.