Access Control HID

Jump to navigation Jump to search

This plugin lets you manage an access control installation with HID devices.

Before using the plugin, configure all the HID I/O Servers needed and make sure they all communicate correctly with HSYCO. No user configuration will be needed on the HID devices since the access rules are stored and managed by HSYCO.

To view the access control interface go to the URL of the "access" project on your server; for instance

From the main page you can access the different sections:

Plugin access control hid menu.png


To configure the installation go to the configuration page by clicking on the icon in the bottom-right corner.

Plugin access control hid config.png

This page list all the defined areas and the detected HID modules.


An area represents a set of modules (doors) which share the same access rules.

To create a new area, press the "+" button and provide a unique name.

To edit, remove, disable or re-enable an area, click on the corresponding entry in the list. Disabling an area means temporarily blocking the access to all users to all the doors belonging to the area, until re-enabled. If an area is not enabled, the corresponding entry in the list will be grayed out.


The list of modules show all the HID Solo IO servers defined in HSYCO's settings and their corresponding names as defined in the modules' configuration. If an entry appears of red color, it means that HSYCO cannot connect to the module.

Clicking on an entry in the module's list it is possible to access and edit its configuration:

  • ID: the ID assigned to the corresponding IO server. Cannot be modified.
  • Name: by default is the name set in the HID module's configuration. It can be changed to any other unique name.
  • Enabled: if unchecked no user will be allowed to access to door.
  • Type:
    • One reader: Only one reader is connected to this module.
    • Two reader: Two readers are connected to this module: entrance and exit readers.
    • Programmer: This module will not be used to control an entrance; instead, it will be used by the application as card reader to assign cards to users.
  • Area: area this module belongs to.
  • Entrance/Exit reader:
    • Card: users only use cards to access from this reader.
    • Pin: users only use pin codes to access from this reader.
    • Card and Pin: users use cards in combination with pin codes to access from this reader.
    • Card or Pin: users use cards or pin codes to access from this reader.
  • Invert entrance/exit: in the case of a "Two readers" module, checking this option will cause the application to invert the default transit directions.

System access

The System Users and Permissions buttons allow to manage the system users who will use the access control application and specify which functionalities to allow/deny to each user.

Installation settings

The Facility code must be set to the value assigned by HID to your installation when purchasing the system.

The Max delay between card and pin option allows to specify how much time can elapse between the reading of a card and the inputing of the pin code for readers with typology "Card and Pin".


The Backup button gives access to the list of previously saved backups and allows to create a backup of the current configuration.

User Groups

Plugin access control hid groups.png

This page lists all defined user groups and their access rules.

To create a new group click on the "+" button at the bottom of the list. Set a descriptive name, select the areas accessible by this group and specify the daily schedules.

The "Enabled" option, if unchecked, disables the access for all the users belonging to this group.

The "Special dates" link takes you to a page where you can define exceptional dates on which the access rules are different from the daily schedules set in the user groups page. Each rule will be applied only to the groups selected in the corresponding field, for the groups not selected the normal daily schedule will apply.

Plugin access control hid spec dates.png


Plugin access control hid users.png

This page lists the users of the facility divided by groups. Select a user group to see the users belonging to it.

To add a user, select the user group to add it to and click on the "+" button. Then, enter the user name, optionally add a due date after which the user won't be granted any access and specify the corresponding card number and/or pin code. If programmer modules are available it will be possible to use them to read the card numbers.

Unchecking the "Enabled" option will deny the access of the user to all areas until re-enabled.

To permanently remove a user, select the corresponding entry in the list, click on the "-" button and confirm the operation.

Doors status

Plugin access control hid doors.png

This section lists all the detected doors connected to the system. Select an entry to check its status or to send commands.

An open door will be of yellow color in the list, while doors with active alarms will be of red color.


Plugin access control hid log.png

In this page the last 1000 system events are reported.

It is possible to filter the entries clicking on the magnifier icon end setting the desired criteria.

Plugin access control hid log search.png

The result entries can be exported via e-mail.

Log entries are also permanently saved in CSV format in files contained in the directory "access_ctrl/logs" in the HSYCO root on the server.


The application generates USER events that can be used to add custom logic to access events.

When a user is granted access the following USER events are triggered:

access.granted.door.<module_id> = <group_name>
access.granted.area.<area_name> = <group_name>

When a user is denied access the following USER events are triggered:

access.granted.door.<module_id> = <group_name_if_available_or_empty_string>
access.granted.area.<area_name> = <group_name_if_available_or_empty_string>