Step 2: instance activation

Prev Next
  1. ...

  2.  <!--Step 2 Instance activation -->

  3.  <InstanceActivation>

  4.   <OnlineInstanceActivation>

  5.    <URLmethod="POST"value="http://MY_DOMAIN_      NAME/.../mobileService">

  6.      <PayloadParameter key="action"value="instanceActivation" />

  7.      <PayloadParameter key="serialNumber"value="%_SerialNumber_%" />

  8.      <PayloadParameter key="deviceCode"value="%_DeviceCode_%" />

  9.    </URL

  10.   </OnlineInstanceActivation>

  11.    <View title="Activation (Online)">

  12.      <Labels>

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

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

  15.      </Labels>

  16.      <Errors>

  17. <Error id="ReplaceInstanceNotPermitted"  value="You cannot replace the DIGIPASS instance." />

  18. <Error id="MultiInstanceNotPermitted"  value="You cannot load another DIGIPASS instance." />

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

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

  21.      </Errors>

  22.    </View>

  23.  </InstanceActivation>

  24. ...

Functional customization

  • MultiDeviceActivation > InstanceActivation > OnlineInstanceActivation > URL:

Masks for two-step online instance activation lists the masks for two-step online instance activation with their values and if and which provisioning protocol is required.

Masks for two-step online instance activation

Mask

Value

Advanced provisioning protocol required?

Standard provisioning protocol required?

%_SerialNumber_%

This is the authenticator serial number which will be used by the server to identify the user. This mask is mandatory.

Yes (mandatory)

Yes (mandatory)

%_DeviceCode_%

This is the response that is sent to the server to validate and finalize the instance activation process. This mask is mandatory.

Yes (mandatory)

Yes (mandatory)

Graphical customization

  • MultiDeviceActivation > InstanceActivation > OnlineInstanceActivation > View: This element defines the appearance of the online instance activation screen. The background of the element is not customizable.

    • title: The default value is Activation.

  • MultiDeviceActivation > InstanceActivation > OnlineInstanceActivation > View > Labels > Label:

    • id="BiometricFingerprintRecognitionDescriptionMessage": This is the label of the biometric protection message for fingerprint recognition.

    • id="BiometricFaceRecognitionDescriptionMessage": This is the label of the biometric protection message for face recognition.

      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.

  • MultiDeviceActivation > InstanceActivation > OnlineInstanceActivation > View > Errors > Error:

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

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

  • id="MultiInstanceNotPermitted": You cannot load another DIGIPASS instance.

  • id="ReplaceInstanceNotPermitted": You cannot replace the DIGIPASS instance.