Integrate activation data input from an image
- 23 Oct 2024
- 1 Minute to read
- DarkLight
- PDF
Integrate activation data input from an image
- Updated on 23 Oct 2024
- 1 Minute to read
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
To configure Mobile Authenticator Studio to scan activation images and retrieve activation data for an offline activation process, the following settings must be defined in the configuration file:
<ActivationData useActivationPassword="false" checksumOnActivationPassword="false">
<OfflineActivationData useERC="false"inputType="image" imageFormat="all"displayImageContent="false">
...
</OfflineActivationData>
</ActivationData>
To activate Mobile Authenticator Studio with a QR code or Cronto image, the image content must be based on the following format:
<QRCode>
<SN>SERIAL_NUMBER_VALUE</SN>
<AC>ACTIVATION_CODE_VALUE </AC>
<ERC>EVENT_REACTIVATION_COUNTER_VALUE </ERC>
<USERID>USER_IDENTIFIER_VALUE</USERID>
<CHALLENGE>CHALLENGE_VALUE</CHALLENGE>
</QRCode>
The content of the QR code or Cronto image can be generated by the Secure Messaging SDK Server 4.3.2 or later by calling the activation message body generation functionality in version 1.
Java
publicstatic String generateActivationMessageBodyV1(String serialNumber, String activationCode, String erc, String userIdentifier, String challenge) throws MessageSDKException
.NET
publicstatic String GenerateActivationMessageBodyV1(String serialNumber, String activationCode, String erc, String userIdentifier, String challenge)
Parameter name | Description |
|---|---|
serialNumber (SN) | Required. The serial number of the authenticator to activate. Format: Alphanumeric string of 10 characters |
activationCode (AC) | Required. The authenticator activation code. Format: Decimal character string. Length depends on the authenticator static vector, either 20, 21, 40, or 41 characters. |
erc (ERC) | Optional. The authenticator event reactivation counter, which must be used if the authenticator is reactivated. It is generated by OneSpan Authentication Server Framework. Format: Decimal character string, up to 91 characters |
userIdentifier (USERID) | Optional. The extra user identifier that can be associated with the authenticator. Format: Alphanumeric string, limited to 40 characters |
challenge (CHALLENGE) | The challenge to use if the authenticator is configured to use the post-activation process with a Challenge/Response cryptographic application. It is mandatory in case of a Challenge/Response application. |
The QR code can be generated by the Image Generator SDK 4.3.2 or later by calling the QR code generation API.
Java
publicstatic BWQRCodeResponse generateBWQRCode(int imageSize, String inputValue, int errorCorrectionLevel) throws ImageGeneratorException
.NET
publicstatic BWQRCodeResponse GenerateBWQRCode(int imageSize, String inputValue, int errorCorrectionLevel)
Was this article helpful?