Installing the PatientSecure Client

Use the Imprivata PatientSecure Install Wizard to install pre-defined combinations of PatientSecure features, based on your implementation.

Before You Begin

Before you begin, have the following information ready:

  • PatientSecure environment. PatientSecure server components are installed and Admin Console is configured.

    • Take note of the fully qualified domain name (FQDN) and the port number of the PatientSecure Web Services (PSWS) server. You will use it during client installation.

  • Review the system requirements for the Imprivata PatientSecure client.

    • Install the required software dependencies on the client computer.

    • Ensure that the required client communication ports are open.

  • For Epic Integration clients, see Epic Integration requirements.

  • For Epic Kiosk clients, see Epic Kiosk requirements.

  • For Citrix environments where you want to use Imprivata Virtual channel communications for PatientSecure Toolbar or Epic Integration as published applications on endpoints, see Configure PatientSecure Virtual Channel.

To install the PatientSecure client:

  1. Download the client installation package provided by your Imprivata PatientSecure representative or from the PatientSecure software download package available on the Imprivata Customer Experience Center.

  2. Extract the software package and run ImprivataPatientSecureWebClient.exe.

  3. Click Next.

  4. Complete the wizard, including the following steps:

    1. If there are missing software prerequisites, such as Microsoft Visual C++ redistributables, the wizard prompts for you to install them. In this case, the PatientSecure client installation will require a reboot of the endpoint.

    1. Accept the default destination folder for the installation files, or click Change to navigate to and select a different folder. Click Next.

    2. Enter the fully qualified domain name (FQDN) for the PatientSecure Web Services (PSWS) application server.

    3. Enter the port to use. The default is 7002.

    4. To verify the connection to the PSWS, click Test Connection.

    5. Click Next.

    6. On the Setup Type page, do the following:

      • To install only the default components (PatientSecure Client, PatientSecure Client Hub and PatientSecure Client Gateway), click Typical and Next.

      • To choose from groups of features to install, click Custom and Next. The Custom Setup page presents you with pre-defined groups of features to be installed.

        Select the group of features to be installed, based on your integration.

        Integration Select the group of features
        PatientSecure and Imprivata OneSign APG integrations, or other custom integrations

        • Client, Hub, Gateway, Toolbar

          NOTE: This group of features will not display the Virtual Channel dialog, even when installed on a Citrix server.
        Epic Integration

        • Client, Hub, Gateway, Epic integration
        Epic Integration as a published application on the endpoint.

        • On the server - install Epic integration.

        • On the endpoint - install Client, Hub, Gateway.
        Epic Kiosks

        • Epic Kiosk, Hub
        Toolbar as a published application on the endpoint

        • On the server - install Toolbar.

        • On the endpoint - install Client, Hub, Gateway.
        Windows Kiosk API v.2 integration

        • Hub, Gateway

        Epic Integration or Toolbar as a Citrix published application on the endpoint with PatientSecure Virtual Channel communication.

        For more information on integrating with Imprivata Virtual Channel, see Configure PatientSecure Virtual Channel.

        • On the server - install either Epic Integration or Toolbar.

        • On the endpoint - install Client, Hub, Gateway

  5. Click Next.

  6. If you selected a group of features that includes the PatientSecure Toolbar, on the Toolbar Theme page, select the Toolbar is running as a published application checkbox to allow the Toolbar application to run as a published application. Click Next.

    1. On the Toolbar Buttons page, select the toolbar settings that will be available:

      • Show Authenticate Button on Toolbar

      • Show Enroll Button on Toolbar

      • or both

  7. For PatientSecure Virtual Channel communication support on Citrix only. For more information on this integration, see Configure PatientSecure Virtual Channel.

    If your PatientSecure endpoints will integrate with Imprivata Virtual Channel communication in Citrix, and you selected the group of features for PatientSecure Toolbar, or Epic Integration, set the following:

    1. On the Toolbar Theme page, select the Toolbar is running as a published application checkbox to allow the Toolbar application to run as a published application. Click Next.

    2. On the Toolbar Buttons page, select the toolbar settings that will be available:

      1. Show Authenticate Button on Toolbar

      2. Show Enroll Button on Toolbar

      3. or both

        Click Next.

    3. On the Virtual Channel page, the PatientSecure installer detects Citrix on the server. To use Virtual Channel communication, select the Use Virtual Channel checkbox.

      The default is not selected. If Citrix is not detected on the server, this page is not displayed.

      Click Next.

  8. To review log entries for the installation when you exit the Installer, select Show the Windows Installer log.