Skip to main content

Install and upgrade Login for Windows

This topic describes how to upgrade and install Login for Windows.

Information about upgrading Login for Windows

Login for Windows supports upgrading from version 1.0.4 to the latest version without uninstalling before installing the latest version.

  • Upgrading from version 1.0.3 to 23.07 is supported but the cache is cleared. After the upgrade, the first available second factor will be selected by default instead of the previous second factor the user entered.

  • Upgrading from 1.0.2 or earlier, first uninstall Login for Windows before installing 23.07. Upgrading from earlier than 1.0.2 to the latest version is not supported.

  • If end users are using the SecureAuth Credential Provider version 2.8.5 or earlier and the admin upgrades to a later version of Login for Windows, end users do not need to uninstall the SecureAuth Credential Provider before installing Login for Windows.

Download and install Login for Windows

In this section, you'll install or upgrade Login for Windows for a workstation.

Important

On a Windows server, you should install or uninstall SecureAuth Login for Windows only from a console session, and not an RDP session.

  1. From the SecureAuth Product Downloads page, download and unzip the Login for Windows .msi file to the target workstation (laptop, desktop, server, etc).

  2. In the Login for Windows folder, find the .msi file for the target workstation.

    This could be something like SecureAuthLogin-23.07.00-x64.msi.

    Note

    As of Login for Windows version 23.07 we no longer support Windows 8.1 and will not provide an x86.msi file.

  3. Place the file in the \Temp folder.

  4. Find the config.json file that you created and downloaded from the Login for Endpoints section in the Identity Platform. Copy this file to the \Temp folder on the target workstation.

  5. On the target workstation, run the following command line with administrator permissions, using the file name of your .msi file and correct path of that file on your machine. For example:

    msiexec /i "C:\Temp\SecureAuthLogin-23.07.00-x64.msi" /L*V "C:\Temp\msiexec_install.log" /qn CONFIG="C:\Temp\config.json"
  6. Log out of the target workstation.

    After this installation, SecureAuth Login for Windows appears on the next login session.

Notes

  • For workstations in a PCI environment and if Login for Windows does not install correctly on a workstation, see Login for Windows SSL configuration requirements.

  • If the "Failed to write configuration" message appears, this can occur when reinstalling Login for Windows immediately after unistalling the software. The installer did not finish performing clean up tasks, such as removing the C:\ProgramData\SecureAuth directory.

Uninstalling Login for Windows

On the target workstation, run the following command line with administrator permissions, using the file name of your .msi file and correct path of that file on the workstation:

   msiexec /x "<msi>" /L*V "uninstall.log" /qn

Or, you can manually uninstall using the Windows "Programs and Features" menu.

Log files are not uninstalled; use them for troubleshooting any issues with the uninstallation. After you have worked through any issues, you can delete the log files.