Integrate check update
  • 23 Oct 2024
  • 1 Minute to read
  • Dark
    Light
  • PDF

Integrate check update

  • Dark
    Light
  • PDF

Article summary

This feature is available only on iOS and Android devices.

Mobile Authenticator Studio can be configured to check if an update is available when the app is started. The check update feature consists of checking on the server if an update is available. If an update is available, a link to the available update can be opened.

Check update (overview)

Check update request

The web service used by Mobile Authenticator Studio is configured in the CheckUpdate section of the configuration file:

  1. <CheckUpdatemandatory="false">

  2.  <CheckUpdateRequest>

  3.    <URL method="POST"value="http://MY_DOMAIN_NAME/MY_WEB_SERVICE">

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

  5.      <PayloadParameter key="version"value="%_Version_%" />

  6.    </URL >

  7.  </CheckUpdateRequest>

  8. </CheckUpdate>

The URL can use the HTTP POST or GET methods. For more information about URL customization, refer to the Mobile Authenticator Studio Customization Guide.

Check update parameters

Parameter name

Description

SerialNumber

The authenticator serial number. If more than one instance is activated on the application, it will show the serial number of the first activated instance. If no instance is activated on the application, it is left empty.

Format: Alphanumeric string of 10 characters or an empty string

Version

The version of the Mobile Authenticator Studio app.

Format: Alphanumeric string, limited to 9 characters

Check update response

The response expected by Mobile Authenticator Studio must be formatted as described in the DTD:

  1. <!ELEMENT DP4Mobile>

  2. <!ATTLIST DP4Mobile updateApplication (no|optional|mandatory) #IMPLIED>

Example

  1. <?xml version="1.0"encoding="UTF-8"?>

  2. <DP4Mobile updateApplication="optional" />

Check update response attributes

Attribute name

Description

//DP4Mobile/@updateApplication

Indicates whether an application update is available.

Possible values are :

  • mandatory. An update is available. The application will be blocked, until the update is installed.

  • no. No update is available.

  • optional. An update is available, but installation in not mandatory.

Update request

The web service used by Mobile Authenticator Studio is configured in the CheckUpdate section of the configuration file. The defined URL is launched outside the application on the correct application (browser, Play store):

  1. <CheckUpdatemandatory="false">

  2.  <CheckUpdateRequest>

  3.    ...

  4.  </CheckUpdateRequest>

  5.  <UpdateRequest>

  6.    <URL method="GET"value="http://MY_DOMAIN_NAME/MY_WEB_SERVICE" />

  7.  </UpdateRequest>

  8. </CheckUpdate>

The URL can use the HTTP POST or GET methods. For more information about URL customization, refer to the Mobile Authenticator Studio Customization Guide.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, our interactive help assistant