Knowledge base 89: Using MorphoManager BioBridge with Paxton

Knowledge base 89: Using MorphoManager BioBridge with Paxton

Introduction

BioBridge is an enrollment and synchronization middleware that overlays enrollment and demographic synchronization between MorphoManager and third-party data sources. The infrastructure is extensible and supports interfacing to multiple third-party systems (one at a time) by the implementation of an interface. BioBridge is not dependent on the underlying technology platform required for integration.

BioBridge supports the following version/s of Paxton Net2 WebAPI:
6.02.8928.4090
 6.04

Paxton Net2 6.07 or later is currently not supported by MorphoManager.

Installation

Idemia readers require both a LAN connection and a Wiegand connection. The LAN connection sends the biometric data to the readers and the wiegand connection sends the users number to the Paxton Net2 to confirm if access is allowed or denied. Wiring the LED control between the Paxton Net2 and the Idemia reader are highly recommended to improve the end users experience.


Connection
Paxton Wiegand Connection
SIGMA Lite / SIGMA Lite +
SIGMA Wide
SIGMA Extreme
MorphoWave XP / MorphoWave SP / VisionPass
VisionPass SP
Wiegand Ground
0V. Black
20. WIEGAND_GND. Black/Red
20. WIEGAND_GND. Black/Red
8. WIEGAND_GND. Black/Red
27. WIEGAND_GND Black/Red
7. GND. Black
Wiegand Data 0
Data/D0. Yellow
14. WIEGAND_OUT0. Green
24. WIEGAND_OUT0. Green
4. WIEGAND_OUT0. Green
24. WIEGAND_OUT0. Green
5. OUT0. Green
Wiegand Data 1
Clock/D1. Blue.
16. WIEGAND_OUT1. White
21. WIEGAND_OUT1. White
5. WIEGAND_OUT1. White
26. WIEGAND_OUT1. White
6. OUT1. White
Green LED
LED Green
17. WIEGAND_LEDOUT1. Blue
25. WIEGAND_LEDOUT1. Blue
1. WIEGAND_LEDOUT1. Blue
25. WIEGAND_LEDOUT1. Blue
2. LED1. Blue.

Setting up BioBridge

1. Ensure that the MorphoManager Server & Client software are installed onto a PC/Server which is on the same network as the Net2 Server or alternatively install Morpho Manager Server directly onto the Net2 Server where possible.

3. Download and Install SQL Server 2022 using the following guide: https://controlsoft1.zohodesk.com/portal/en/kb/articles/manually-installing-sql-server-express
4. Install the Morpho Server, Morpho Client and the Paxton License installer on the same machine as the Paxton Net2 server.
5. Once these steps are taken please restart the PC/Server.
6. Once the PC has restarted, log back in and run MorphoManager Server Manager from Windows Start Button > All Programs/All Apps> MorphoManager
7. Ensure the server has started, if not click ‘Start Service’ - If the service will not start contact support@controlsoft.com 


8. Now open the ‘MorphoManager Client’ application, generate a license activation file and register it using the online registration tool you will relieve an activation file via email which needs applying again in the MorphoManager client. Once this is done move on to the next step.
9. Log in with the default username and password (administrator/password) and select [Administration] followed by [Biometric Device] from the left-hand menu.
10. You will be presented with the Express Wizard. Select Cancel. 
11. On the Secure Communication Police Details screen, select "On Demand Security". Press Save and select Yes to the prompt. Click Finish.

10. Go to Administration and select Biometric Device Click [Add] and give the device a name.
11. (Optional) Fill out Descriptions, Location, Asset ID and Export Value.
12. Ensure Time Zone is set for the correct country.
13. Select correct Hardware Family for the reader being installed.
14. For Hostname\IP Address - Type IP address of the reader or the Host name.
15. Leave the port number as 11010
16. For Biometric Device Profile select Default.
17. Skip time & attendance and Onsite Offsite.
18. Now click Finish.
19. Next click Biometric Device Configuration from the left-hand menu. 

20. Click [Edit] from the Biometric Device Configuration Menu at the top then click [Next].
21. Under General settings use a Wiegand profile to match the Net2 system (usually 26-bit or 26-bit PACS if you are using cards). 
22. Click [Next] until you see Multi-Factor Mode settings choose a setting that is compatible with your Morpho reader. If the Morpho reader has a card reader installed, select the card technology here, if not use Biometric Only and click [Next].
23. Access Control Mode Settings use Integrated By Wiegand / Panel Feedback.
24. Panel Feedback Mode select LED Feedback (2 Wire) then click [Finish].
25. Now go to User Configuration and set the Access Mode to ‘Per User’.


