Set up email or sms notification channel in Digital Access

Set up email or sms notification channel in Digital Access

This article is valid for Smart ID 20.06 and later.

This article describes how to set up a notification channel for alerts and messages that shall be sent by Smart ID Digital Access component to the user. You can specify an sms channel, an email channel, or both.

  • Before setting up sms notification channel, make sure that the correct sms plug-in is available. Read more below in "Available sms plug-ins".

Optional:

If you shall configure a TLS-enabled notification server:

  • The certificate of the Certificate Authority must be obtained. This can be done in several different ways and is not covered by these instructions. The certificate should be in PEM format.

Step by step instruction

  1. Log in to Digital Access Admin with an administrator account.



  1. In Digital Access Admin, go to Manage System.

  2. Click Notification Settings > E-mail channel.

  3. Check Enable e-mail channel.

  4. In the Host input field enter the IP address or DNS name of the server that sends PIN, password and seed to the receiver. Default is localhost.

  5. In the Port input field enter the port for the server. Default is 25.

  6. In the Sender's e-mail Address input field enter the email address that sends the notifications, for example, admin@nexustest.com.

  7. Enter UserName and Password for the account with SMTP Server.

  8. Enter Local Host name used for the EHLO and HELO messages.

  9. Check the Start TLS option to upgrade the current insecure connection to the SMTP Server to a secure connection This option works only when the SMTP Server support STARTTLS command.

  10. Click Save.



  1. In Digital Access Admin, go to Manage System.

  2. Click Notification Settings > SMS channel.
    Here you will see the registered SMS channels in order, that is, they will be tried out from top to bottom. If the first fails the second will be tried and so on.

  3. Click Add SMS Channel...

  4. Enter Display Name for the SMS channel.

  5. Select a Plug-in from the drop-down list and click Next.



  6. Enter the configuration parameters for the selected sms channel. For more information, click the ?-sign. To edit a channel, click the corresponding link. To change the order of the channels, click the order links.

  7. Click Finish.



When sending out provisioning URLs for Smart ID Mobile App or OATH, the character size of the URL can exceed the sms limit. In such cases, the Digital Access component can create a short URL that redirects to the actual URL automatically. To enable this feature do the following steps:

  1. In Digital Access Admin, go to Manage System.

  2. Click Notification Settings > SMS Channel...

  3. Check Use Short URLs.

  4. Click Save.

In order to use this feature, the distribution-service web-resource must be available through DNS mapping. The DNS name in the short URL is taken from External DNS name of Distribution Service Global Settings.





Read more below in "Available sms plug-ins".

  1. In Digital Access Admin, go to Manage System.

  2. Click Notification Settings > SMS Plug-ins.

  3. Select the file with the plug-in and click Upload Plug-in.

  4. Click Save.



For proper TLS functionality the remote certificate (presented by the Notification server) must be trusted by the Digital Access component. You must add a Certificate Authority (CA).

  1. Go to Add certificates and follow the instructions under heading "Add certificate authority".

  2. When finished, click Publish.

For more information, see Configure TLS-enabled notification server in Digital Access.



Plug-ins are used for communicating with different SMS vendors. The most common plug-ins are listed below, but you can also add other sms plug-ins, see above under "Add sms plug-in".

SMTP Plugin

Plugin for SMS distribution via the SMTP (mail) protocol.

HTTP Plugin

Plugin for SMS distribution via the HTTP/S protocol.

CIMD Plugin

Plugin for SMS distribution via CIMD version 2.0 protocol.

Netsize Plugin

Plugin for SMS distribution via Netsize Online API.

SMPP Plugin

Plugin for SMS distribution according to the SMPP protocol version 3.4.





Related information

Copyright 2024 Technology Nexus Secured Business Solutions AB. All rights reserved.
Contact Nexus | https://www.nexusgroup.com | Disclaimer | Terms & Conditions