Page tree
Skip to end of metadata
Go to start of metadata

Digital.ai's Application protection shield apps from reverse engineering, tampering, API exploits, and other attacks that can put your business, your customers, and your bottom line at risk. 

To test mobile applications protected by Digital.ai's Application Protection, follow the instructions below: 



Prerequisites

A protected application might fail to be uploaded to the cloud if any change has been made to it during the upload.

To avoid any modification to the app:

  1. Do not instrument the app
  2. Do not add Camera, Fingerprint or Network instrumentations
  3. Keep the original signature - Make sure the signing provision profile / Keystore used when signing the app allows you to install it on the cloud devices and choose "Allow resign parameter to be false (allow resign applies only to iOS)


1. Upload your application

A Protected application can be uploaded in two ways:

  1. Upload through RESTful API
  2. Upload through Applications page (UI)






1.1. Upload Application through RESTful API

Please notice - NO OTHER Parameters other than the mentioned below when working with a protected application

POST /api/v1/applications/new


Parameters

Name

Type

Mandatory

Description

file
FileYes

A multi-part file

uniqueNameStringNoString that the user can use later to identify the app uniquely
projectStringNo

Available for cloud admin only, if the project isn't specified, it will be uploaded to Default project.

Project name can be provided or a project id in the following format:

id:<id>. For example: id:123.

Additional Parameter for iOS

Name

Type

Mandatory

Description

allowResignBooleanNo

Should be set to false to force the cloud to keep the original signature.




1.2. Upload Application through the Applications page (UI)

Navigate to the 'Applications' page














Upload Application:

Step 1: Click 'Upload'

Step 2: Select the file to be uploaded













Do not check the following checkboxes (Android only):

Include simulate capture (camera) libraries

Include Touch ID (fingerprint) libraries

Support Network Capture



Step 3: Click add to start uploading the application





To disable allowResign for iOS devices:

  1. Select the application and click on edit
  2. Uncheck "Allow Profile Resign"
  3. Click "Save"







2. Install your Application

Now that the application is uploaded, there are several ways to install it.
For protected applications, make sure that you do not install the app in instrumented mode:

  1. During a manual session
  2. In an Appium test, "instrumentApp" capability must not be used or set to false
  3. Using the "Install" command - set the "instrument" parameter to false
  4. Install through RESTful API - instrument parameter must not be used or set to false





3. Launch your Application

Now that the application is uploaded and installed there are several ways to launch it.
For protected applications, make sure that you do no launch the app in instrumented mode:

  1. During a manual session - (Link to documentation maybe?)
  2. In an Appium test, "instrumentApp" capability must not be used or set to false
  3. Using the "Launch" command - set the "instrument" parameter to false








  • No labels