This article is valid for Smart ID 20.11 and later.

This article describes how to set up virtual smart card management in Smart ID Identity Manager, by integrating Identity Manager to Smart ID Desktop App and Smart ID Messaging.

The following prerequisites apply:

Servers must have the following installations:
- Smart ID Messaging (Hermod version 2.3.1 or later) on premises or as a service. See Deploy Smart ID.
- Identity Manager must be installed. See Install Identity Manager.
Clients must have the following installations:
- Fully updated Windows 10
- Smart ID Desktop App version 1.0 or later. See Install and upgrade Smart ID Desktop App.
- The virtual smart card (VSC) function must be initialized.

Step-by-step instruction

Set up communication between Identity Manager and Smart ID Messaging over HTTPS. See Integrate Identity Manager with Smart ID Messaging.

Troubleshooting

Popups must be allowed for the running Identity Manager server to be able to call the Smart ID Desktop App plugout URL. Most browsers block them by default and show a very subtle hint that a popup was blocked.

If the Smart ID Desktop App plugout URL is not called, check your browser's URL bar for any indication about blocked popups and add an exception.

To troubleshoot Smart ID Desktop App, consult the logfile. Here are some common errors and suggestions how to fix them:

Virtual smart card creation failed - Insufficient resources

Error: Virtual Smart Card creation failed! --> System.Exception: The target device has insufficient resources to complete the operation. (Exception from HRESULT: 0x80070142)

Solution: Remove some virtual smart cards and try again.

Virtual smart card creation failed - Operation requires elevation

Error: Virtual Smart Card creation failed! --> System.Exception: The requested operation requires elevation. (Exception from HRESULT: 0x800702E4)

Solution: Make sure you follow the prerequisites listed above. Login as administrator and try again.

Domain mismatch

Error: Domain mismatch error message

Solution: Make sure you use HTTPS for Identity Manager and Hermod

Smart ID Desktop App crashes

Error: Smart ID Desktop App crashes

Solution: Update Windows

Nexus Documentation

Set up virtual smart card management in Identity Manager