Setting Up Mobile Device Health

One of the key features of CFSWorX is the ability to send notifications to workers based upon their location. To make this feature possible, each field worker must download the MobileHMI app on their mobile device and enable the CFSWorX Worker Access feature. This will enable each mobile device to send data to the server. You must also set up the server to receive these messages. The following steps will guide you through this process.

Internet Information Services (IIS) Setup

Follow the steps in the link below to set up IIS to use SSL.

https://docs.microsoft.com/en-us/iis/manage/configuring-security/configuring-ssl-in-iis-manager

Security Provider Setup

Open Workbench.
Expand Security.
Edit Global Settings.
Go to the Web Login tab.
Make sure Enabled is checked under General Settings.
In the OIDC Provider / OAuth Authorization Server Settings section, set Signing credentials type to From the windows certificate store.
For Certificate Identifier, choose a certificate that will be used to sign the tokens provided by security.
Apply the changes.
Make sure you have at least one user created in the Users folder. We will use a user to log into the MobileHMI application.

FrameWorX Server Setup

Change Platform Services Setting

In Workbench, go to Tools > Platform Services Configuration.
On the Basic tab, set Public origin to match the address configured in IIS. For example: https://servername.website.com
Select OK.

Change FrameWorX Server Location

In Workbench, go to Tools > FrameWorX Server Location.
Go to the Mobile Clients tab.
In the Transport section, select HTTPS.
Select Save.

MobileHMI Application Setup

Universal Windows Platform (UWP) App

Launch the MobileHMI application for Windows.
Add a new server connection.
Choose HTTPS for the first dropdown.
In the text box to the left of the Connect button, enter the server name. This should match the address configured in the public origin of the Platform Services Configuration and within IIS.
Enable I have credentials for this server.
Fill in the user name and password of an ICONICS security user.
Select Connect.
After the client is connected to the server, go to Settings.
Under Worker Access, select Enable.
Log in again with your ICONICS security user.
Select Grant Access.
Observe that the Worker Access button now says "disable" instead of "enable".

The MobileHMI app should now be sending its health and location information to CFSWorX.

Android or iOS App

Launch the MobileHMI app.
Select your server to connect to, but do not connect.
Select the settings gear icon in the upper left corner.
In the Worker Access section, select User.
Select Login.
Sign in with your ICONICS username and password.
Select Grant access.
Select Back to return to settings.
Enable the toggle in the Worker Access section.
Select Back to return to the connection screen.

The MobileHMI app should now be sending its health and location information to CFSWorX.