Update the Installer ID on a User's Computer

Prev Next

Introduction

Installer IDs are unique identifiers assigned to each group and the Sanas Account. When updated on a user's machine, the Installer ID helps Sanas pre-configure the app based on the user’s group configuration and enables auto-provisioning when using app authentication modes such as Auto-activation and Single-Sign On. Installer IDs are relevant only for Sanas App users.

Learn more about the available authentication modes for the Sanas App users.

How it works

The Installer ID serves two purposes during App activation:

  • Group identification — Sanas uses the Installer ID to identify the group the user belongs to, then pre-configures the App based on that group's settings (language, accent, authentication mode, etc.).

  • Auto-provisioning — When a user activates the App for the first time, Sanas checks whether the user exists in the group associated with the Installer ID. If the user exists, they are granted access. If not, Sanas automatically creates the user in that group and grants access.

    Ensure the Auto Provisioning toggle is enabled on the intended groups. Navigate to Settings > Configuration > Application Authentication > Ensure SSO or Auto-activation is configured > Ensure the Automatic User Creation toggle is enabled.

Locate the Installer ID

Each group has a unique Installer ID. To find it:

  1. Log in to the Sanas Portal with your credentials.

  2. Navigate to the Get Sanas page.

  3. Select the group for which you need the Installer ID.

  4. Copy the Installer ID and save it securely.
    Download the Sanas app for Windows and configure your Installer ID for users.

Tip: Use your Sanas Account's Installer ID to provision all App users directly to the Default Group of your Account. Once added, you can move users to their respective groups as needed. See Move App Users for instructions.

Before you begin

  • Ensure you have access to the user's machine to update the Installer ID, either directly or through your endpoint management software.

  • Ensure you have copied the correct Installer ID for the target group from the Get Sanas page on the Portal.

Update the Installer ID

The Installer ID can be updated at two stages:

Choose the applicable stage, platform, and method below.


During the Sanas App installation

Note: The below command can also run through endpoint management software to update installer IDs on centrally managed user machines.

Method 1: App installer

Enter the installer ID in its respective field when prompted during installation.

Method 2: Command

Note: Replace the placeholders <file_path> and <installer_ID> with the actual values.

For example, here is a sample command for msi file type:
msiexec /i "C:\Users\Acme_inc\Downloads\Sanas-5.2.11-x64.msi" installerid="XXXX-XXXX-XXXX" /q

  • .msi installer
    (Valid to execute via CMD or PowerShell)

    msiexec /i "<file_path>" installerid="<installer_ID>" /q

  • .exe installer
    (CMD)

    "<file_path>" /installerid="<installer_ID>" /q


    (PowerShell)

    & "<file_path>" /installerid="<installer_ID>" /q

Method 1: App installer

Enter the installer ID in its respective field when prompted during installation.

Method 2: Terminal

Note: Replace the placeholders <file_path> and <installer_ID> with the actual values.

Run the following commands in the same order:

sudo defaults write /Library/Preferences/ai.sanas.SanasApp.plist InstallerId "<installer_ID>"
sudo installer -pkg <file_path> -target /


Post Sanas App installation

Note: The below command can also run through endpoint management software to update installer IDs on centrally managed user machines.

Note: Replace the placeholders <installer_ID> with the actual value.

(Valid to execute via CMD or PowerShell)

reg add "HKLM\SOFTWARE\Sanas.ai\Sanas" /v InstallerId /t REG_SZ /d "<installer_ID>"

Note: Replace the placeholders <file_path> and <installer_ID> with the actual values.

Run the following commands in the same order:

sudo defaults write /Library/Preferences/ai.sanas.SanasApp.plist InstallerId "<installer_ID>"


Support

Need help? Get in touch with our Support Team for assistance.