Skip to main content
RMM

Immy.bot - integration with idemeum

Unified idemeum agent deployment with Immy.bot

— Nik Pot

Immy.bot - integration with idemeum

Overview

In this guide we will take a look at how to simply deploy idemeum agent to a set of Immy.bot managed workstations. We will leverage unified installation script and will automatically pass the customer name with variable $TenantName. We will also use the custom detection script as well as dynamic versions script to identify the latest version of idemeum agent.

Obtain unified install script

  • Navigate to the admin portal of your Main MSP dashboard
  • Click on the Install new agent button
  • Choose the operating system and copy the unified install script command
  • Save this command somewhere as we will need to use it in Immy.bot

Create software package in Immy.bot

  • Access your Immy.bot management dashboard
  • Navigate to Library → Software and click New
  • For Installer Type choose None and click Next
  • Choose Add version to new software
  • Provide the name of the software
  • Upload the icon → here is the icon.
  • For licensing choose None
  • For Version detection choose Custom Detection Script and add the following script below
    • For script type use Software detection
    • Language is Powershell
    • Execution context System
# Step 1: retrive the registry key to identify that idemeum is installed
$key = [Microsoft.Win32.RegistryKey]::OpenBaseKey([Microsoft.Win32.RegistryHive]::LocalMachine, [Microsoft.Win32.RegistryView]::Registry64)
$installed =  $key.OpenSubKey("SOFTWARE\Idemeum Inc\Idemeum Desktop Client")

#Step 2: if the agent is installed, retrive the version that is installed
if($installed) {
    $key = [Microsoft.Win32.RegistryKey]::OpenBaseKey([Microsoft.Win32.RegistryHive]::LocalMachine, [Microsoft.Win32.RegistryView]::Registry64)
    $subKey =  $key.OpenSubKey("SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{71216D26-573B-402B-A3F5-A7CB9F950CFF}")
    $installedVersion = $subKey.GetValue("DisplayVersion")
    Write-Host "Idemeum desktop agent is installed"
	return $installedVersion
    exit 0
} else {
    Write-Host "Idemeum desktop agent is not installed"
	exit -1
}
  • For installation we will use the command that you obtained in the previous section. Click New in the installation section to create new installation script.
  • For script type choose Software version action, language is Powershell and execution context is System
  • Paste the command that you obtained from idemeum in the script editor window
  • Scroll to -customerName variable and enter $TenantName inside "". This way we will automatically pass the organization name to idemeum script.
  • Save the installation script and return to the previous menu
  • For Uninstallation section create new script and enter the script as below
    • Type is Software version action, execution context is System and language is PowerShell
Start-Process -FilePath "msiexec.exe" -ArgumentList "/x {93B9CC98-6004-411E-A8BF-88F7C3BC5541} /qn /norestart" -Wait
Start-Process -FilePath "msiexec.exe" -ArgumentList "/x {71216D26-573B-402B-A3F5-A7CB9F950CFF} /qn /norestart" -Wait
  • For Upgrade strategy choose Install over as our installation script will handle all necessary actions. What is more idemeum offers the feature to automatically update agents when the new version is released. This feature is automatically enabled for your MSP tenant.
  • Expand the Advanced settings and enable Use dynamic versions
  • Add the new script for version detection
    • Type is Dynamic versions
    • Language is PowerShell
  • Paste the following script for version detection
# Step 1: Identify latest Windows version from API response
$apiUrl = "https://dvmi.idemeum.com/api/system/info"
$response = Invoke-RestMethod -Uri $apiUrl -Method Get -ErrorAction Stop 
$desktopAppVersion = ($response.clientApplicationVersions | Where-Object { $_.applicationName -eq "DESKTOP_LOGIN_APP_WINDOWS" }).version

# Step 2: Construct the link for latest MSI installer download
$fileUrl = "https://asset.idemeum.com/desktoplogin/Idemeum_Desktop_Client_Main_v${desktopAppVersion}.msi"

# Step 3: Get dynamic version from installer
Get-DynamicVersionFromInstallerURL $fileUrl
  • Save the dynamic version detection script
  • Now click Next and finish creating of idemeum software

Deploy software

Now you can create a deployment in Immy.bot and idemeum agent will be installed and the software versions will be tracked and updated.