Skip to main content

Login Assistant Credential Provider

You can modify text and images used in the local secure kiosk account Credential Provider.

Before installing the software and setting up the account:

  1. Obtain the required language packs and generate the language skins. See Supporting Multiple Languages and Locales for details.

  2. Copy the generated gina.z files to the workstation on which the Credential Provider is to be installed.

You can also edit the ska.js file using the example ska skin to modify the web skin by adding or removing HTML elements to adjust the user experience of the kiosk-style browser; for example, disabling external links.

The example skins are installed if the "User Interface Design Samples" option is enabled during installation. Copy the \<instance>\design\examples\ska\ directory to the \<instance>\design\custom\ directory.

Make any required changes to ska.js and then run the following commands, using the American English language as an example:

make.bat ska en-us
make.bat install ska en-us

Install the Credential Provider with modified text or images:

  • Using the command line:

    ska.msi LANGUAGEFILES="<pipe-separated list of fully-qualified filenames>" IMAGEFILE="<fully qualified filename>"

    For example:

    ska.msi LANGUAGEFILES="c:\gina-es-es.z|c:\gina-ja-jp.z" IMAGEFILE="c:\image.bmp"

  • By editing the msi:

    Add entries for languages to the binary table in the form LANG_<language>-Rest of World and provide the necessary gina.z file.

    Add entries for bitmap image files for the Credential Provider button to the Binary table in the form ImgFile and provide the bitmap file.

Specifying a language file on the command line overrides entries in the binary table for that language. However, any languages specified only in the Binary table will still be present in the installation.

See also:

Add-on installation command-line options for more information about local secure kiosk account MSI properties.

Modify the noconnect page

The noconnect.html page is displayed when Login Assistant cannot connect to the Bravura Pass server. Because the page is shown before a network connection is established, it cannot load external resources such as stylesheets or images from the server. All content must be self-contained within the HTML file.

To modify the noconnect page:

  1. Make a copy of the noconnect.m4 file in the \<instance>\design\src\ directory and rename it as a backup.

  2. Modify noconnect.m4 to suit your requirements.

  3. Generate and install a new skin.

  4. Copy the new noconnect.html to the Login Assistant installation directory (by default, C:\Program Files\Bravura Security\Login Assistant\) on each workstation where Login Assistant is installed.

Add images to the noconnect page

Because the noconnect page is displayed when there is no network connection, images such as a company logo must be embedded directly in the HTML file using Base64 encoding. External image references do not work because the server is not reachable.

To embed an image:

  1. Convert the image file to a Base64-encoded string using one of the following methods:

    • On Linux, run: base64 logo.png

    • On Windows, run in PowerShell: [Convert]::ToBase64String([IO.File]::ReadAllBytes("logo.png"))

    • Use an online Base64 image encoder.

  2. Add the Base64-encoded image to the noconnect.m4 file using an HTML <img> tag with a data: URI. For example:

    <img alt="Company logo" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..." />

    Replace image/png with the appropriate MIME type for your image format (for example, image/gif or image/jpeg). Replace the Base64 string with the output from step 1.

  3. Regenerate the skin and copy the updated noconnect.html to the Login Assistant installation directory on each workstation.

Add CSS styling to the noconnect page

For the same reason that images must be embedded, any CSS styling for the noconnect page must be included inline within the HTML file using a <style> block, rather than referencing an external stylesheet. Place the CSS in the <head> section of the noconnect.m4 file.

In this section: