- 23 Oct 2024
- 4 Minutes to read
- DarkLight
- PDF
Step 1: activation data
- Updated on 23 Oct 2024
- 4 Minutes to read
- DarkLight
- PDF
...
<ActivationDatauseActivationPassword="true"checksumOnActivationPassword="false">
<OnlineActivationDatainputType="manual"advanced="false"useRegistrationIdentifier="true"useAuthorizationCode="false"checksumOnAuthorizationCode="false">
<URLmethod="GET" value="http://MY_DOMAIN_NAME/..." />
</OnlineActivationData>
<Viewtitle="Activation (Online)">
<Fields>
<Fieldid="ActivationPassword"name="Activation password"comment="Enter your activation password." />
<Fieldid="AuthorizationCode"name="Authorization code"comment="Enter your authorization code." />
<Fieldid="Identifier"name="Identifier" comment="Enter your identifier." />
</Fields>
<Labels>
<Labelid="GetActivationDataWaitMessage" value="Retrieving activation data, please wait..." />
<Labelid="BiometricFingerprintRecognitionDescriptionMessage" value="Please authenticate using fingerprint to protect your DIGIPASS" />
<Labelid="BiometricFaceRecognitionDescriptionMessage" value="Please authenticate using face recognition to protect your DIGIPASS" />
</Labels>
<Errors>
<Errorid="ActivationDataInconsistent" value="Inconsistent Static Vector in XFAD." />
<Errorid="ActivationDataIncorrectFormat" value="The activation data format is incorrect." />
<Errorid="ActivationDataIncorrectLength" value="The activation data length is incorrect." />
<Errorid="ActivationDataMissing" value="The network response does not include the activation data." />
<Errorid="ActivationPasswordEmpty" value="You must enter an activation password." />
<Errorid="ActivationPasswordInvalid" value="The activation password is invalid." />
<Errorid="AuthorizationCodeEmpty" value="You must enter an authorization code." />
<Errorid="AuthorizationCodeInvalid" value="The authorization code is invalid." />
<Errorid="BiometricFingerprintRecognitionAuthenticationFailed" value="Biometric authentication failed." />
<Errorid="BiometricFaceRecognitionAuthenticationFailed" value="Biometric authentication failed." />
<Errorid="EventReactivationCounterIncorrectFormat" value="The reactivation password format is incorrect." />
<Errorid="EventReactivationCounterIncorrectLength" value="The reactivation password length is incorrect." />
<Errorid="EventReactivationCounterInvalid" value="The reactivation password is invalid." />
<Errorid="IdentifierEmpty" value="You must enter an identifier." />
<Errorid="IdentifierInvalid" value="The identifier is invalid." />
<Errorid="SerialNumberAlreadyActivated" value="The Serial number is already activated." />
</Errors>
</View>
</ActivationData>
...
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 > OnlineActivationData:
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.
advanced: Enable advanced activation. This attribute is optional. If enabled for activation, the advanced mode is inherited by the post-activation process. The default value is false.
useRegistrationIdentifier: Include a registration identifier in the online activation process. This attribute is optional. The default value is false.
useAuthorizationCode: Include an authorization code in the online activation process. This attribute is optional. The default value is false.
checksumOnAuthorizationCode: Include a checksum in the authorization code used during online activation. This attribute is optional. The default value is false.
For more information about the attributes of the StandardActivation elements, refer to the Mobile Authenticator Studio Product Guide.
StandardActivation > ActivationData > OnlineActivationData > URL: If online activation is enabled, this element must be used to define the URL from which to retrieve the activation data.
Masks for standard online activation lists the masks for standard online activation with their values and if and which provisioning protocol is required.
Mask | value | Advanced provisioning protocol required? | Standard provisioning protocol required? |
---|---|---|---|
%_RegistrationIdentifier_% | This is the identifier which will be used by the server to identify the user. This mask is optional. | Yes (mandatory) | Yes (mandatory) |
%_Nonce_% | This is a nonce (number used once) which can be used to encrypt the activation data in standard activation only (not for advanced activation). This mask is optional. | No | Yes (mandatory) |
%_AuthorizationCode_% | This is the authorization code. This mask is optional. | Yes (optional) | Yes (optional) |
%_Version_% | This is the Mobile Authenticator Studio version. This mask is optional. | Yes (optional) | Yes (optional) |
%_InitialVector_% | This is the initial vector (advanced activation mode only). | Yes (mandatory) | No |
%_PublicKey_% | This is the public key (advanced activation mode only). | Yes (mandatory) | No |
%_DeviceIdentifier_% | This is the unique identifier of the device. It is calculated using the fingerprint (64 hexadecimal characters). This mask is optional. | Yes (optional) | Yes (optional) |
%_RootingStatus_% | This is the status indicating if the device is rooted. Possible values are true or false. | Yes (optional) | Yes (optional) |
Graphical customization
StandardActivation > ActivationData > View: This element defines the appearance of the online activation data screen. The background of the element is not customizable.
title: The default value is Activation (Online).
StandardActivation > ActivationData > View > Fields > Field:
id="ActivationPassword": This is the field for the activation password which will be used to decrypt the activation data.
id="AuthorizationCode": This is the field for the authorization code which will be sent to the server.
id="Identifier": This is the field for the identifier which will be sent to the server.
StandardActivation > ActivationData > View > Labels > Label:
id="GetActivationDataWaitMessage": This message is displayed while the activation data is being retrieved.
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.
StandardActivation > ActivationData > View > Errors > Error:
id="ActivationDataInconsistent": Inconsistent static vector in XFAD.
id="ActivationDataIncorrectFormat": The activation data format is incorrect.
id="ActivationDataIncorrectLength": The length of the activation data is incorrect.
id="ActivationDataMissing": The network response does not include the activation data.
id="ActivationPasswordEmpty": You must enter an activation password.
id="ActivationPasswordInvalid": The activation password is invalid.
id="AuthorizationCodeEmpty": You must enter an authorization code.
id="AuthorizationCodeInvalid": The authorization code is invalid.
id="BiometricFingerprintRecognitionAuthenticationFailed": The biometric authentication failed.
id="BiometricFaceRecognitionAuthenticationFailed": The biometric authentication failed.
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="IdentifierEmpty": You must enter an identifier.
id="IdentifierInvalid": The identifier is invalid.
id="SerialNumberAlreadyActivated": The serial number has already been activated.