The SERVERS > Global Configuration > DIGIPASS Activation tab contains solution-wide configuration settings related to authenticator activation and registration, for example, templates for messages sent via the Message Delivery Component for Mobile Authenticator Studio activation. The changes of the settings in this tab apply to all OneSpan Authentication Server instances in a replicated environment.
| Field name | Description |
|---|---|
| Device Registration Security | |
Notify users when a new mobile device is registered | If this option is enabled, users will receive a notification whenever a new authenticator instance is registered to their account. This helps to detect and prevent unauthorized attempts to register authenticator instances on behalf of other users. The notification messages are scheduled to be sent via Message Delivery Component (MDC) and use message templates specified in the the MDC Settings > Device Registration Security section. Default value: No Client devices require a mobile app that was customized with Mobile Authenticator Studio 5.8.1 or later and configured to use device registration security. |
Delivery method | Specifies the default delivery method when sending notifications for device registration security. Possible values:
|
Notification trigger | Defines the events that should trigger a device registration security notification. Possible values:
|
| MDC Settings > DIGIPASS Activation Delayed | |
| The options in this section specify templates for messages sent via MDC for delayed activation. | |
| SMS | |
| Message Template | Message template to use in SMS messages for delayed activation. Default value: "The activation process (max [delayed_activation_period] h) for your DIGIPASS has been started. Serial number: [serialnumber]." |
| Voice | |
| Message Template | Message template to read by the voice delivery service for delayed activation. Default value: "The activation process (max [delayed_activation_period] h) for your DIGIPASS has been started. Serial number: [serialnumber]." |
| Header Name | Optional. The name of a custom message header field to set in the message header. Default value: <empty> |
| Header Value | Optional. The value of the custom message header field specified by Header Name. Default value: <empty> |
| Subject | The text which should appear in the Subject field when a message is sent for delayed activation. Default value: "Your DIGIPASS Activation Status" |
| Message Template | Message template to use in mail messages for delayed activation. Default value: "The activation process for your DIGIPASS with serial number [serialnumber] has been started. You will receive additional notification within [delayed_activation_period] hours." |
| MDC Settings > DIGIPASS Activation Completed | |
| The options in this section specify templates for messages sent via MDC for completed authenticator activation. | |
| SMS | |
| Message Template | Message template to use in SMS messages for completed authenticator activation. Default value: "The activation process for your DIGIPASS has been completed. Serial number: [serialnumber]." |
| Voice | |
| Message Template | Message template to read by the voice delivery service for completed authenticator activation. Default value: "The activation process for your DIGIPASS has been completed. Serial number: [serialnumber]." |
| Header Name | Optional. The name of a custom message header field to set in the message header. Default value: <empty> |
| Header Value | Optional. The value of the custom message header field specified by Header Name. Default value: <empty> |
| Subject | The text which should appear in the Subject field when a message is sent for completed authenticator activation. Default value: "Your DIGIPASS Activation Status" |
| Message Template | Message template to use in mail messages for completed authenticator activation. Default value: "The activation process for your DIGIPASS with serial number [serialnumber] has been completed." |
| MDC Settings > Offline Activation Data | |
| The options in this section specify templates for messages sent via MDC for offline authentication data. | |
| SMS | |
| Message Template | Message template to use in SMS messages for offline authentication data. Default value: "Your offline activation data is [oad]. Serial number: [serialnumber]." |
| Voice | |
| Message Template | Message template to read by the voice delivery service for offline activation data. Default value: "Your offline activation data is [oad]. Serial number: [serialnumber]." |
| Header Name | Optional. The name of a custom message header field to set in the message header. Default value: <empty> |
| Header Value | Optional. The value of the custom message header field specified by Header Name. Default value: <empty> |
| Subject | The text which should appear in the Subject field when a message is sent for offline activation data. Default value: "Your DIGIPASS Offline Activation Data" |
| Message Template | Message template to use in mail messages for offline activation data. Default value: "Your offline activation data for the DIGIPASS with serial number [serialnumber] is [oad]. QR-code: [oadQR]." |
| MDC Settings > Device Registration Security | |
| The options in this section specify templates for messages sent via MDC if Device Registration Security is enabled. | |
| Header Name | Optional. The name of a custom message header field to set in the message header. Default value: <empty> |
| Header Value | Optional. The value of the custom message header field specified by Header Name. Default value: <empty> |
| Subject | The text which should appear in the Subject field when a message is sent for device registration security. Default value: "We detected a new device registration on your account" |
| Message Template | Message template to use in mail messages for device registration security. Default value: "Hello [username], A new mobile device was just registered on your account. If this was you, no further action is needed. You can safely ignore this message. If you do not recognize this activity, please contact your administrator or our support team immediately at ... Stay safe, Your Security Team" |
| Push Notification | |
| Title Template | The text that will be used as the title of push notifications sent for device registration security. Default value: "Device Registration Warning" |
| Subject Template | The text that will be used as the subject of push notifications sent for device registration security. Default value: "Device Registration Warning" |
| Message Template | Message template to use in push notifications for device registration security. Default value: "New device registered on your account. If this wasn't you, contact your security support team immediately." |
When you configure message templates, you can use different placeholder strings as variables. If applicable, the placeholder strings are replaced during runtime with the actual values. Otherwise the placeholder string will not be replaced.
| Placeholder string | Description |
|---|---|
| delayed_activation_period | The delayed activation period (in hours), i.e. the number of hours until an authenticator becomes active. |
| Placeholder string | Description |
|---|---|
| [oad] | The generated offline activation data, in text format. |
| [oadQR] | The generated offline activation data, presented in QR format. This field can only be used in email message templates! |
| Placeholder string | Description |
|---|---|
| [domain] | The user domain. |
| [email] | The user's email address. |
| [mobile] | The user's mobile number. In Active Directory, this refers to the Mobile field in the user's list of available Telephones. |
| [phone] | The user's phone number. In Active Directory, this refers to the Telephone number field. |
| [serialnumber] | The serial number of the authenticator. |
| [userid] | The user identifier. |
| [username] | The user name. |
| Placeholder string | Description |
|---|---|
| [servicename] | The service name that is added automatically to the message subject if it is specified either by the calling application or the client component. |