Skip to content

Install the authenticator on Windows

This guide explains how to install the Ironchip desktop authenticator for Windows. It has three parts: download the installer, install it and enroll the user.

  • 64-bit Windows. On versions older than Windows 10 you also need Microsoft Visual C++ Redistributable x64.
  • Administrator permissions on the computer.
  • Connectivity to the Ironchip API (https://api.ironchip.com by default).

You have two ways to download the authenticator installer.

  1. Go to the Ironchip admin console, app.ironchip.com, and sign in with your administrator account.
  2. Go to the Plugins section, find the Windows Authenticator card under Authenticators and click Download.
  1. Go to the official Ironchip repository, github.com/Ironchip-Security, where all the downloads are, and open Ironchip-Windows-Authenticator.
  2. Go to github.com/Ironchip-Security/Ironchip-Windows-Authenticator/releases, which lists all the available versions, and download IronchipWindowsAuthenticator.msi from the latest one.

Once you have the installer on the computer, run it as administrator and follow these steps:

  1. Check that it is the version you want and click Next.

    Installer welcome screen showing the authenticator version

  2. Accept the terms of use.

    Installer screen to accept the terms of use

  3. Select the features you want to install. Here you only need Ironchip Authenticator and, if you need it, USB support, which lets you store your identity on a USB drive and is not installed by default.

    Installer screen to select the features to install

  4. In Ironchip Host, leave the API URL as it is (https://api.ironchip.com) unless your company is in another environment. Then select one of the three proxy options depending on whether you have an automatic proxy (Automatic), a manual proxy (Manual, with its host and port) or no proxy (None).

    Installer proxy configuration screen

  5. Click Install. Administrator permissions are required. When it finishes, you can check Launch Ironchip Authenticator to open the application.

    Final installer screen with the Install button

To install the authenticator unattended, for example in a mass deployment, use msiexec.exe from a console with administrator permissions:

Ventana de terminal
msiexec.exe /i "C:\Path\To\File\IronchipWindowsAuthenticator.msi" IRONCHIP_HOST="https://api.ironchip.com" ADDLOCAL="AuthenticatorFeature,USBFeature" /q

All properties are optional:

Property Default value Description
IRONCHIP_HOST https://api.ironchip.com Ironchip API URL. Change it only if your company is in another environment.
ADDLOCAL Authenticator without USB Features to install: AuthenticatorFeature (the authenticator) and USBFeature (USB support). Separate them with commas.
IRONCHIP_PROXY_SELECTED none Proxy mode: none, automatic or manual.
IRONCHIP_PROXY_MANUAL_HOST Empty Proxy host. Only needed with IRONCHIP_PROXY_SELECTED="manual".
IRONCHIP_PROXY_MANUAL_PORT Empty Proxy port. Only needed with IRONCHIP_PROXY_SELECTED="manual".

For example, to install the authenticator without USB support and with a manual proxy:

Ventana de terminal
msiexec.exe /i "C:\Path\To\File\IronchipWindowsAuthenticator.msi" IRONCHIP_HOST="https://api.ironchip.com" ADDLOCAL="AuthenticatorFeature" IRONCHIP_PROXY_SELECTED="manual" IRONCHIP_PROXY_MANUAL_HOST="proxy.example.com" IRONCHIP_PROXY_MANUAL_PORT="8080" /q

To learn how to enroll users, see Enrollment.