Skip to main content

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)

Release files for truegaze 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for truegaze 0.1.7
File Size Uploaded
truegaze-0.1.7.tar.gz 16.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for truegaze 0.1.7
File Interpreter ABI Platform
truegaze-0.1.7-py3-none-any.whl Python 3 none any Details

Total release size: 35.4 kB

Release files / truegaze-0.1.7.tar.gz

Download URL truegaze-0.1.7.tar.gz
Size 16.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3a263b9e0e1af48a632dc506b596549c4985f69496eefce3ea5833f9f8fc57b8
BLAKE2b-256 checksum
How to use checksums
01f8aec32268fa452fb6b1f067952029f84ca95592e179bf1a8ef6f9ddce550b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.24.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.9.0

Release files / truegaze-0.1.7-py3-none-any.whl

Download URL truegaze-0.1.7-py3-none-any.whl
Size 19.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9a8aab2ff0a786253732217932bbeb92e9756070786a7f90ded356a1c9a5df06
BLAKE2b-256 checksum
How to use checksums
c86f730a38dc98dd4a9dad644515700c29050c4672594def4d7f6f2f1bda28ae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.24.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.9.0

Release history Release notifications | RSS feed

This release

0.1.7 This release

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page