Skip to main content
Skip table of contents

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)

  1. Download the Smart ID Desktop App installation from Nexus Support portal.

  2. 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.

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

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>]
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.