HealthCast

Kiosk Mode Appearance

The Kiosk Mode can be configured to mirror the organization's brand through icon and logo displays and through various display settings and themes.

The following sections highlight customization options available for the Kiosk Mode.

Authentication

Privacy Shield

Authentication

Themes and displays can be set for the various authentication options available for the Kiosk Mode.

Proximity Card

Username and Password

Proximity Card

The user interface of the Proximity Card may be customized by changing the background images, the font face, color and size for various prompts, as well as the layout of the dialog utilizing a mask image.

PIN Prompt Dialog

There are several registry keys associated with the display of the privacy shield and its contests. The values below describe those intended to be changed for the Login display PIN dialog.

The font color, size, and face can be customized for the login directions, login fields, the change PIN text, and the error text.

HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\display
  • Login Directions - e.g. tap your card, enter your username, enter your PIN, etc.

    Registry Key

    Value Description

    LoginDirectionsFontColor

    reg_dword - the NBGR (none,blue,green,red values from left to right) color the text for the login directions will be displayed in.

    LoginDirectionsFontSize

    reg_dword - the size of the font in points for the login directions.

    LoginDirectionsFontFace

    reg_sz - the font face name of the login directions display.

  • Login Fields - e.g. username, password, PIN, etc.

    Registry Key

    Value Description

    LoginFieldPromptFontColor

    reg_dword - the NBGR (none,blue,green,red values from left to right) color the text for the field prompts will be displayed in.

    LoginFieldPromptFontSize

    reg_dword - the size of the font in points for the field prompts.

    LoginFieldPromptFontFace

    the font face name of the field prompts.

  • Change PIN - e.g. instructional text for changing PIN if the user desires to choose a new PIN.

    Registry Key

    Value Description

    ChangePINFontColor

    reg_dword - the NBGR (none,blue,green,red values from left to right) color the text for the "change pin" text will be displayed in.

    ChangePINFontSize

    reg_dword - the size of the font in points for the "change pin" text.

    ChangePINFontFace

    reg_sz - the font face name of the "change pin" text.

  • Error text - e.g. In the case of a PIN error, text describing the problem.

    Registry Key

    Value Description

    ErrorFontColor

    reg_dword - the NBGR (none,blue,green,red values from left to right) color the text for error.

    ErrorFontSize

    reg_dword - the size of the font in points for the error text.

    ErrorFontFace

    reg_sz - the font face name of the error text.

Setting a Style/Theme

Display styles will apply color to the input boxes and the login buttons. Other colors must be configured with the settings listed on this page.

To set a particular style or theme for display:

HKLM\Software\HealthCast\ExactAccess\Display

LoginFormStyle: reg_sz = "<a valid style file name or full path and file name, including .VSF extension>"

Tip

For a full list of available styles, look in the following installation folder:

C:\Program Files (x86)\Common Files\HealthCast\themes
PinPrompt.PNG

Here are some of display examples that can be configured.

Amakrits.vsf

image__17_.png

Windows10Blue.vsf

image__15_.png

Windows10Dark.vsf

image__16_.png
Changing the PIN Background Image

When customizing the Kiosk Mode PIN background image, there are two image files to note:

  1. PinBackground_FORE.png

    The fore image will take the place of the entire background image, including the border. The default image size is 500 x 311 pixels.

  2. PinBackground_MASK.bmp

    This image is used to position the user interface elements to accommodate the layout of the *_FORE image graphic.

Tip

Both images must be the same size for proper operation of the PIN dialog.

The simplest method of designing a new image

  1. Copy the PinBackground_MASK.bmp to a file named PinBackground_FORE.bmp

  2. Convert it to a PNG image.

  3. Open the PinBackground_FORE.png and make desired changes, taking into account the positioning of the elements.

  4. The design can now be placed over any open, white space around the element location sections as found in PinBackground_MASK.bmp.

The default login dialog background is a PNG image:

PinBackground_FORE.png

Note

When editing and saving the _MASK file, be sure that pure colors are used and no anti-aliasing is performed on the image. Tools other than Microsoft Paint automatically blend borders into the background color, effectively shrinking the desired display area.

