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 migration of existing settings and installed profiles and tokens from version 1.12.
Contact Nexus support for upgrade of older versions.

Administrative rights are required to upgrade the Smart ID Desktop App for all users.

Smart ID Desktop App will upgrade itself every time you run a new version of the installation .msi file, and restore the metadata and settings. No additional upgrade steps are required.

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

CODE

{
  "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.

CODE

> "Smart ID Desktop App.2.0.0.msi" [DEFAULTSETTINGS=<%PATH%\<your-custom-settings.json>]