Install Login Agent

Editions of Login Agent

This guide provides information on using Login Agent with Blue Prism 6.5 and above. For previous versions, download the appropriate guide from the Blue Prism Portal.

Location of installer

Contained within the Installers directory of the install location of Blue Prism.

Supported Blue Prism versions

The version of Blue Prism that the installer was provided with.

Supported Operating Systems

Same as the version of Blue Prism that the installer was provided with.

Prerequisites

An appropriate version of Blue Prism must be installed and configured prior to installing Login Agent.

When installing onto a virtual device, the host virtualization technology must support third-party credential providers

User access

Administrator access is required on the target system

Distributable files

There are two installers available for each version of Login Agent:

  • LoginAgent_x86.msi
  • LoginAgent_x64.msi

Prerequisites

  • Login Agent should only be installed on a device where Blue Prism has been installed and at least one Blue Prism connection has been configured.
  • When installing on virtualized devices, it is necessary for the virtualization host technology to support third-party credential providers.
  • Login Agent must be used with the version of the VBO that is provided within the associated Blue Prism release file.

Install Blue Prism Login Agent

  1. Navigate to the Installers directory of your Blue Prism installation and run the Login Agent MSI file appropriate to the machine.

  2. Enter a Connection Name. The name must be an exact match for an existing Blue Prism connection on the local device.

    Click Configure from the Blue Prism sign in screen to view the currently configured connections.

  3. Select a custom installation location or use the default location.

  4. Select whether the SAS service is installed with the Login Agent.

    The SAS service provides a mechanism to programatically send Ctrl + Alt + Del commands. If the SAS service is selected, further options are available:

    • Enable SAS proxy – Allows the Blue Prism SAS service to be instructed to send the Ctrl + Alt + Del command to the resource.
    • Set local SAS proxy – Attempts to override local policy on the local resource on-the-fly to allow SAS instructions to be received programatically. Select this option if SAS is required at log in and if the policy cannot be overridden centrally. This is not a recommended approach as it provides unsupported functionality that could be broken by Windows upgrades or updates.
    • Set local legal message policy – Attempts to override local policy on the local resource on-the-fly to prevent the legal message displaying at log in. Select this option if a legal message displays at log in and the policy cannot be overridden centrally. This is not a recommended approach as it provides unsupported functionality that could be broken by Windows upgrades or updates.

    For further information about configuring these options, see Security Policies.

  5. Once the installation has completed, reboot the device.

Login Agent does not require a callback connection and therefore if the selected connection is a Blue Prism Server connection (recommended), a call back connection will not be established.

Command line installation

To install Login Agent without the SAS service, use the command:

msiexec /i LoginAgent_x64.msi /q

Custom install options

To install Login Agent with the SAS service, use the ADDLOCAL parameter:

msiexec /i LoginAgent_x64.msi /q ADDLOCAL=LoginAgent,SasService

To set the SAS service configuration settings:

msiexec /i LoginAgent_x64.msi /quiet EnableSASProxy=true AttemptOverrideSASGPO=false AttemptOverrideLegalMsgGPO=true

Apply the required true/false values as required – the setting names and values are not case sensitive.