User Interface Elements Corresponding RGB Values

These sections correspond to the following user interface elements:

Note

The numbers in ( ) correspond to Red, Green, Blue (RGB) values in that order.

  • Magenta (255,0,255) - Holds the title of the PIN prompt (either indicating enrollment or verification)

  • Yellow (255,255,0) - Help text describing what the user should do (such as tap a proximity card)

  • Black (0,0,0) - Holds the entry fields for both enrollment and verification.

    It is important that the dimensions of this box remain relatively unchanged so as to not inadvertently clip the user interface elements to be displayed in this area.

  • Gray (128,128,128) - The position and size of the "Change PIN" button (both for UP [ChangeButtonUp.png] and DOWN [ChangeButtonDown.png])

  • Plum (128,0,128) - The title/text for changing PIN.

  • Aqua (0,255,255) - The position and size of the warning icon (WarningImage.png) in the case of an error.

  • Green (0,255,0) - The text describing the error condition.

  • Blue (0,0,255) - the Login button position.

  • Red (255,0,0) - the Cancel/Reset button position.

The mask determines where the login elements will be displayed over the top of the login background.

PinBackground_MASK.bmp

Warning

The mask colors should not overlap one another, as the coordinates of the top-left and bottom-right are used to calculate the location and size of the elements they represent.

Username and Password

The user interface of the manual login process can be customized by changing the background images, the font face, color and size for various prompts, as well as the layout of the dialog utilizing a mask image.

See Setting a Style/Theme for directions on how to change the username and password prompt layout and to view various display examples.

Changing the Password Reset Text

The Password Reset text can be modified to fit the organization's needs by changing the following:

HKLM\Software\HealthCast\PasswordReset 

ResetLinkText: reg_sz = "new reset text"

If the key does not exist, or is not set, and a password reset URL is present, the default text "Forgot your password? Click here to reset it." will be used.

Setting a Style/Theme

Display styles will apply color to the input boxes and the login buttons. Other colors must be configured with the settings listed on this page.

To set a particular style or theme for display:

HKLM\Software\HealthCast\ExactAccess\Display

LoginFormStyle: reg_sz = "<a valid style file name or full path and file name, including .VSF extension>"

Tip

For a full list of available styles, look in the following installation folder:

C:\Program Files (x86)\Common Files\HealthCast\themes
LoginPin.PNG

Here are a variety of display examples that can be configured.

Amakrits.vsf

image__18_.png

Windows10Blue.vsf

image__10_.png

Windows10Dark.vsf

image__9_.png
Display Settings

The text, background image, RGB values, and the login dialog can be customized. See the corresponding sections below.

Login Dialog

When editing and saving the _MASK file, be sure that pure colors are used and no anti-aliasing is performed on this image. Tools other than Microsoft Paint automatically blend borders into the background color, effectively shrinking the desired display area.

HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\display

Login Directions - e.g. tap your card, enter your username, enter your PIN, etc.

Registry Key

Value Description

LoginDirectionsFontColor

reg_dword - the NBGR color (none, blue, green, red values from left to right) of the login directions display

LoginDirectionsFontSize

reg_dword - the point font size of the login directions display

LoginDirectionsFontFace

reg_sz - the font face name of the login directions display

Login Fields - e.g. username, password, PIN, etc.

Registry Key

Value Description

LoginFieldPromptFontColor

reg_dword - the NBGR color (none, blue, green, red values from left to right) of the login directions display

LoginFieldPromptFontSize

reg_dword - the point font size of the login directions display

LoginFieldPromptFontFace

reg_sz -the font face name of the field prompts

LoginFormStyle

reg_sz: the file name of the style to apply to the login display

Enabling biometrics as an alternate authentication method

To enable biometrics as an alternate authentication method, the following registry key can be set.

HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\Override\AlternateLoginEnabled: reg_dword = 1 to enable alternate login button, 0 to disable alternate login button.
Changing the Kiosk Mode PIN Background Images

