Step 1: activation data

1. ...

2.  <ActivationDatauseActivationPassword="false"

3. checksumOnActivationPassword="false">

4. <OfflineActivationDatainputType="manual" useERC"false"displayImageContent="false" useSerialNumber="true">

5. <Viewtitle="Activation (Offline)">

6. <Field s>

7. <Field id="ActivationCode"name="Activation code" comment="Enter your activation code." />

8. <Field id="ActivationPassword" name="Activation password" comment="Enter your activation password." />

9. <Field id="EventReactivationCounter" name="Reactivation password"comment="Required only if your application provider sent it to you." />

10. <Field id="SerialNumber"name="Serial number" comment="Enter your serial number (10 digits)." />

11. </Field s>

12. <Labels>

13. <Labelid ="BiometricFingerprintRecognitionDescriptionMessage" value="Please authenticate using fingerprint to protect your DIGIPASS" />

14. <Labelid  ="BiometricFaceRecognitionDescriptionMessage" value="Please authenticate using face recognition to protect your DIGIPASS" />

15. </Labels>

16. <Error s>

17. <Error id="ActivationCodeEmpty" value="You must enter an activation code." />

18. <Error id="ActivationCodeIncorrectFormat" value="The Activation code format is incorrect." />

19. <Error id="ActivationCodeIncorrectLength" value="The activation code has an invalid length." />

20. <Error id="ActivationCodeInvalid" value="The activation code is invalid." />

21. <Error id ="BiometricFingerprintRecognitionAuthenticationFailed" value="Biometric authentication failed." />

22. <Error id ="BiometricFaceRecognitionAuthenticationFailed" value="Biometric authentication failed." />

23. <Error id="EventReactivationCounterIncorrectFormat" value="The reactivation password format is incorrect." />

24. <Error id="EventReactivationCounterIncorrectLength" value="The reactivation password length is incorrect." />

25. <Error id="EventReactivationCounterInvalid" value="The reactivation password is invalid." />

26. <Error id="SerialNumberAlreadyActivated" value="The Serial number is already activated." />

27. <Error id="SerialNumberEmpty" value="You must enter a serial number." />

28. <Error id="SerialNumberIncorrectLength" value="The serial number has an invalid length (it should be 10)." />

29. <Error id="StaticVectorIncorrectFormat" value="The static vector format is incorrect." />

30. <Error id="StaticVectorIncorrectLength" value="The static vector length is incorrect." />

31. </Error s>

32. </View>

33.  </ActivationData>

34. ...

Functional customization

• StandardActivation > ActivationData:

  • useActivationPassword: Include an activation password in the activation process. This attribute is optional. The default value is false.

  • checksumOnActivationPassword: Include a checksum in the activation password used during activation. This attribute is optional. The default value is false.

• StandardActivation > ActivationData > OfflineActivationData:

  • inputType: The input data method. Input can be manual (manual) or through QR code/CrontoSign image input (image). This attribute is optional. The default value is manual.

  • imageFormat: Indicates which image format the application uses for scanning. Possible values are qrCode (only scan QR code format), crontoCode (only scan CrontoSign format), or all (scan both formats). This attribute is optional. The default value is all.

  • useERC: Display an input Field  for the event reactivation counter in the offline activation process. This attribute is optional. The default value is false.

  • displayImageContent: Indicates whether the QR code or the CrontoSign image content must be displayed. This attribute is optional. The default value is false.

  • useSerialNumber: Indicates whether a serial number (e.g. "FDM1280189") must be entered by the end user during the activation process instead of entering a serial number suffix (i.e. "1280189"). This attribute is optional. The default value is true. OneSpan highly recommends keeping this value set as true.

    Instead of entering a serial number (e.g. FDM1280189), the end user could enter a serial number suffix (e.g. 1280189). However, this is not recommended because the serial number prefix will be retrieved from the static vector. Thus, the serial number prefix can differ from the static vector that is hardcoded in the mobile application (e.g. “FDL”) and the authenticator BLOBs used by the server (e.g. “FDM”). In this case, the authenticator instance will be properly activated but the generated authenticator responses (i.e. OTP and signature) will be invalid.

  For more information about the attributes of the StandardActivation elements, refer to the Mobile Authenticator Studio Product Guide.

Graphical customization

• StandardActivation > ActivationData > View: This element defines the appearance of the offline activation data screen. The background of the element is not customizable.

  • title: The default value is Activation (Offline).

• StandardActivation > ActivationData > View > Field s > Field :

  • id="ActivationCode": This is the Field  for the activation code.

  • id="ActivationPassword": This is the Field  for the activation password which will be used to decrypt the activation data.

  • id="EventReactivationCounter": This is the Field  for the event reactivation counter.

  • id="SerialNumber": This is the Field  for the serial number.

• StandardActivation > ActivationData > View > Labels > Label:

  • id="BiometricFingerprintRecognitionAuthenticationFailed": The biometric authentication failed.

  • id="BiometricFaceRecognitionAuthenticationFailed": The biometric authentication failed.

    Biometric protection is only available for:

    • iPhone devices with an iOS version later than 12.0, and Touch ID, or Face ID.

    • Samsung devices with Android 5.0 Lollipop (API level 21) or above, all devices from Android 6.0 (API level 23) with fingerprint support.

  • id="EventReactivationCounterIncorrectFormat": The format of the reactivation password is incorrect.

  • id="EventReactivationCounterIncorrectLength": The length of the reactivation password is incorrect.

  • id="EventReactivationCounterInvalid": The reactivation password is invalid.

  • id="SerialNumberAlreadyActivated": The serial number has already been activated.

  • id="SerialNumberEmpty": You must enter a serial number.

  • id="SerialNumberIncorrectLength": The length of the serial number is invalid (valid length is 10 digits).

  • id="StaticVectorIncorrectFormat": The format of the static vector is incorrect.

  • id="StaticVectorIncorrectLength": The length of the static vector is incorrect.