NowSecure AUTO CircleCI Plugin

This plugin adds the ability to perform automatic mobile app security testing for Android and iOS mobile apps through the NowSecure AUTO test engine.

Summary:

Purpose-built for mobile app teams, NowSecure AUTO provides fully automated, mobile appsec testing coverage (static+dynamic+behavioral tests) optimized for the dev pipeline. Because NowSecure tests the mobile app binary post-build from CircleCI, it can test software developed in any language and provides complete results including newly developed code, 3rd party code, and compiler/operating system dependencies. With near zero false positives, NowSecure pinpoints real issues in minutes, with developer fix details, and routes tickets automatically into ticketing systems, such as Jira. NowSecure is frequently used to perform security testing in parallel with functional testing in the dev cycle. Requires a license for and connection to the NowSecure AUTO software. https://www.nowsecure.com

Job Parameters

Following are parameters needed for the job

auto_token: mandatory parameter for API token. visit https://docs.nowsecure.com/auto/integration-services/jenkins-integration to generate token. Also, we recommend using environment variable AUTO_TOKEN to define this parameter instead of using job parameter.
auto_file: mandatory parameter to specify mobile binary. Note you must attach workspace from previous step where this file was created.
auto_url: optional parameter for nowsecure auto API URL with default value of https://lab-api.nowsecure.com
auto_group: optional parameter for group-id. You can also use environment variable AUTO_GROUP to specify this
auto_wait: optional parameter to specify maximum wait in minutes until security test is completed. The default value is 30 minutes and you can skip wait by specifying 0 value.
auto_show_status_messages: Specify flag to show status messages from automation testing

Sample Usage

You can use Auto CircleCI Orb as follows:

version: 2.1
orbs:
  auto_ci: nowsecure/ci-auto-orb@1.2.1
jobs:
  build:
    docker:
    - image: openjdk:8
    steps:
    - attach_workspace:
        at: /tmp/myworkspace
    - checkout
    - run: cp apkpure_app_887.apk /tmp/myworkspace/test.apk
    - auto_ci/mobile_security_test:
        auto_file: /tmp/myworkspace/test.apk
        auto_wait: "30"
        auto_score: "50"
        auto_show_status_messages: "true"

Note that you will generate mobile binary using gradle, Makefile, Fastlane or other tools instead of copying file but it shows how binary file will be created and then passed to the Auto CircleCI Orb for security analysis.

Getting Started:

Access token

Generate token as described on https://docs.nowsecure.com/auto/integration-services/jenkins-integration. This token will be specified by environment variable AUTO_TOKEN in CircleCI context as bellow.

CircleCI project

Create a CircleCI project by visiting https://circleci.com and selecting "ADD PROJECTS" from left tab, e.g.

Context in CircleCI

Create a context in Circle CI by visiting https://circleci.com, selecting "SETTINGS" from left tab and then selecting "Context" from left navigation, e.g.

Environment variables in Context

Define environment variables for your token and group (optionally), e.g.

Add Plugin to your .circleci/config.yml

Use above example to add NowSecure plugin (nowsecure/ci-auto-orb) to your config.yml

Submit build

After checking in changes, the circle-ci build should kick off and you can see the output as it's running, e.g.

View Artifacts

Once the job is completed, you can view JSON artifacts generated by the mobile security testing, e.g.

nowsecure / auto-circleci-plugin