12.3.15.4

HMAC Authentication for Sending Event Notifications

InfoGenesis POS has been enhanced to support HMAC (Hash-based Message Authentication Code) authentication for event notifications. 

This enhancement enables event notifications to be securely sent to external systems. A signature generated using a configured key allows the receiving system to verify the authenticity of the request.

Prerequisites

• The latest version of the following add-ons must be mapped to the Integration Application Service module type in License Administration:

  • IAS_Channel_ eventnotification_<version>

  • IAS_Adapter_servicesintegration_<version>

• The property must work with the external system to provide the following values:

  • UserName

  • Password

  • Url

Important Points

• Transactions with Failed or Void statuses are not included in event notifications.

• This feature is not applicable for employee events.

• If a check has item and modifier that are sent to 2 different expos, then event notification will be sent twice after bumping item and modifier.

• Events for orders placed and orders prepared when IAS service is stopped will not be triggered again when IAS service restarts.

Changes Made in IGCM

• A new radio button, Others (HMAC), has been added under the Integration Services section of the IAS Adapter Configuration menu (POS Configuration ➜ Interfaces ➜ IAS Adapter Configuration). The following new fields are displayed when the Others (HMAC) radio button is selected:

  • UserName

  • Password

  • HeaderInfo

  • Url

  • HMACSecretKey

  • HMACHeaderKey

  • HMACAlgorithm

Configurations in IG App Central

Install the IAS pod in the IG App Central running on the InfoGenesis App Server.

Enter the following custom key information in Global Configurations under Add Custom Key section:

Key	Value
iasurl (Type: Other)	Enter https://10.10.10.10:8118 Replace 10.10.10.10 with the IP address of the App Server where the IAS pod is running.

Select Add.

Configurations in IGCM

Configure IAS Adapter

Navigate to POS Configuration ➜ Interfaces ➜ IAS Adapter Configuration Group.

Select Add.

Create a record in this menu for casino based on the interface property is integrating with.

In the Basic Details submenu, enter the name in the Configuration Group field. The Site Guid field displays an autogenerated value, and the field cannot be edited.

In the Mapping submenu, the adapter configured for this adapter group is displayed after the mapping.

Select Save.

Navigate to POS Configuration ➜ Interfaces ➜ IAS Adapter Configuration. 

Select Add.

Refer to the following table and fill in the fields:

Field	Description
ID	Enter an ID for the IAS Adapter.
Configuration Name	Enter a preferred name for the IAS Adapter.
Use Global IAS	Enable this checkbox; applicable to both OnPrem and SaaS.

Under the Settings submenu, enter values for the fields as captured in the following table:

Field	Description
Channel Name	Select eventnotification from the drop-down list.
Adapter Name	Select servicesintegration from the drop-down list.
Adapter Category	This value is auto filled when the channel and adapter names are selected. It is a read-only field and cannot be edited.
URL	OnPrem: The URL is auto filled if the Use Global IAS checkbox is enabled. If IAS is running on the interface server, enter https://10.10.10.10:8118 (Replace 10.10.10.10 with the IP address of the interface server where the IAS pod is running). SaaS: APAC - https://ig.onagilysys.sg US - https://ig.onagilysys.com EMEA - https://ig.onagilysys.eu

Navigate to the Integration Services section.

Enable the Others (HMAC) toggle.

Refer to the following table and fill in the fields:

Field	Description
UserName	The username used for authentication of the external system request. Alphanumeric, underscores, and period symbols are accepted.
Password	The password used for authentication of the external system request. A minimum of 8 characters with at least one uppercase, one lowercase, and numeric value must be configured. A maximum of 50 characters is supported.
HeaderInfo	The data to be sent as a part of the event notification.
Url	The URL of the external system to which event notifications are sent.
HMACSecretKey	Enter the key used to generate signature for the external system request authentication.
HMACHeaderKey	The header key name that carries the HMAC signature. Alphanumeric, underscores, and hyphen symbols are accepted.
HMACAlgorithm	Enter the hash function SHA-256 or SHA-512 to produce a unique message authentication. This field is reset to default value if an invalid or unsupported value is entered. Default Value: SHA-256

Navigate to the Configuration Group submenu.

Select the configured IAS adapter configuration group from the Assign Configuration Group drop-down list.

Select Save. Upon a successful save, a message, HMAC configuration saved successfully, is displayed.

Configure Enterprise

Navigate to POS Configuration ➜ Administration ➜ Enterprise.

Select the appropriate record and select Edit.

Navigate to the Event Notification submenu.

Refer to the following table and fill in the fields:

Field	Description
Enable Event Notification	Enable this toggle.
Order Event	Enable this checkbox to send order event details to external system service.
IAS Adapter Configuration	Select the appropriate IAS adapter from the drop-down list.
Configuration Group	Select the appropriate IAS adapter configuration group from the drop-down list.

Select Save.

Configure Terminal Option

Navigate to POS Configuration ➜ Terminals ➜ Terminal Option Group.

Select the appropriate record and select Edit.

Navigate to the Terminal Options submenu.

Enable Terminal Option 1440 (Send Event Notification). It is mandatory to enable this terminal option to support this feature.

• When enabled, event notifications will be sent. This applies to services that are integrated within the IAS Configuration.

• When disabled, event notifications will not be sent. By default, this option is disabled.

Select Save.