VyAPI is a vulnerable hybrid Android app that's vulnerable by design. We call it VyAPI, because it's flaws are pervasive and it communicates not just via IPC calls but API calls, too.
More details in our introductory blog post
Amazon Cognito has been used to handle authentication, authorization and user management. AWS Amplify Console has been used to consume the Authentication APIs provided by AWS Amplify Authentication module. Room persistence library has been used to handle data in the local SQLite database. Glide API has been used to load images. AndroidX libraries and JAVA programming language have been used to develop the business logic of VyAPI Android app.
We know how to attack activities, but, what could change with fragments coming into the picture? There might be a case where we just have one activity, but multiple fragments (each rendering a different functionality) in our Android app. VyAPI will allow you to experience this behavior of our modern day Android apps.
VyAPI is different not only in terms of its look and feel, but also in terms of latest technologies being used to build it. Following primary tools and technologies have been used to develop VyAPI
- AWS Amplify CLI
- AWS Mobile SDK for Android 10
- Amazon Cognito
- OpenJDK 1.8.0_152-release
- Glide v4
- Room Persistence Library
- Gradle 5.1.1
Modern technologies are eliminating security risks by blocking vulnerable features by default. However, not all vulnerabilities could go away that easily. Also, with new technologies come new security vulnerabilities. Security misconfigurations, business logic flaws, and poor coding practices are evergreen vulnerabilities. VyAPI is the vulnerable hybrid Android app which can be used by our security enthusiasts to get a hands-on experience of a variety of modern and legacy Android app vulnerabilities.
- Node.js (Latest version)
- Amplify CLI
- Android Studio and SDK Tools (for building the APK)
- An active AWS account with Administrative access
- Android emulator (API level 23 or above)
Note: The commands have been verified in a Linux environment (Ubuntu 19.04).
-
Install Amplify CLI
sudo npm install -g @aws-amplify/cli --unsafe-perm=trueNote:
--unsafe-perm=trueis required because of a recent issue with Amplify and latest version of gyp. Ignore errors related to dependencies. -
Check if Amplify CLI was installed successfully
amplify status
-
Checkout the source code from Github
git clone git@github.com:appsecco/VyAPI.git -
Enter the root directory of the cloned project.
cd VyAPI/ -
Run following command to initialize the project to work with the Amplify CLI
amplify initSample Output:
user@machine:~$ amplify init Note: It is recommended to run this command from the root of your app directory ? Do you want to use an existing environment? No ? Enter a name for the environment cognito ? Choose your default editor: Visual Studio Code Using default provider awscloudformation For more information on AWS Profiles, see: https://docs.aws.amazon.com/cli/latest/userguide/cli-multiple-profiles.html ? Do you want to use an AWS profile? Yes ? Please choose the profile you want to use amplify-user ⠇ Initializing project in the cloud... CREATE_IN_PROGRESS vyapimvvm-cognito-20190909113320 AWS::CloudFormation::Stack Mon Sep 09 2019 11:33:21 GMT+0530 (India Standard Time) User Initiated CREATE_IN_PROGRESS DeploymentBucket AWS::S3::Bucket Mon Sep 09 2019 11:33:24 GMT+0530 (India Standard Time) CREATE_IN_PROGRESS UnauthRole AWS::IAM::Role Mon Sep 09 2019 11:33:24 GMT+0530 (India Standard Time) CREATE_IN_PROGRESS AuthRole AWS::IAM::Role Mon Sep 09 2019 11:33:24 GMT+0530 (India Standard Time) CREATE_IN_PROGRESS UnauthRole AWS::IAM::Role Mon Sep 09 2019 11:33:24 GMT+0530 (India Standard Time) Resource creation Initiated CREATE_IN_PROGRESS DeploymentBucket AWS::S3::Bucket Mon Sep 09 2019 11:33:25 GMT+0530 (India Standard Time) Resource creation Initiated CREATE_IN_PROGRESS AuthRole AWS::IAM::Role Mon Sep 09 2019 11:33:25 GMT+0530 (India Standard Time) Resource creation Initiated ⠴ Initializing project in the cloud... CREATE_COMPLETE UnauthRole AWS::IAM::Role Mon Sep 09 2019 11:33:38 GMT+0530 (India Standard Time) CREATE_COMPLETE AuthRole AWS::IAM::Role Mon Sep 09 2019 11:33:39 GMT+0530 (India Standard Time) ⠧ Initializing project in the cloud... CREATE_COMPLETE DeploymentBucket AWS::S3::Bucket Mon Sep 09 2019 11:33:45 GMT+0530 (India Standard Time) ⠏ Initializing project in the cloud... CREATE_COMPLETE vyapimvvm-cognito-20190909113320 AWS::CloudFormation::Stack Mon Sep 09 2019 11:33:48 GMT+0530 (India Standard Time) ✔ Successfully created initial AWS cloud resources for deployments. ✔ Initialized provider successfully. Initialized your environment successfully. Your project has been successfully initialized and connected to the cloud! Some next steps: "amplify status" will show you what you've added already and if it's locally configured or deployed "amplify <category> add" will allow you to add features like user login or a backend API "amplify push" will build all your local backend resources and provision it in the cloud "amplify publish" will build all your local backend and frontend resources (if you have hosting category added) and provision it in the cloud Pro tip: Try "amplify add api" to create a backend API and then "amplify publish" to deploy everything
-
Configure Amplify CLI by running below command and following the instructions as displayed on the console
amplify configureSample Output:
user@machine:~$ amplify configure Follow these steps to set up access to your AWS account: Sign in to your AWS administrator account: https://console.aws.amazon.com/ Press Enter to continue Specify the AWS Region ? region: us-east-1 Specify the username of the new IAM user: ? user name: amplify-user Complete the user creation using the AWS console https://console.aws.amazon.com/iam/home?region=undefined#/users$new?step=final&accessKey&userNames=amplify-user&permissionType=policies&policies=arn:aws:iam::aws:policy%2FAdministratorAccess Press Enter to continue Enter the access key of the newly created user: ? accessKeyId: A********************** ? secretAccessKey: p************************************* This would update/create the AWS Profile in your local machine ? Profile Name: amplify-user Successfully set up the new user.
Note:
- It requires you to login into the AWS Management Console.
- You need to create a new user and obtain the corresponding Access Key ID and Secret Access Key values.
- If you wish to reuse an existing user, skip the user creation step and press enter to enter the access key of an existing user.
-
Run the following command to add authentication resource in your local backend:
amplify add authSample Output:
user@machine:~$ amplify add auth Using service: Cognito, provided by: awscloudformation The current configured provider is Amazon Cognito. Do you want to use the default authentication and security configuration? Default configuration Warning: you will not be able to edit these selections. How do you want users to be able to sign in? Username Do you want to configure advanced settings? No, I am done. Successfully added resource vyapicbc9b00d locally Some next steps: "amplify push" will build all your local backend resources and provision it in the cloud "amplify publish" will build all your local backend and frontend resources (if you have hosting category added) and provision it in the cloud
-
Check the state of local resources not yet pushed to the cloud
amplify statusSample Output:
user@machine:~$ amplify status Current Environment: cognito | Category | Resource name | Operation | Provider plugin | | -------- | ----------------- | --------- | ----------------- | | Auth | vyapimvvm59909b03 | Create | awscloudformation |
-
Push the local changes to cloud
amplify pushNote: Please be patient while this command runs, as it would take a few minutes to complete.
-
Open the project in Android Studio.
-
Generate the VyAPI APK by selecting
Build Bundle(s)/ APK(s)->Build APK(s)in Android Studio
-
Obtain the VyAPI APK from the relative path
app/release/app-release.apk
-
Create an Android Emulator.
Note: The emulator used during the development of VyAPI had following configuration
-
Install the VyAPI APK (obtained from step #11, above) into the Android Emulator by running the following command
adb install app-release.apk
-
Start the VyAPI app to see the Amazon Cognito login screen
-
Click on the Create New Account button and fill the user registration form.
Note:
- Enter a valid email ID
- Enter 10 digit phone number preceded by plus symbol and two-digit country code (e.g., +915544332211)
- Confirmation code would be sent to your registered email address
-
Retrieve the confirmation code from your inbox and paste it into the
Confirmation codeinput box of Confirm your account page
-
Wait for the Sign up confirmation message to show up
-
Login with the registered username and password
-
On successful login, you would see the empty contacts page
On this screen, you can do following
- Create a new contact
- Edit an existing contact
- Select an existing contact and
- Call the user
- Send SMS
- Send email
- Open user's website
- Open user's location in Google Maps
- Delete an existing contact by swiping the selected contact in right or left direction
-
Access the Navigation Menu to see other available options
-
Play some music
-
Click some pictures
-
View clicked pictures in the gallery
-
Explore the remaining features and vulnerabilities.
- Presenting a modern cloud based vulnerable Android app - VyAPI
- The Story of how I made a vulnerable Android App VyAPI
In case of bugs in the application, please create an issue on github. Pull requests are highly welcome!
- @makash: For guiding and encouraging me to explore my interest area
- @riyazwalikar and Gwilym: For helping me with VyAPI logo design
- @suneshgovind: For helping me with the documentation and picture editing
- madhuakula: For prompt feedback and helping with Ops tasks
- yamakira and abhisek: For their feedback, suggestions and encouragement
- Ayush Gaurav: For his creative inputs while editing the image used on vulnerable service screen
- Special thanks to people whom I met through their blogposts and/or their helpful responses on stackoverflow.com, and who's work helped me clarify my concepts and, ultimately, allowed me to turn my imagination into a working model.