Configure the Healthcare Listener
After you install a Jamf Infrastructure Manager instance, the JSS allows you to enable and configure the Healthcare Listener on the Infrastructure Manager instance.
When you configure the Healthcare Listener, you must do the following:
-
Specify IP addresses or a range of IP addresses to accept incoming ADT messages from
Note: The Healthcare Listener is compatible with IPv4 and IPv6 connection methods. -
Specify a port number
Note: The default port value is 8080. This should be changed to the port number that the Healthcare Listener uses to receive healthcare management system communications. -
Add rules by configuring settings that enable the JSS to send commands to devices (For more information, see Healthcare Listener Rules.)
You can also enable email notifications in the event that a command is not sent.
Healthcare Listener Rules
Configuring a rule enables the JSS to send remote commands to devices when the Healthcare Listener receives an ADT message. If you want to send more than one type of command or use more than one type of ADT message, you must configure a separate rule for each. You can configure as many rules as your organization requires.
The following table provides an overview of the settings you can configure for each rule:
Setting |
Description |
Remote Command |
This setting allows you to specify which command you want sent from the JSS when the Healthcare Listener receives an ADT message. You can choose from the following commands:
For more information, see Remote Commands for Mobile Devices in the Casper Suite Administrator's Guide. |
ADT Message |
For the JSS to send commands to devices, the Healthcare Listener must receive an ADT message. You can choose from the following ADT message types:
|
Mapping Fields |
ADT messages contain multiple fields of information that the Healthcare Listener can extract. You can choose which ADT message field to extract, and then map that field to an attribute from user and location information in device inventory. For example, you can choose the field that returns "bed number" and map that field to the "Room" attribute in a device's inventory information. The command you specify is then sent to devices that match the inventory attribute you select. You can choose from the following ADT message fields:
In addition, you can create an extension attribute for a specific inventory attribute that fits your environment. After you create the extension attribute, it is available as an option. (For more information about creating an extension attribute for a mobile device, see Mobile Device Extension Attributes in the Casper Suite Administrator's Guide.) |
Email Notifications |
Email notifications can be sent from the JSS to specified users for the following events:
To enable email notifications, you need an SMTP server set up in the JSS. (For more information, see Integrating with an SMTP Server in the Casper Suite Administrator's Guide.) |
Requirements
To configure the Healthcare Listener and take full advantage of its latest features and enhancements, you must install and configure the latest version of the Jamf Infrastructure Manager. (For more information, see Install a Jamf Infrastructure Manager Instance that Hosts a Healthcare Listener.)
Setting up the Healthcare Listener
-
Log in to the JSS with a web browser.
-
In the top-right corner of the page, click Settings.
-
Click Server Infrastructure.
-
Click Infrastructure Manager Instances.
-
Click the Infrastructure Manager instance with the Healthcare Listener that you want to configure.
-
Click Edit.
-
Select the Enable Healthcare Listener checkbox.
-
Enter a display name for the Healthcare Listener.
This is the name that is displayed for the Healthcare Listener on the Infrastructure Manager. (For more information about viewing the services that are installed on an Infrastructure Manager instance, see Jamf Infrastructure Manager Instances in the Casper Suite Administrator's Guide.) -
To specify the IP addresses to accept incoming ADT messages from, do one of the following:
-
Select All IP Addresses to accept incoming ADT messages from any IP address.
-
Select Single IP Address or Range of IP Addresses to specify the IP addresses to accept incoming ADT messages from, and do the following:
-
To specify a single IP address, click the (+) Add button for Single, and enter the IP address.
-
To specify a range of IP addresses, click the (+) Add button for Range, and enter the starting and ending IP addresses.
-
-
-
Enter the port number of your healthcare management system.
-
Click Save.
After the Healthcare Listener is set up, you can add rules. Adding a rule enables the JSS to send remote commands to devices.
Adding a Healthcare Listener Rule
-
Log in to the JSS with a web browser.
-
In the top-right corner of the page, click Settings.
-
Click Server Infrastructure.
-
Click Infrastructure Manager Instances.
-
Click the Infrastructure Manager instance with the Healthcare Listener that you want to add a rule to.
-
Click Edit, and then click the Add (+) button.
-
Enter a display name for the rule.
-
Choose the remote command you want the JSS to send to devices when the Healthcare Listener receives an ADT message.
-
Choose which ADT message the Healthcare Listener can receive.
-
Use the Field Mapping options to map a field from the ADT message to an attribute of inventory information.
-
(Optional) To enable email notifications, click the Notifications tab, and do the following:
-
Select the Enable Email Notifications checkbox.
-
Enter an email address or multiple email addresses separated by a line break or a comma.
-
Use the Email Delay pop-up menu to choose how many minutes to wait when a command is pending before sending an email to specified email addresses.
-
-
Click Save.
When the Healthcare Listener receives an ADT message, the JSS automatically sends the specified command to devices that are mapped to the field in the ADT message.
You can view the date/time of when the remote command was sent to a specific mobile device in the device's inventory information. (For more information, see View when a Mobile Device Receives a Remote Command.)