26. Next set the Wiegand Profile to Standard 26 bit (or the format which matches Net2) and click [Finish] 
27. Ensure you have at least 1 department set up in the Net2 software
28. In Net2 set up your doors and readers using a 26-bit wiegand format in this example.
29. Now back in MorphoManager Client, select User Distribution Group from the Administration menu.
30. Click [Add] from the top menu, type a name to match a Department in the Net2 software and click [Next].
31. Select the biometric device to which this group requires access and click [Next].
32. Tick which Morpho Client PC’s are allowed to enrol users into this group then click [Finish].
33. Login to Net2 Configuration Utility and click on Security.
34. Unselect Disable LocalAPI, apply and let Net2 reboot.
35. Next, go to System Configuration from the bottom of the left-hand menu.
36. Select BioBridge from the top tabs.
37. For the System setting choose Paxton Net2v6 WebAPI and click Configure connection. 

38. Type the Net2 Server IP address (If Net2 server is installed on the Morpho Server use localhost).
39. Keep the port number as 8080 unless this has been changed in Net2.
40. Type the username and password for a user with Engineer/Supervisor access rights, then click [OK].
41. For Wiegand Profile / Token Type select Fingerprint Verification Number
42. For Departments Mode select Manual.
43. Change Delay Between Each User Synchronization to 100
44. If you have more than one User Configuration you can force the enrolment of a chosen Configuration here, otherwise, leave it unticked.
45. Now you can map your Net2 Departments to the User Distribution Groups. 



47. Once this is done, click [Save].

Embedded enrollment button setup

In order to launch the enrollment process from within Paxton Net 2 the following steps will need to be completed after completing the “Setting up Biobridge” section of this guide.

1. To add and configure the “Add User and Enroll Biometics” button so that it appears when creating a new user in Paxton Net 2, do the following:
• Go to the MorphoManager Client directory (default install of the MorphoManager Client will be C:\Program Files (x86)\Morpho\MorphoManager\Client).
• From the MorphoManager Client directory run the “ID1.MM.PaxtonNet2EnrollmentButton.exe”
2. This will launch to the PC’s System Tray. When this application is running, the “Add User and Enroll Biometrics” button will be available to use in Paxton Net2.
3. Options for the Enrollment Application
• Once the application is running in the System Tray, right-click it and choose Options.
• From the Options menu select whether the application should start automatically each time the user logs into the PC. NOTE: This setting is per user login.
• From the Options menu the Paxton Net2 Connection Settings will also need to be configured and tested. These should be the same connection settings as used in configuring BioBridge earlier in this guide.

4. Now you can add/edit a user in Net2 to have a Fingerprint Verification Number starting from 1 and add them to the Department mapped to BioBridge. 
5. There will now be a button in the bottom right to launch the MorphoManager BioBridge Enrollment Client -




Enrolling a user into MorphoManager via Paxton Net2

With the enrollment application running as described above in step 44, an “Add User and Enroll Biometrics” button will now appear in the Add User window for Paxton. Make sure that all of the pertinent information that is needed to create a user is present and click Add User and Enroll Biometrics. This includes First name, Last name, Department, Access level, Token number, and Token type. Please note that the same Token type must be used as was selected in the configuration of BioBridge earlier in the manual in order to enroll the user into MorphoManager.

Where LED control is used in MM

When Green LED control is set up in MorphoManager to provide grant access on the reader, the following setting is needed for Paxton Net2 -


Paxton Proximity Reader + Biometric

It is possible to enable Paxton Prox + biometric, to do so the reader will need to be changed to Wiegand IN and the unit configured to work in Clock + Data mode.
1. Setup a new Biometric Device Profile in Express Configuration Mode. 
2. For Wiegand Profile select "Standard 26 Bit", however this mode is actually not referenced when in Clock + Data mode.
3. Under Multi-Factor Mode Settings, select "Wiegand In".

4. Under "Access Control Mode Settings", select "Integated by Wiegand / Panel Feedback" and "Panel Feedback Mode" as "LED Feedback (2 Wire)

5. Proceed to "MA Sigma, MA Sigma Lite, MA Sigma Lite+, MA Sigma Extreme, MA VP MD, VisionPass, MorphoWave Custom Parameter" and add the following.
  1. ucc.finger_bio_auth_rule = 1 (For MA Sigma range readers, this tells the reader the Wiegand In number is to match a fingerprint)
  2. ucc.biometric_bio_auth_rule = 1 (For VisionPass and Wave readers. this tells the reader the Wiegand In number is to match a Fingerprint.
  3. ucc.per_user_rules = 0 (This will disable the per user rule check)
  4. wiegand.external_port_input_type = 1 (This changes the input type to Clock + Data)
  5. wiegand.external_port_output_type = 1 (This changes the output type to Clock + Data)
6. Once this has been created, add the biometric device profile to your reader, make sure the reader restarts after its rebuild is complete.
7. To add new users with a Paxton token ID, there needs to be a Wiegand Format that allows for 32 bit decimal numbers. Create a new Wiegand Profile in MorphoManager for 32 Bit. Select "Bit Length" as 32.

8. Add a "User" type element, with a length of 32 bit.


9. Apply this Wiegand Profile to the User Configuration being used by Paxton Net2.


Please contact support@controlsoft.com if you are experiencing any issues configuring the above.