Set up Smart ID authentication

This article includes updates for Digital Access 6.4.0.

This article describes how to set up Smart ID Mobile App or Smart ID Desktop App as authentication method in Smart ID Digital Access component.

For Smart ID Mobile App, you can set up two options for authentication: on the same device or on another device. To offer the end user both options, they must be set up as two separate methods. Using another device for authentication can be set up in two ways:

QR code: The user initiates the authentication from Smart ID Mobile App by scanning the QR code. With this method, the user does not have to enter a username on the authentication page.
Username: The user initiates the authentication by entering its username on the authentication page.

Prerequisites

Before setting up Smart ID Mobile App or Smart ID Desktop App, you need the following:

Log in to Digital Access Admin with an administrator account.
Deployed Digital Access, see Deploy Digital Access component
Only for Smart ID Mobile App: There is an SMS or email gateway available for sending notifications.
The access point must be protected by a public certificate, see Add certificates in Digital Access. When deploying a server certificate, its certificate chain up to the root shall also be added in CA certificates.
Smart ID Messaging must be installed on-premises or consumed as a service.
Smart ID Messaging must be connected to Digital Access, see Set up Personal Messaging in Hybrid Access Gateway.

Step-by-step instruction

Set up Smart ID authentication

Set external DNS

Set the external DNS name, to enable external communication to the DNS.

In Digital Access Admin, go to Manage system > Distribution Services.
Click Manage Global Distribution Service Settings.
Enter the DNS name assigned in the previous step, and the port to use in Digital Access for external communication.

Example: DNS settings

External DNS name: ag5.nexusville.com
External Port: 443

Enable Smart ID Mobile App or Smart ID Desktop App to an end user

In Digital Access Admin, go to Manage accounts and storage > User accounts.
Enter the User ID and click Search.
Click the User ID in the search results.
Go to the PortWise Authentication tab.
Scroll down and check Enable Personal for the user account.
For Smart ID Mobile App, do the following additional steps:
1. If you want to issue a new profile right away, check Create new profile.
2. Select email notification, to send an email to the user with a QR code to activate Smart ID Mobile App:
  Select Notification: By E-mail.
  Click Save.
3. The user can now activate Smart ID Mobile App.
4. To enable self-service, see Enable Smart ID Mobile App self-service in Digital Access.
Click Publish.

Add Smart ID Mobile App or Smart ID Desktop App as an authentication method

To add Smart ID Mobile App or Smart ID Desktop App as an available authentication method:

In Digital Access Admin, go to Manage System > Authentication Methods.
Click Add Authentication Method...
Select Personal Mobile or Personal Desktop (Smart ID Mobile App or Smart ID Desktop App). Click Next >.
In General Settings, enter a Display Name. The display name is shown to end users when they log in.
If you want Digital Access to validate a response using a CA certificate, check Enable Personal Certificate Authentication. Click the ?-sign for help.
1. Select the Certificate Authority that issued the certificates used in Smart ID Mobile App or Smart ID Desktop App,.
  
  For Smart ID Desktop App, the selected certificate authority does not work as a filter, so certificates from all certificate authorities will be displayed to the end user in Smart ID Desktop App.
Only for Smart ID Mobile App: if you want to enforce authentication on the same device, check Enable authentication on same device and do the following settings:
1. In Wait for (seconds), enter a number of seconds for the image to be displayed before being redirected to Smart ID Mobile App.
2. In Redirect Text, change the text if required.
To offer the end users an option to authenticate on the same device or on another device, you must add two separate authentication methods, one where authentication on same device is enabled (enforced) and one where it is not.
Click Add Authentication Method Server… Select an authentication server.
Click Next >, Next > and Next >.
In Extended Properties add relevant properties for the authentication method.

When using Enable Personal Certificate Authentication with Personal Desktop or Enable Personal Certificate Authentication together with Enable authentication on same device with Smart ID Mobile App, it is mandatory to add both User Attribute and Certificate Attribute properties.

Example

User Attribute: mail
Certificate Attribute: subjectaltname-emailaddress
Click Next > and then Finish Wizard.
Click Publish, that is marked blue, showing that updates have been done.

Related information