Skip to main content

Static analysis tool for Android/iOS apps focusing on security issues outside the source code.

Project description

truegaze

PyPI version Build Status codecov GitHub

A static analysis tool for Android and iOS applications focusing on security issues outside the source code such as resource strings, third party libraries and configuration files.

Requirements

Python 3 is required and you can find all required modules in the requirements.txt file. Only tested on Python 3.7 but should work on other 3.x releases. No plans to 2.x support at this time.

Installation

You can install this via PIP as follows:

pip install truegaze
truegaze

To download and run manually, do the following:

git clone https://github.com/nightwatchcybersecurity/truegaze.git
cd truegaze
pip install -r requirements.txt
python -m truegaze.cli

How to use

To list modules:

truegaze list

To scan an application:

truegaze scan test.apk
truegaze scan test.ipa

To scan multiple applications:

truegaze scan *.apk
truegaze scan *.ipa

Sample output

Listing modules:

user@localhost:~/$ truegaze list
Total active plugins: 3
+----------------+-------------------------------------------+---------+-------+
|      Name      |               Description                 | Android | iOS   |
+----------------+-------------------------------------------+---------+-------+
| AdobeMobileSdk | Detection of incorrect SSL configuration  |  True   | True  |
|                |          in the Adobe Mobile SDK          |         |       |
+----------------+-------------------------------------------+---------+-------+
| FirebasePlugin | Detection of insecure Firebase databases  |  True   | False |
|                |          and GCP storage buckets          |         |       |
+----------------+-------------------------------------------+---------+-------+
| WeakKeyPlugin  |  Detection of weak Android signing keys   |  True   | False |
+----------------+-------------------------------------------+---------+-------+

Scanning an application:

user@localhost:~/$ truegaze scan ~/test.ipa
Identified as an iOS application via a manifest located at: Payload/IPAPatch-DummyApp.app/Info.plist
Scanning using the "AdobeMobileSdk" plugin
-- Found 1 configuration file(s)
-- Scanning "Payload/IPAPatch-DummyApp.app/Base.lproj/ADBMobileConfig.json'
---- FOUND: The ["analytics"]["ssl"] setting is missing or false - SSL is not being used
---- FOUND: The ["remotes"]["analytics.poi"] URL doesn't use SSL: http://assets.example.com/c234243g4g4rg.json
---- FOUND: The ["remotes"]["messages"] URL doesn't use SSL: http://assets.example.com/b34343443egerg.json
---- FOUND: A "templateurl" in ["messages"]["payload"] doesn't use SSL: http://my.server.com/?user={user.name}&zip={user.zip}&c16={%sdkver%}&c27=cln,{a.PrevSessionLength}
---- FOUND: A "templateurl" in ["messages"]["payload"] doesn't use SSL: http://my.43434server.com/?user={user.name}&zip={user.zip}&c16={%sdkver%}&c27=cln,{a.PrevSessionLength}
Done!

Display installed version:

user@localhost:~/$ truegaze version
Current version: v0.2

Online scans

Most of the scans are run offline and do not need access to the Internet. In order to run the scans that require online access, use the "--online" option. Please use legally.

Development Information

Structure

The application is command line and will consist of several modules that check for various vulnerabilities. Each module does its own scanning, and all results get printed to command line.

Reporting bugs and feature requests

Please use the GitHub issue tracker to report issues or suggest features: https://github.com/nightwatchcybersecurity/truegaze

You can also send emai to research /at/ nightwatchcybersecurity [dot] com

Wishlist

  • More unit test coverage for code that interacts with Click
  • Ability to extract additional files from online source
  • Ability to check if a particular vulnerability is exploitable
  • Ability to produce JSON or XML output that can feed into other tools
  • More modules!

About the name

"True Gaze" or "Истинное Зрение" is a magical spell that reveals the invisible (from the book "Last Watch" by Sergei Lukyanenko)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

truegaze-0.1.6.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

truegaze-0.1.6-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

Details for the file truegaze-0.1.6.tar.gz.

File metadata

  • Download URL: truegaze-0.1.6.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.4

File hashes

Hashes for truegaze-0.1.6.tar.gz
Algorithm Hash digest
SHA256 25f6dca6870fa1aa4d08b6d4e1981a70ec103ae343ceb66bd83302b1a62947ef
MD5 3948c9348b01c1a609284a45a6a58314
BLAKE2b-256 e438db028c4b3d91676613ee038abcba10049a41346e2b4e2c6f8d9516676951

See more details on using hashes here.

File details

Details for the file truegaze-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: truegaze-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 19.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.4

File hashes

Hashes for truegaze-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 1bff3e363025d62ad3f3231cd239ba09883aae8a4c1bfb5ef79b3eb75714dbb7
MD5 cd6b0b55af388add07636ccbb805a500
BLAKE2b-256 919313df3905dd9ae315f4156c64390326c42e6d30822d407894ea1c7fe12553

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page