Skip to content

Latest commit

 

History

History
83 lines (56 loc) · 4.05 KB

SHAPES-EXAMPLE.md

File metadata and controls

83 lines (56 loc) · 4.05 KB

Shapes Example

A working example of this integration is provided in the cap-angular-http directory.

WHAT YOU WILL NEED

  • Access to a trial or paid Approov account
  • Android Studio installed (version Hedgehog 2023.1.1 is used in this guide) if you will build the Android app. See information about Android Development for installation instructions. Note that the ANDROID_HOME value must be properly defined to allow building.
  • Xcode installed (version 15.1 is used in this guide) to build iOS version of application. See information about iOS Development for installation instructions.
  • Cocoapods installed to support iOS building (1.12.1 used in this guide)
  • NodeJS installed in the system (version 20.10.0 was used in this guide). The version of npm was 10.2.3.
  • Ionic CLI installed in the system (version 7.1.6 was used in this guide). Note you may need to use sudo when using npm to install the Ionic CLI globally.
  • The approov command line tool installed with access to your account
  • An iOS device or simulator if you are using the iOS platform
  • An Android device or emulator if you are using the Android platform
  • The content of this repo

RUNNING THE SHAPES EXAMPLE

Firstly, clone this repo and do the following to install dependencies in cap-angular-http:

cd cap-angular-http
npm install

Now find the Approov initialization statement in the src/app/app.component.ts file:

http.approovInitialize("<enter-your-config-string-here>");

The Approov SDK needs a configuration string to identify the account associated with the app. It will have been provided in the Approov onboarding email (it will be something like #123456#K/XPlLtfcwnWkzv99Wj5VmAxo4CrU267J1KlQyoz8Qo=). Copy this to replace the text <enter-your-config-string-here>.

Now run the app on either Android or iOS as follows:

Android

If you wish to run on a physical Android device then connect it to your host platform over USB. See Run apps on a hardware device for full instructions. Use adb devices to verify that this device is connected and no other device or emulator is running.

Add the local certificate used to sign apps in Android Studio. The following assumes it is in PKCS12 format:

approov appsigncert -add ~/.android/debug.keystore -storePassword android -autoReg

See Android App Signing Certificates if your keystore format is not recognized or if you have any issues adding the certificate.

Firstly you need to prepare the Android build with:

ionic cap sync android

and then you can run the app on your device or emulator with:

ionic cap run android

You should be able to run the Shapes app and press the Shapes button to successfully get different Shapes. This indicates that Approov tokens are being auccessfully added to the Angular Http requests.

iOS

If you run on a physical device then you will need to obtain an .ipa file. Since this is quite involved we suggest that you instead ensure that attestation always passes on a specific device. Launch the app using:

ionic cap sync ios

and then you can run the app on your device or simulator with:

ionic cap run ios

Make the device always pass by executing:

approov forcepass -addDevice latest

Relaunch the app (after waiting at least 30 seconds) to force it to obtain a new Approov token.

You should be able to run the Shapes app and press the Shapes button to successfully get different Shapes. This indicates that Approov tokens are being auccessfully added to the Angular Http requests.