Step 3: post-activation

1. ...

2. <PostActivationbinding="false"cryptoAppIndex="1">

3. <OnlinePostActivation.../>

4. <!-- OR -->

5. <!--<OfflinePostActivation .../>-->

6. Viewtitle="First OTP">

7. <Fields>

8. <Fieldid="Challenge"name="Challenge"comment="Enter the challenge." />

9. </Fields>

10. <Labels>

11. <Labelid="ClipboardCopyHostCode"value="Server response copied to clipboard" />

12. <Labelid="ClipboardCopyResponse"value="Derivation code copied to clipboard" />

13. <Labelid="OnlineServerActivationWaitMessage"value="Activation confirmation, please wait..." />

14. <Labelid="ResultHostCode"value="Serverresponse:" />

15. <Labelid="ResultResponse"value="Your derivation code is:" />

16. <Labelid="SerialNumber"value="Serial number:" />

17. </Labels/>

18. <Dynamics>

19. <Dynamicid="ResultHostCode"class="generated" />

20. <Dynamicid="ResultResponse"class="generated" />

21. <Dynamicid="SerialNumber"class="text" />

22. </Dynamics>

23. <Errors>

24. <Errorid="ChallengeEmpty"value="The activation response does not include a challenge." />

25. <Errorid="ChallengeTooShort"value="The minimal length for the challenge is %_MinLength_%." />

26. <Errorid="ChallengeTooLong"value="The maximal length for the challenge is %_MaxLength_%." />

27. </Errors>

28. </View>

29.  </PostActivation>

30. </StandardActivation>

Functional customization

• StandardActivation > PostActivation: This element is used to configure the post-activation functionality.

  • binding: Enable device binding. This attribute is optional. The generated response will be an OTP (false) or a derivation code (true). The default value is false.

  To share the same derivation data between several applications on the same iOS device, the application must use the same Bundle Seed ID. On other platforms, the derivation data is always shared.

  • cryptoAppIndex: Defines the index of the cryptographic application used to generate the response. This attribute is mandatory.

Post-activation mode

Post-activation can be done either in an online or in an offline process. Only one mode must be used.

Online post-activation

1. <PostActivationbinding="false"cryptoAppIndex="1">

2. <OnlinePostActivationdestroyOnFailure="false" displayMessageOnSuccess="false">

3. <URLmethod="GET"value= "http://MY_DOMAIN_NAME/..." />

4. <OnlinePostActivation>

5. ...

6. ...

7. </PostActivation>

• StandardActivation > PostActivation > OnlinePostActivation

  • destroyOnFailure: Indicates whether Mobile Authenticator Studio must be destroyed if post-activation fails. The default value is false.

  • displayMessageOnSuccess: Used to specify if the server message must be displayed for a successful post-activation process. The default value is false.

• StandardActivation > PostActivation > OnlinePostActivation > URL: This element must be used to define the URL from which to retrieve the activation data.

Masks for online post-activation URL lists the masks for the online post-activation URL.

Offline post-activation

1. <PostActivationbinding="false" cryptoAppIndex="1">

2. <OfflinePostActivationdisplaySerialNumber="false" responsePattern="XX-XX-XX"hostCodePattern="XX-XX.XX"

   centered="false" />

3. ...

4. ...

5. </PostActivation>

• StandardActivation > PostActivation > OfflinePostActivation

  • displaySerialNumber: Indicates whether the Mobile Authenticator Studio serial number is displayed. This attribute is optional. The default value is false.

  • responsePattern: Can be used to apply a display pattern to the generated response. This attribute is optional. The default value is No formatting.

  • hostCodePattern: Can be used to apply a display pattern to the generated host code. This attribute is optional. The default value is No formatting.

  • centered: Used to specify if the result must be centered or top-aligned. The default value is false.

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

The system does not offer a scrollbar in centered mode. The page view may, however, be truncated if the content to be displayed is larger than the available screen size.

Graphical customization

• StandardActivation > PostActivation > View: This element defines the graphical rendering of the post-activation functionality. The background of the element is not customizable.

  • title: The default value is PostActivation.

• StandardActivation > PostActivation > View > Fields > Field:

  • id="Challenge": This is the field for the challenge if the application that generates the response is in Challenge/Response mode.

• StandardActivation > PostActivation > View > Labels > Label:

  • id="ClipboardCopyHostCode": This message is displayed when the user copies the generated host code. It is displayed on Android devices only.

  • id="ClipboardCopyResponse": This message is displayed when the user copies the generated response. It is displayed on Android devices only.

  • id="OnlineServerActivationWaitMessage": This message is displayed while waiting for the server activation.

  • id="ResultHostCode": This is the label of the generated host code.

  • id="ResultResponse": This is the label of the generated response.

  • id="SerialNumber": This is the label of the Mobile Authenticator Studio serial number.

• StandardActivation > PostActivation > View > Dynamics > Dynamic:

  • id="ResultHostCode": Can be used to customize the rendering of the generated host code.

  • id="ResultResponse": Can be used to customize the rendering of the generated response.

  • id="SerialNumber": Can be used to customize the rendering of the Mobile Authenticator Studio serial number.

• StandardActivation > PostActivation > View > Errors >Error:

  • id="ChallengeEmpty": The activation response does not include a challenge.

  • id="ChallengeTooShort": The minimum challenge length is %_MinLength_%.

    The %_MinLength_% mask is used by Mobile Authenticator Studio to replace the minimum length of the challenge in the error message.

  • id="ChallengeTooLong": The maximum challenge length is %_MaxLength_%.

    The %_MaxLength_% mask is used by Mobile Authenticator Studio to replace the maximum length of the challenge in the error message.