Windows Auth Client Project Setup, Installation, and Upgrade on VM
  • 21 Nov 2022
  • 2 Minutes to read
  • Dark
    Light

Windows Auth Client Project Setup, Installation, and Upgrade on VM

  • Dark
    Light

Article Summary

Windows Auth Client Project Setup, Installation, and Upgrade on a VM

OVERVIEW: This document includes Project setup creation and setup installation process on VM. 

Note:
RapidIdentity Client for Windows is for RapidIdentity Cloud only and is not meant for on-premise systems. Installing the RapidIdentity Client for Windows requires an API Key for the RapidIdentity Cloud tenant. An API Key is associated with a Service Identity in RapidIdentity. Instructions for creating a Service Identity are here.

AuthClient setup Installation on VM 

We have two methods to install RapidIdentity Client for Windows.

Silent Install

  1. Open command prompt as Admin user on a Windows 10 machine.
  2. Run this command:
    ActionScript
    msiexec.exe /i "RapidIdentity Client for Windows.msi"  /quiet /passive APIKEY="your secret api key" SERVER_URL="your server url" DOMAIN="."
    
    1.  Example: msiexec.exe /i "C:\AuthC_install\RapidIdentity Client for Windows.msi" /quiet /passive APIKEY="$s5TOu3vlTlabyHe9Q17AgQ==.1KRQp0gAoOdIvGdZqS02Te2HzxzIpU85/uv0TD5uVWQ=$" SERVER_URL="https://iac53adaf6cd3d440c8f5765dc08fc8f6c.dev-rapididentity.com DOMAIN="."

Installation with Wizard

  1. Log in to the Windows 10 machine as an Admin user, and navigate to the folder that has the Windows Client installer.
  2. Open Rapididentity Client for Windows setup screen. Right-click on the installer file and click on install, then click Next on the Windows Setup Wizard to begin the installation.
  3. On validation, it opens the destination folder screen. Click Next.On the Configuration screen, fill in the following fields as noted below. Click 'Next' when complete.
    1. Domain: Accounts will authenticate to this domain. NOTE: Use DOT (.) to use a local account in a Non-Domain-joined installation or the NetBIOS name of the Domain in a Domain-joined installation.
    2. Server URL: Server URL
    3. API Key: Secret API Key generated in RapidIdentity Service Identities Server.
      1. For further details on where to locate the Secret Key, see Step 6 of this article
  4. Click Install and the installation process will begin.Next, the Ready to Install window will open. Select the folder in which the file is to be installed and click Next. 
  5. Once done, it displays the completion screen with a Finish button  Click on Finish, and the Installer window closes.
  6. Open Control panel > Programs > Uninstall a Program, and you will see RapidIdentity Client for Windows is displayed in the list.

Upgrade

The user can upgrade RapidIdentity Client for Window MSI silently and with the help of Wizard.  When the user already has a previous installer on his machine and wants to upgrade, the User needs to download the Upgraded setup on his machine first.

Silent Upgrade: This process will automatically pick previous configurations.

  1. Open command prompt as an admin user on the Windows 10 machine
  2. And run this command:
    ActionScript
    msiexec.exe /i "RapidIdentity Client for Windows.msi"  /quiet /passive
    
    (example : msiexec.exe /i "C:\AuthC_install\RapidIdentity Client for Windows.msi" /quiet /passive)
  3. AuthClient should be Upgraded successfully user can check the version of setup in the control panel


Upgrade via the Wizard

  1. Login to the windows 10 machine as an Admin user and navigate to the Windows auth client installer folder.
  2. Double click on the New installer setup.
  3. The user will get a window in with filled configurations (the same configuration on which the previous installer is installed).
  4. The user needs to do next and finish the upgrade process.

Branding your AuthClient Splash Screen

To show your own logo instead of the RapidIdentity logo upon AuthClient login, navigate to \Program Files\Identity Automation\RapidIdentity Client for Windows and replace Ribbon-48.png and Ribbon-192.png with personalized logos of approximately the same size.


Please Note:

The Windows Authentication Client does not support the Remote Desktop Protocol.  






Was this article helpful?