dhp-testing-proxy

Version 1.0, December 2022

↳ Introduction

↳ Installation

↳ Prerequisites

↳ Testing With the Proxy

↳ Testing

Introduction

Merative^® provides this application for Digital Health Pass mobile wallet and verifier app testing on a local environment without requiring external cloud services. This application is a proxy for all mobile requests to DHP API. Endpoint stubs are provided for the Verifier Configuration and Metering services.

↑ Top

Installation

It is recommended to use Node.js v16

To install the dependencies and run the service perform the following from a command line.

cd dhp-testing-proxy
npm i
npm run start

↑ Top

Prerequisites

CouchDB

Download and install CouchDB. After installation start CouchDB and you will be prompted to enter an admin user id and password. Take note of these values since they will be required to form the required DHP API environment variable COUCHDB_URL. e.g. http://admin:password@127.0.0.1:5984.

DHP API

Clone the DHP API repository. Follow the README to configure the service then start it.

Postman

Download Postman then import the collection and environment from the DHP API postman folder (/dhp-api/postman). The following requests must be executed from the Postman collection.

• /Issuer/onboard issuer/Create DHP Issuer
• /Issuer/metadata/update DHP Issuer metadata
• /Schema/Create Schema/
• /Schema/Create VC login Schema
• /Credentials/Create qr Credential - This creates a QR code credential that can be scanned by the wallet or verifier app.
• /Credentials/Create VC Login Credential - This create a Verifier Configuration login QR code credential that must be scanned by the verifier app before scanning credentials.

Android Wallet and Verifier

A mobile device is required to be connected via a USB cable to run the apps from Android Studio. Developer options and USB-debugging must be enabled on the device.

• Download and install Android Studio.
• Clone the DHP Android repo and open it with Android Studio.
• Modify the code like this branch demonstrates to add the IP address where DHP testing proxy is running.
• When the app initially starts you will be prompted with a list of environments. Select the one added above.
• Switch the build variant in Android Studio to walletQa to run the wallet app.
• Switch the build variant in Android Studio to verifyQa to run the verifier app.

iOS Wallet and Verifier

Instructions TBD

https://github.com/digitalhealthpass/dhp-ios-app

↑ Top

Testing

Once the prerequisites are met follow these steps in order to test the mobile app against the testing proxy.

• Start DHP API.

cd dhp-api
npm run start

• Start DHP Testing Proxy.

cd dhp-testing-proxy
npm run start

• Android
  • Connect an Android device to the dev machine via a USB cable.
  • Select the appropriate build variant in Android Studio.
  • Press play in Android Studio.
  • Follow the instructions on the app ensuring you select the environment where the testing proxy is running.
  • Create QR codes from Postman and begin scanning.

-iOS - TBD

↑ Top