Add Device Operation

The add device operation allows an administrator to register a new or additional device for a particular authenticator license. The device must include authenticator software and/or firmware that is compliant with the multi-device licensing (MDL) model.

This operation is used as the second step in the multi-device licensing (MDL) process. This operation verifies the device code generated by the authenticator based on Activation Message 1. It creates a new authenticator instance for the authenticator license and returns Activation Message 2, which must then be transferred to the authenticator to create the authenticator instance on that device. This operation is optionally followed by a test signature operation (see Test signature with Secure Channel operation).

Activation Message 2 must be transferred to the authenticator. This can be done encoded as a QR code or a color QR code, which the user scans with the camera of the device.

To execute this operation, the registered client application must send a digipassExecute SOAP command to OneSpan Authentication Server, where the value for the cmd element is  DIGIPASSCMD_ADD_DEVICE.

At a minimum, this SOAP command requires the following set of field attributes to perform this operation:

• DIGIPASSFLD_SERNO
• DIGIPASSFLD_DEVICE_CODE

For more information about the required and optional attributes for this command, see the OneSpan Authentication Server SDK SOAP Reference.