When customizing the Kiosk Mode PIN background images, there are two image files in C:\program files\HealthCast\ExactAccess.

  1. PinBackground_FORE.png

    The fore image will take the place of the entire background image, including the border. The default image size is 500 x 311 pixels.

  2. PinBackground_MASK.bmp

    This image is used to position the user interface elements to accommodate the layout of the *_FORE image graphic.

The simplest approach to designing a new image is to copy the LoginBackground_MASK.bmp to a file named LoginBackground_FORE.png

Open the LoginBackground_FORE.png and make desired changes, taking into account the positioning of the elements. The design can be placed over any open, white space around the element location sections as found in the LoginBackgroun_MASK.bmp.

The default login dialog background is a PNG image.

LoginBackground_FORE.png

Note

When editing and saving the _MASK file, be sure that pure colors are used and no anti-aliasing is performed on this image. Tools other than Microsoft Paint automatically blend borders into the background color, effectively shrinking the desired display area.

User Interface Elements Corresponding RGB Values

These sections correspond to the following user interface elements:

Note

The numbers in ( ) correspond to Red, Green, Blue (RGB) values in that order.

Black (0,0,0) - this is the login portion of the dialog prompt, and will include the domain user name, domain password, and potentially, the domain drop down list. It is important that the dimensions of this box remain relatively unchanged so as to not inadvertently clip the user interface elements to be displayed in this area.

  • Blue (0,0,255) - the Login button position

  • Red (255,0,0) - the Cancel/Reset button position

  • Aqua (0,255,255) - the ProxCard indicator image position and size (both the prox [ProxImage.png] and keyboard [NoProxImage.png] images should be the same size, and match this dimension)

  • Yellow (255,255,0) - Help text describing what the user should do (such as tap a proximity card)

The mask determines where the login elements will be displayed over the top of the login background.

LoginBackground_MASK.bmp

Once the design is created around the user interface elements, remove those element markers by filling the rectangles with the chosen background color (it does not have to be white) to match the presentation.

To deploy this updated background, include it in a transform. If HCIDeploy is configured, the updated background can be added to the a deployment package instead.

Other deployment methods (such as Microsoft SMS) may also be used. Simply deploy the updated bitmap or PNG to the correct location for the operating system (C:\Program Files\HealthCast\ExactAccess\)

Warning

The mask colors should not overlap one another, as the coordinates of the top-left and bottom-right are used to calculate the location and size of the elements they represent.

Privacy Shield

The privacy shield display contains various elements that indicate the system is in use. It can also display how long until the system will automatically log off the inactive session once the system has been locked. When the system is locked, the privacy shield also displays the login prompt, allowing for a user to return, or another user to log in over the current session, causing the current session to be logged off.

Display Settings
  1. Log-in as a Local Administrator to the workstation that will be changed.

    Note

    The Client Configuration Tool will only run under an account with Local Administrator privileges.

  2. Navigate to the Windows® Start menu> All Programs > HealthCast > ExactAccess > Utilities > Configuration > Client Configuration.

    and choose Kiosk Mode.

    7703496.png
  3. In the Other section select the options to configure for font color, font name, and font size.

  4. Click OK to save the changes.

Privacy Shield Display Registry Keys

There are several registry keys associated with the display of the privacy shield and its contests. The values below describe those intended to be changed for the Auto-Logoff display. To position the overall display, change the values of: PSAutoLogoffPosX, PSAutoLogoffPosY

HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\display

Registry Key

Value Description

PSAutoLogoffVisible

reg_dword - flag indicating if the Autologoff display will be visible. (1 to enable, 0 to disable the display of auto-logoff)

LogoffDisplayTimeVisible

reg_dword - flag indicating if the time field will be displayed. (1 to enable, 0 to disable display of logoff time)

LogoffDisplayTimeImagesVisible

reg_dword - flag indicating if the progress indicator images will be displayed. (1 to enable, 0 to disable display of the images)

PSLoginNameVisible

reg_dword - flag indicating if the current session user name should be displayed for auto-logoff. (1 to enable, 0 to disable display of session name)

PSAutoLogoffPreFix

reg_sz - the text that will appear to the left of the time display

PSAutoLogoffPostFix

