Install and upgrade Smart ID Desktop App (version 2.0)
This article describes how to install Smart ID Desktop App.
Prerequisites
See Smart ID Desktop App requirements and interoperability.
For end-users
This sections describes local end-user installation of Smart ID Desktop App.
Install Smart ID Desktop App from Nexus Support portal
Administrative rights are required to install the Smart ID Desktop App.
Smart ID Desktop App will always install for all users.
Parameters for the installer are not needed anymore but can be used for installation logs and customized installation settings (refer to installation settings)
Download the Smart ID Desktop App installation from Nexus Support portal.
To install Smart ID Desktop App, run the file Smart ID Desktop App.<version>.msi
Uninstall Smart ID Desktop App
Administrative rights are required to uninstall the Smart ID Desktop App for all users.
Smart ID Desktop App is uninstalled using the Add or remove programs functionality of Windows or via command line interface as described here: https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options.
Uninstalling Smart ID Desktop App cleans everything.
Upgrade Smart ID Desktop App
Smart ID Desktop App supports automatic upgrade by running the Smart ID Desktop App.<version>.msi file from version 2.0 and later versions.
Smart ID Desktop App supports automatic upgrade and migration of profiles and configuration settings from version 1.12 up to version 1.13.5 to version 2.<version> by running the file Smart ID Desktop App.<version>.migrate.cmd
Both Smart ID Desktop App.<version>.msi and Smart ID Desktop App.<version>.migrate.cmd have to be downloaded to perform the upgrade and migration.
Contact Nexus support for upgrade of older versions.
Administrative rights are required to upgrade the Smart ID Desktop App for all users.
Downgrade from Smart ID Desktop App 2.0 is not supported.
For administrators
Smart ID Desktop App can be managed (installed, upgraded and uninstalled) via standard software distribution tools like Microsoft Intune https://learn.microsoft.com/en-us/mem/intune/fundamentals/what-is-intune.
Contact Nexus support for planning the integration of Smart ID Desktop App with your installation tool.
Installation settings
With the Installation Settings, Smart ID Desktop App can be configured with a custom configuration set which overrides the default settings, according to description below.
Individual parameter specifications - Settings
Name | Information | Options | Default |
---|---|---|---|
SkipFailedP12s | If enabled, the P12 import process continues even if it fails to import individual P12s. P12s that cannot be imported are returned to Hermod in error message, but the process is otherwise finished as expected. | true, false | true |
ImportP12Target | Platform to store the keys when importing P12 files. | VSC, Software, Yubi | VSC |
LogLevel | Log details | No, Trace, Debug, Info, Warn, Error, Fatal | Trace |
MinimizeAfter | Minimize Desktop App after successful operation | true, false | false |
SignAndAuthenticateWithOwnCertificatesOnly | Allow only certificates installed by Desktop App | true, false | true |
Theme | Desktop App theme | Default, Light, Dark | Default |
ForwardProxy | In case an external (non Windows default) forward proxy should be used. | "", IP-Address/URL | "" |
Example file
{
"Settings": {
"ImportP12Target": "VSC",
"LogLevel": "Trace",
"MinimizeAfter": "True",
"SignAndAuthenticateWithOwnCertificatesOnly": "False",
"SkipFailedP12s": "False",
"Theme": "Default",
"ForwardProxy": "1:2:3:4"
}
}
Usage
The installation settings file is during installation according to syntax described below.
> "Smart ID Desktop App.2.0.0.msi" [DEFAULTSETTINGS=<%PATH%\<your-custom-settings.json>]