Skip to content
verimatrix

GitHub Action

App Shield protect

2.0.1 Latest version

App Shield protect

verimatrix

App Shield protect

Secure your Android and iOS mobile apps with proven in-app protection including obfuscation, device checks and anti-tamper

Installation

Copy and paste the following snippet into your .yml file.

              

- name: App Shield protect

uses: Verimatrix/app-shield-protect@2.0.1

Learn more about this action in Verimatrix/app-shield-protect

Choose a version

Verimatrix XTD and Counterspy

This action integrates Verimatrix Extended Threat Defense and Counterspy into your GitHub build workflow. It automates the protection of your Android and iOS apps so you can run it whenever a new version of your application is built.

Verimatrix XTD and Counterspy are a zero-code in-app protection services. They protect your apps from reverse engineering and attack through a layered security approach. Protection layers include obfuscation, environmental checks and binary integrity checks.

All XTD subscription tiers support this action, while for Counterspy you need a Standard subscription.

API Keys

In order to use the action, an API key is required. This can be created and retrieved in XTD or Counterspy portal under "Settings" menu, in the "API Key Manager" panel. Simply click the "Generate New API Key" button for generating a new key.

{
  "appClientId": "7m.........0s5i",
  "appClientSecret": "cm1m65g.......jt",
  "encodedKey": "Njd.........tbzBzNW.......0"
}

Once generated, you are adviced to add the API key owners username (email) and the value of the 'encodedKey' field to your project as action secrets and reference those in your workflow configuration.

Input

Action requires the following parameters and corresponding values:

  • api-key-id - The username (email) of the owner the API key generated above
  • api-key-secret - Value of the 'encodedKey' field of the API key generated above
  • app_file - mobile application file (.zip, .apk or aab)

Outputs

Action produces a single output:

  • protected-file - protected file name that was downloaded from APS.

The protected-file name can be used with upload-artifact action to save the file as a build artifact.

Usage

- name: Application Protection
  id: app-protect
  uses: verimatrix/app-protect@v2
  with:
    api-key-id: ${{ secrets.API_KEY_ID }}
    api-key-secret: ${{ secrets.API_ENCODED_KEY }}
    app-file: ${{ github.event.inputs.file }}