reg_sz - the text that will appear to the right of the time display

PSAutoLogoffPosX

reg_dword - the horizontal Pixel position of the upper left of the complete auto-logoff display as sized by the images ALDisplay_*

PSAutoLogoffPosY

reg_dword - the vertical Pixel position of the upper left of the complete auto-logoff display as sized by the images ALDisplay_*

PSLogoffTimeFontColor

reg_dword - the NBGR (none,blue,green,red values from left to right) color the text for the time will be displayed in.

PSLogoffTimeFontSize

reg_dword - the size of the font in pixels for the time display.

PSLogoffTimeFontFontFace

reg_sz - the font face name of the time display.

PSLoginNameFontColor

reg_dword - the NBGR (none,blue,green,red values from left to right) color the text for the login name will be displayed in.

PSLoginNameFontSize

reg_dword - the size of the font in pixels for the login name.

PSLoginNameFontFontFace

reg_sz - the font face name of the login name display.

Changing the Username Display Format
  1. Log-in as a Local Administrator to the workstation that will be changed.

    Note

    The Client Configuration Tool will only run under an account with Local Administrator privileges.

  2. Navigate to the Windows® Start menu> All Programs > HealthCast > ExactAccess > Utilities > Configuration > Client Configuration.

  3. Click the General tab to show the customization options available. The option also appears on the Kiosk Mode tab.

  4. Using the drop-down arrows of Display Name Format (at the bottom of the dialog), select the options that are appropriate for your environment, and click OK to finish.

    The new settings should now show when your XA screen saver, privacy shield, or Active User List is displayed. A reboot may be necessary in some environments. If prompted, please reboot your workstation.

Choose the appropriate Username display format by using the following server-side instructions for LDAP Privacy Shield Settings:

It is recommended that the Use Given Name (First name) and SN (Last name) fields option be chosen. This setting affects the privacy shield display name settings.

Tip

If you are connecting this client version to a server older than 4.8.3, the LDAP provider must be configured for the XA server instead of the WinNT provider in order to use the First Name, Last Name fields, instead of Display Name.

Note

If you are using Kiosk Mode Passthrough Authentication only, the following Username Settings are available:

3. Directory Service Name

7. In use only

8. No username display.

Registry Settings for Display Name Format
HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess

KMLockDisplayMode: reg_dword = 0

0 - Full Name

1 - Last Name only

2 - First Name only

3 - Directory Service Name

4 - Initials Only

5 - First Name, Last Initial

6 - First Name Initial, Last Name

7 - System In Use

8 - No user name (can also be set on the privacy shield independently)

Setting a Style/Theme

The auto-logoff image, as well as the full background image can be customized to suit the branding of the organization. To set up a style or a theme,

When customizing the Kiosk Mode auto-logoff background image, there are two image files to note:

  1. PinBackground_FORE.png

    The fore image will take the place of the entire background image, including the border. The default image size is 500 x 311 pixels.

  2. PinBackground_MASK.bmp

    This image is used to position the user interface elements to accommodate the layout of the *_FORE image graphic.

Open the ALDisplay_FORE.png and make desired changes, taking into account the positioning of the elements. The design can be placed over any open, white space around the element location sections found in the ALDsiplay_MASK.bmp.

Tip

Both images must be the same size for proper operation of the PIN dialog.

The default login dialog background is a PNG image that matches the color of the privacy shield background.

7703494.png

Note

When editing and saving the _MASK file, be sure that pure colors are used and no anti-aliasing is performed on this image. Tools other than Microsoft Paint automatically blend borders into the background color, effectively shrinking the desired display area.

These sections correspond to the following user interface elements:

Note

The numbers in ( ) correspond to Red, Green, Blue (RGB) values in that order.

  • Black (0,0,0) - this is the display for the User Name.

  • Aqua (0,255,255) - this is the progress indicator (lockedUser[1-5].png) images will appear

  • Yellow (255,255,0) - this is the display for the Prefix + logoff time + Postfix values.

The mask determines where the login elements will be displayed over the top of the background.

7703495.bmp

Warning

