Installazione dell'app Windows

• Il programma di installazione Password Boss per Windows è disponibile sia in formato EXE che MSI.
• Entrambe le versioni del programma di installazione possono essere installate in modo automatico aggiungendo al programma di installazione i parametri della riga di comando elencati di seguito.
• L'installazione iniziale richiede diritti di amministratore per l'utente, a meno che non si utilizzi PreInstaller tramite un RMM o un altro strumento di distribuzione, nel qual caso l'app Password Boss può essere installata senza diritti di amministratore.
• Gli aggiornamenti successivi dell'app una volta installata non richiedono diritti di amministratore.
  • Il programma di installazione di Windows (sia in versione EXE che MSI) è composto da due parti. Il programma di installazione "stub", EXE o MSI, cambia raramente e può essere aggiunto agli strumenti di distribuzione. Quando viene eseguito, il programma di installazione "stub" scarica la versione più recente dell'applicazione dai nostri server, in modo che ogni installazione installi sempre la versione più recente dell'app.

Installazione manuale

1. Visita https://www.passwordboss.com/download . Il sito web rileverà il sistema operativo in uso e scaricherà il programma di installazione corretto per te.
2. Dopo aver scaricato il programma di installazione, esegui il file e segui le istruzioni per l'installazione.

Distribuzione RMM

L'implementazione Password Boss con il tuo RMM elimina la necessità per gli utenti finali di disporre di diritti di amministratore per l'installazione. Il processo di installazione è in due fasi : le parti di Password Boss che richiedono diritti di amministratore vengono installate tramite il PreInstaller, che viene eseguito come amministratore o sistema locale, e il programma di installazione dell'app client principale, che viene eseguito come utente finale.

• PreInstaller può essere eseguito in blocco su tutte le workstation gestite prima dell'effettiva distribuzione dell'applicazione client.
• PreInstaller non ha interfaccia utente, si installa in modo silenzioso e non verrà elencato in Installazione applicazioni.
• Il programma di preinstallazione esegue tutte le modifiche al registro che richiedono diritti di amministratore. Il programma di preinstallazione DEVE essere eseguito con autorizzazioni di amministratore o di sistema locale.
• Le impostazioni modificate da PreInstaller possono essere rimosse eseguendo PreInstaller con l'opzione /uninstall.

Passaggi di installazione

1. Scarica il preinstallatore
2. Esegui il PreInstaller una volta per ogni workstation gestita utilizzando il tuo RMM. Non sono necessari righe di comando o parametri per l'installazione.
   • Se necessario per la risoluzione dei problemi, è possibile abilitare la registrazione per PreInstaller aggiungendo il parametro /verbose. I registri vengono salvati nella cartella %TEMP% e denominati PasswordBoss-PreInstall-[Data]{Ora].log.
3. Installa l'app client seguendo le istruzioni riportate di seguito per la distribuzione in formato EXE o MSI. L'app client DEVE essere eseguita dall'utente finale, altrimenti l'applicazione non funzionerà per l'utente.

Istruzioni generiche per la distribuzione tramite script

MSI

1. Scarica il programma di installazione MSI
2. Il programma di installazione dovrebbe chiamarsi Password_Boss.msi
3. Per eseguire il programma di installazione in modo silenzioso, aggiungere il parametro EXEOPTIONS=" /q2" quando si esegue il programma di installazione:

Text

/path/to/Password_Boss.msi EXEOPTIONS="/q2" 

**replace the "/path/to" with the path to where you downloaded the file to**

Text

/path/to/Password_Boss.exe /q2

**replace the "/path/to" with the path to where you downloaded the file to**

1. Per distribuire l'app Password Boss su dispositivi remoti, richiama il programma di installazione con l'opzione silenziosa dalla tua soluzione di distribuzione software preferita.
2. Durante l'installazione, il programma di installazione scaricherà automaticamente da Internet la versione più recente di Password Boss , in modo che i tuoi utenti dispongano sempre della versione più aggiornata.

Istruzioni per lo script di PowerShell

Password Boss può essere distribuito tramite script PowerShell come alternativa alla creazione di uno script in uno strumento RMM.

Di seguito è riportato lo script PBPreClient.ps1. Nel sistema di distribuzione, è necessario eseguire questo script come amministratore prima di installare Password Boss . Questo script scaricherà PreInsaller.exe e lo distribuirà sul computer come amministratore. Copia e incolla lo script seguente in un blocco note e salva il file come PBPreClient.ps1 prima di utilizzarlo.

PBPreClient.ps1

# Copyright (c) 2024 Password
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#    * Redistributions of source code must retain the above copyright
#      notice, this list of conditions and the following disclaimer.
#    * Redistributions in binary form must reproduce the above copyright
#      notice, this list of conditions and the following disclaimer in the
#      documentation and/or other materials provided with the distribution.
#    * Neither the name of the AutoElevate nor the names of its contributors
#      may be used to endorse or promote products derived from this software
#      without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL OPENDNS BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<#
.SYNOPSIS
  Installs the Password Preinstaller and Client
  #>

# Set $DebugPrintEnabled = 1 to enabled debug log printing to see what's going on.
$DebugPrintEnabled = 1

$PreInstallerName = "PBPreInstaller.exe"
$InstallerPath = Join-Path $Env:TMP $PreInstallerName
$DownloadBase = "https://install.passwordboss.com"
$DownloadURL = $DownloadBase + "/" + $PreInstallerName

