# mobsf/mobile-security-framework-mobsf architecture

> Architecture diagram of the GitHub repository mobsf/mobile-security-framework-mobsf, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mobsf/mobile-security-framework-mobsf
- Repository: https://github.com/mobsf/mobile-security-framework-mobsf

## Overview

MobSF is a Django-based mobile security research platform for Android, iOS, and Windows applications. A researcher or CI client submits an application through web or API entry points; authorization and sample handling precede static or dynamic analysis. Static pipelines parse platform artifacts, run security and malware checks, and persist findings. Dynamic pipelines control devices or Corellium, inject Frida instrumentation, optionally observe traffic, and generate reports. Results are stored for later web/API retrieval. Some orchestration links are inferred from the repository structure because only selected source files were sampled.

Main entry points: [`mobsf/StaticAnalyzer/views/android/static_analyzer.py`](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/android/static_analyzer.py) (Static Orchestrator), [`mobsf/MobSF/views/scanning.py`](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/scanning.py) (Web Entry), [`mobsf/MobSF/views/api/api_static_analysis.py`](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/api/api_static_analysis.py) (API Entry), [`mobsf/DynamicAnalyzer/views/android/dynamic_analyzer.py`](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/android/dynamic_analyzer.py) (Android Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interface and Access"]
  node_web_entry["Web Entry<br/>[scanning.py]"]
  node_api_entry["API Entry"]
  node_authorization["Authorization<br/>[authorization.py]"]
end

subgraph group_static["Static Analysis"]
  node_static_orchestrator["Static Orchestrator<br/>[static_analyzer.py]"]
  node_android_parsing["Android Parsing<br/>[app.py]"]
  node_android_checks["Android Checks"]
  node_ios_analysis["iOS Analysis<br/>[static_analyzer.py]"]
  node_windows_analysis["Windows Analysis<br/>[windows.py]"]
  node_sast_engine["SAST Engine<br/>[sast_engine.py]"]
end

subgraph group_dynamic["Dynamic Analysis"]
  node_android_runtime["Android Runtime"]
  node_ios_runtime["iOS Runtime"]
  node_device_control["Device Control<br/>[device.py]"]
  node_frida_bridge["Frida Bridge<br/>[views.py]"]
  node_frida_scripts["Frida Scripts"]
  node_traffic_proxy["Traffic Proxy<br/>[webproxy.py]"]
end

subgraph group_security["Security Intelligence"]
  node_malware_checks["Malware Checks"]
end

subgraph group_persistence["Results and Storage"]
  node_sample_store[("Sample Store<br/>[models.py]")]
  node_analysis_reports["Analysis Reports<br/>[report.py]"]
  node_result_store[("Result Database<br/>[models.py]")]
end

node_researcher(("Security Researcher"))
node_ci_client(("CI API Client"))
node_external_reputation["Reputation Service"]

node_researcher -->|"submits sample"| node_web_entry
node_ci_client -->|"calls API"| node_api_entry
node_web_entry -->|"checks access"| node_authorization
node_api_entry -->|"checks access"| node_authorization
node_web_entry -->|"stores sample"| node_sample_store
node_api_entry -->|"stores sample"| node_sample_store
node_web_entry -->|"starts analysis"| node_static_orchestrator
node_api_entry -->|"starts analysis"| node_static_orchestrator
node_web_entry -->|"starts analysis"| node_android_runtime
node_api_entry -->|"starts analysis"| node_ios_runtime
node_static_orchestrator -->|"parses Android"| node_android_parsing
node_static_orchestrator -->|"analyzes iOS"| node_ios_analysis
node_static_orchestrator -->|"analyzes Windows"| node_windows_analysis
node_static_orchestrator -->|"runs SAST"| node_sast_engine
node_static_orchestrator -->|"runs checks"| node_android_checks
node_static_orchestrator -->|"runs malware checks"| node_malware_checks
node_android_runtime -->|"controls device"| node_device_control
node_ios_runtime -->|"controls device"| node_device_control
node_android_runtime -->|"starts instrumentation"| node_frida_bridge
node_ios_runtime -->|"starts instrumentation"| node_frida_bridge
node_frida_bridge -->|"dispatches scripts"| node_frida_scripts
node_android_runtime -.->|"captures traffic"| node_traffic_proxy
node_ios_runtime -.->|"captures traffic"| node_traffic_proxy
node_malware_checks -.->|"queries reputation"| node_external_reputation
node_static_orchestrator -->|"writes findings"| node_result_store
node_analysis_reports -->|"writes report"| node_result_store
node_web_entry -->|"reads results"| node_result_store
node_api_entry -->|"reads results"| node_result_store

click node_web_entry "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/scanning.py"
click node_api_entry "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/api/api_static_analysis.py"
click node_authorization "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/authorization.py"
click node_sample_store "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/models.py"
click node_static_orchestrator "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/android/static_analyzer.py"
click node_android_parsing "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/android/app.py"
click node_android_checks "https://github.com/mobsf/mobile-security-framework-mobsf/tree/master/mobsf/StaticAnalyzer/views/android"
click node_ios_analysis "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/ios/static_analyzer.py"
click node_windows_analysis "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/windows/windows.py"
click node_sast_engine "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/sast_engine.py"
click node_android_runtime "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/android/dynamic_analyzer.py"
click node_ios_runtime "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/ios/dynamic_analyzer.py"
click node_device_control "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/common/device.py"
click node_frida_bridge "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/common/frida/views.py"
click node_frida_scripts "https://github.com/mobsf/mobile-security-framework-mobsf/tree/master/mobsf/DynamicAnalyzer/tools/frida_scripts"
click node_traffic_proxy "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/tools/webproxy.py"
click node_malware_checks "https://github.com/mobsf/mobile-security-framework-mobsf/tree/master/mobsf/MalwareAnalyzer/views"
click node_analysis_reports "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/android/report.py"
click node_result_store "https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_entry,node_api_entry,node_authorization,node_ci_client toneBlue
class node_static_orchestrator,node_android_parsing,node_android_checks,node_ios_analysis,node_windows_analysis,node_sast_engine toneAmber
class node_android_runtime,node_ios_runtime,node_device_control,node_frida_bridge,node_frida_scripts,node_traffic_proxy toneMint
class node_malware_checks toneRose
class node_sample_store,node_analysis_reports,node_result_store,node_researcher,node_external_reputation toneIndigo
```

## Components

### Interface and Access

- [Web Entry](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/scanning.py): `mobsf/MobSF/views/scanning.py`
- [API Entry](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/api/api_static_analysis.py): `mobsf/MobSF/views/api/api_static_analysis.py`
- [Authorization](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/views/authorization.py): `mobsf/MobSF/views/authorization.py`

### Static Analysis

- [Static Orchestrator](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/android/static_analyzer.py): `mobsf/StaticAnalyzer/views/android/static_analyzer.py`
- [Android Parsing](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/android/app.py): `mobsf/StaticAnalyzer/views/android/app.py`
- [Android Checks](https://github.com/mobsf/mobile-security-framework-mobsf/tree/master/mobsf/StaticAnalyzer/views/android): `mobsf/StaticAnalyzer/views/android`
- [iOS Analysis](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/ios/static_analyzer.py): `mobsf/StaticAnalyzer/views/ios/static_analyzer.py`
- [Windows Analysis](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/windows/windows.py): `mobsf/StaticAnalyzer/views/windows/windows.py`
- [SAST Engine](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/StaticAnalyzer/views/sast_engine.py): `mobsf/StaticAnalyzer/views/sast_engine.py`

### Dynamic Analysis

- [Android Runtime](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/android/dynamic_analyzer.py): `mobsf/DynamicAnalyzer/views/android/dynamic_analyzer.py`
- [iOS Runtime](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/ios/dynamic_analyzer.py): `mobsf/DynamicAnalyzer/views/ios/dynamic_analyzer.py`
- [Device Control](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/common/device.py): `mobsf/DynamicAnalyzer/views/common/device.py`
- [Frida Bridge](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/common/frida/views.py): `mobsf/DynamicAnalyzer/views/common/frida/views.py`
- [Frida Scripts](https://github.com/mobsf/mobile-security-framework-mobsf/tree/master/mobsf/DynamicAnalyzer/tools/frida_scripts): `mobsf/DynamicAnalyzer/tools/frida_scripts`
- [Traffic Proxy](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/tools/webproxy.py): `mobsf/DynamicAnalyzer/tools/webproxy.py`

### Security Intelligence

- [Malware Checks](https://github.com/mobsf/mobile-security-framework-mobsf/tree/master/mobsf/MalwareAnalyzer/views): `mobsf/MalwareAnalyzer/views`

### Results and Storage

- [Sample Store](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/models.py): `mobsf/MobSF/models.py`
- [Analysis Reports](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/DynamicAnalyzer/views/android/report.py): `mobsf/DynamicAnalyzer/views/android/report.py`
- [Result Database](https://github.com/mobsf/mobile-security-framework-mobsf/blob/master/mobsf/MobSF/models.py): `mobsf/MobSF/models.py`

### Other components

- **Security Researcher**
- **CI API Client**
- **Reputation Service**

## Connections

- Security Researcher → Web Entry: submits sample
- CI API Client → API Entry: calls API
- Web Entry → Authorization: checks access
- API Entry → Authorization: checks access
- Web Entry → Sample Store: stores sample
- API Entry → Sample Store: stores sample
- Web Entry → Static Orchestrator: starts analysis
- API Entry → Static Orchestrator: starts analysis
- Web Entry → Android Runtime: starts analysis
- API Entry → iOS Runtime: starts analysis
- Static Orchestrator → Android Parsing: parses Android
- Static Orchestrator → iOS Analysis: analyzes iOS
- Static Orchestrator → Windows Analysis: analyzes Windows
- Static Orchestrator → SAST Engine: runs SAST
- Static Orchestrator → Android Checks: runs checks
- Static Orchestrator → Malware Checks: runs malware checks
- Android Runtime → Device Control: controls device
- iOS Runtime → Device Control: controls device
- Android Runtime → Frida Bridge: starts instrumentation
- iOS Runtime → Frida Bridge: starts instrumentation
- Frida Bridge → Frida Scripts: dispatches scripts
- Android Runtime → Traffic Proxy: captures traffic
- iOS Runtime → Traffic Proxy: captures traffic
- Malware Checks → Reputation Service: queries reputation
- Static Orchestrator → Result Database: writes findings
- Analysis Reports → Result Database: writes report
- Web Entry → Result Database: reads results
- API Entry → Result Database: reads results