The mask colors should not overlap one another, as the coordinates of the top-left and bottom-right are used to calculate the location and size of the elements they represent.

Setting a full background image

The privacy shield will now load a background image to display. This background image can contain any optional information to display when the system is secured.

To set the display image, the display needs to be generated, configured, and pinned. The following drop down sections will guide in this procedure.

This display may be a static image, or it may be created automatically by a program such as Microsoft's (SysInternals) BGInfo. Simply configure a path for the image to be saved, and follow the steps below to enable loading of this image.

  1. Open regedit.exe

  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\Display

  3. Edit the SysInfoImage registry value and set it to the full path of the image to load.

  4. Optionally, set the StartX / StartY registry keys to the X,Y coordinates of where the upper left of the image should start.

    This is only necessary if the image to be displayed is smaller than the current screen resolution, or to only display the image on a second monitor in a multi-monitor configuration.

  5. Optionally, set the UseTransparency value to 0.

    If you want the image to not be transparent - meaning, the entire image is drawn, set the value to 0. If you have generated the image with BGInfo, it is recommended to set UseTransparency to 1, so the currently configured background color is used to display behind the text.

Tip

If the file path entered in the SysInfoImage changes, or if the file date/time of the file specified in the SysInfoImage changes, the image will be reloaded. This allows administrators to script changes to the registry to display multiple images, or dynamically update the image to provide a rotating display of information if desired.

  1. Open regedit.exe

  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\Override

  3. Edit the PSUserDisplayPositionLocked: reg_dword registry value - set the value to 1 to pin the location so that it cannot be modified by dragging it with the mouse.

Network Status

The network status contains its own set of display options. The network availability display can be configured so that it cannot be closed by the end user. The positioning and status images of the display status, along with disabling it altogether, can be achieved by editing settings of the following registry keys.

Customizing the Display Status

Included in the XA client install is the application hciNetStatus.exe. This application displays the current network connectivity status of the workstation, either connected or disconnected. The display can be customized in the following ways.

  • The positioning of the display can be changed by setting the following registry keys:

    HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\
    ExactAccess\display
    • NetStartX: reg_dword = the horizontal pixel position of the upper left of the image for network connectivity.

    • NetStartY: reg_dword = the vertical pixel position of the upper left of the image for network connectivity.

  • The network status display can be changed by replacing the images listed below. The images should be 64x64 pixels or smaller.

    • The background image for connected can be modified by replacing the image netavail.png

    • The background image for disconnected can be modified by replacing the image netdown.png

  • The network status display location can be changed by dragging and dropping the network status display on the Privacy Shield. The NetStartX and NetStartY values will be updated for easy visual positioning.

Tip

To make it easier to find the correct location for placement of the network status for a particular screen resolution, simply left-click and drag the image to the appropriate location on a workstation with the correct screen resolution settings, then export the registry key values above to set them for additional workstations. The default placement at install time is designed for a screen resolution of 1920x1080.

If this appears off the screen for low resolution displays, modify the values NetStartX = 0 and NetStartY = 0. Logoff the workstation and log back in - the display should appear in the upper left corner of the screen. Proceed to drag the display to the appropriate location.

Disabling Network Status Display

To disable the display of the network status, remove the hciNetStatus.exe from the following registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\
CurrentVersion\Run

Log off the kiosk workstation and login with the generic user for this setting to take effect.

Note

If you have enabled the shell replacement, the above registry key will not exist. To enable the display on the privacy shield with shell replacement, add the value to the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\
ExactAccess\startup

04: reg_sz = "c:\program files (x86)\healthCast\ExactAccess\hcinetstatus" hcikmlock

  1. Open regedit.exe

  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\Override

  3. Edit the NetPositionLocked: reg_dword registry value - set the value to 1 to pin the location so that it cannot be modified by dragging it with the mouse.

The network availability display will remain open if the following steps are followed to remove the close button that allows the user to close it.

  1. Open regedit.exe

  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\HealthCast\ExactAccess\Override

  3. Edit the NetRemoveCloseButton: reg_dword registry value - set the value to 1 to remove the close button so the network availability display cannot be closed by the end user.