$ScriptFailed = "Script Failed!"

function Get-TimeStamp {
    return "[{0:MM/dd/yy} {0:HH:mm:ss}]" -f (Get-Date)
}


function Debug-Print ($msg) {
    if ($DebugPrintEnabled -eq 1) {
        Write-Host "$(Get-TimeStamp) [DEBUG] $msg"
    }
}

function Get-PreInstaller {
    Debug-Print("Downloading installer...")
    $WebClient = New-Object System.Net.WebClient
    
    try {
        $WebClient.DownloadFile($DownloadURL, $InstallerPath)
    } catch {
        $ErrorMessage = $_.Exception.Message
        Write-Host "$(Get-TimeStamp) $ErrorMessage"
    }
    
    if ( ! (Test-Path $InstallerPath)) {
        $DownloadError = "Failed to download the Password PreInstaller from $DownloadURL"
        Write-Host "$(Get-TimeStamp) $DownloadError"
        throw $ScriptFailed
    }
    
    Debug-Print("Installer downloaded to $InstallerPath...")
}
function Install-Agent () {
    Debug-Print("Executing installer...")
        
    Start-Process $InstallerPath -Wait
    }
		
function Verify-Installation () {
    Debug-Print("Verifying Installation...")
    
    if ( ! (Get-ItemPropertyValue -Path "HKLM:\Software\PasswordBoss" -Name "PreInstall") -eq 'True') {
        $VerifiationError = "The Preinstaller installation failed!"
        Write-Host "$(Get-TimeStamp) $VerificationError"
        
        throw $ScriptFailed
    }
}

function main () {   
    Get-PreInstaller
    Install-Agent
    Verify-Installation
    
    Write-Host "$(Get-TimeStamp) PBPreinstaller successfully installed!"
}

try
{
    main
} catch {
    $ErrorMessage = $_.Exception.Message
    Write-Host "$(Get-TimeStamp) $ErrorMessage"
    exit 1
}

Di seguito è riportato lo script PBClient.ps1. Nel sistema di distribuzione, sarà necessario eseguire questo script sul sistema come utente registrato dopo aver eseguito correttamente lo script PBPreClient.ps1. Questo script scaricherà il file Password_Boss.exe e lo eseguirà come utente. Copiare e incollare lo script seguente in un blocco note e salvare il file come PBClient.ps1 prima di utilizzarlo.

 PBClient.ps1

# Copyright (c) 2022 Password
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#    * Redistributions of source code must retain the above copyright
#      notice, this list of conditions and the following disclaimer.
#    * Redistributions in binary form must reproduce the above copyright
#      notice, this list of conditions and the following disclaimer in the
#      documentation and/or other materials provided with the distribution.
#    * Neither the name of the AutoElevate nor the names of its contributors
#      may be used to endorse or promote products derived from this software
#      without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL OPENDNS BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<#
.SYNOPSIS
  Installs the Password Preinstaller and Client
  #>

# Run powershell in a clean install
# PowerShell -ExecutionPolicy Bypass

# Set $DebugPrintEnabled = 1 to enabled debug log printing to see what's going on.
$DebugPrintEnabled = 1

$InstallerName =  "Password_Boss.exe"
$InstallerPath = Join-Path $Env:TMP $InstallerName
$DownloadBase = "https://install.passwordboss.com"
$DownloadURL = $DownloadBase + "/" + $InstallerName

function Get-TimeStamp {
    return "[{0:MM/dd/yy} {0:HH:mm:ss}]" -f (Get-Date)
}

function Debug-Print ($msg) {
    if ($DebugPrintEnabled -eq 1) {
        Write-Host "$(Get-TimeStamp) [DEBUG] $msg"
    }
}

function Get-Installer {
    Debug-Print("Downloading installer...")
    $WebClient = New-Object System.Net.WebClient
    
    try {
        $WebClient.DownloadFile($DownloadURL, $InstallerPath)
    } catch {
        $ErrorMessage = $_.Exception.Message
        Write-Host "$(Get-TimeStamp) $ErrorMessage"
    }
    
    if ( ! (Test-Path $InstallerPath)) {
        $DownloadError = "Failed to download the Password Installer from $DownloadURL"
        Write-Host "$(Get-TimeStamp) $DownloadError"
        throw $ScriptFailed
    }
    
    Debug-Print("Installer downloaded to $InstallerPath...")
}
function Install-Agent () {
    Debug-Print("Executing installer...")
    
    $Arguments = "/q2"
    
    Start-Process $InstallerPath -ArgumentList $Arguments -Wait
    }
		
function Verify-Installation () {
    Debug-Print("Verifying Installation...")
  
    if ((Get-ItemProperty -Path "HKCU:\Software\PasswordBoss") -eq $null) {
        $VerifiationError = "The Installer installation failed!"
        Write-Host "$(Get-TimeStamp) $VerificationError"
        
        throw $ScriptFailed
    }
}

function main () {   
    Get-Installer
    Install-Agent
    Verify-Installation
    
    Write-Host "$(Get-TimeStamp) Password Client successfully installed!"
}

try
{
    main
} catch {
    $ErrorMessage = $_.Exception.Message
    Write-Host "$(Get-TimeStamp) $ErrorMessage"
    exit 1
}