GRIEviOS

Usage

Requirements

• Python 3.10+
• Appium v2
• Appium XCUITest Driver
• Appium Real Device Setup
• ideviceinstaller for App installation on devices
• Optional: libimobiledevice for idevice_id and ideviceinfo. Used for discovery of connected iOS devices.
• Optional: tcpdump for use of the TcpDump-Analyzer.
• Optional: mitmproxy for use of the MitmDump-Analyzer. Requires a jailbroken device and disabled TLS certificate verification for effective use.

Installation

The GRIEviOS webinterface is available at http://localhost:8000.

pipx

pipx can be used to install GRIEviOS and its dependencies in an isolated environment:

# Install in isolated pipx environment
pipx install grievios
# Run server
grievios

Poetry

Poetry is recommended to install and run GRIEviOS and its dependencies when using the source code:

# Install dependencies
poetry install
# Run using Poetry environment
poetry run grievios

Configuration

By default, GRIEviOS stores its database and logs in $HOME/.grievios. This path can be configured using the environment variable GRIEVIOS_DIR.

Usage

Application Files

GRIEviOS checks for .ipa iOS Application Archive files in the directory $GRIEVIOS_DIR/IPAs.

Logs and Analyzer files

GRIEviOS logs and files generated by analyzers are stored in $GRIEVIOS_DIR/logs/exploration-<exploration-id>.