# httptoolkit/frida-interception-and-unpinning architecture

> Architecture diagram of the GitHub repository httptoolkit/frida-interception-and-unpinning, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/httptoolkit/frida-interception-and-unpinning
- Repository: https://github.com/httptoolkit/frida-interception-and-unpinning

## Overview

This repository provides Frida scripts for intercepting mobile-app HTTPS traffic through a configured MitM proxy. The principal workflow is to configure the proxy and CA, inject the scripts into a target app, redirect its connections, and make its TLS checks accept the CA; platform-specific scripts also bypass pinning and device-integrity checks. The graph preserves Android and iOS branches and the native TLS layer. Relationships for unsampled scripts are included only where the README documents the capability or launch workflow.

Main entry points: [`config.js`](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/config.js) (Proxy and CA config), [`android/android-certificate-unpinning.js`](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-certificate-unpinning.js) (Android pinning bypass), [`android/android-certificate-unpinning-fallback.js`](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-certificate-unpinning-fallback.js) (Pinning fallback), [`android/android-proxy-override.js`](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-proxy-override.js) (Android proxy settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Configuration"]
  node_config["Proxy and CA config<br/>[config.js]"]
end

subgraph group_routing["Traffic routing"]
  node_android_proxy["Android proxy settings"]
  node_native_connect["Native socket redirect"]
  node_ios_connect["iOS Network redirect"]
end

subgraph group_trust["TLS trust"]
  node_cert_injection["Android system CA"]
  node_native_tls["Native TLS trust<br/>[native-tls-hook.js]"]
end

subgraph group_bypass["App protections"]
  node_android_unpin["Android pinning bypass"]
  node_flutter_unpin["Flutter pinning bypass"]
  node_fallback_unpin["Pinning fallback"]
  node_android_root["Android root bypass"]
  node_ios_detection["iOS jailbreak bypass"]
end

node_operator(("Operator"))
node_frida["Frida runtime"]
node_target["Mobile app"]
node_proxy["MitM proxy"]

node_operator -->|"sets values"| node_config
node_operator -->|"launches scripts"| node_frida
node_frida -->|"loads first"| node_config
node_frida -->|"injects into"| node_target
node_config -->|"configures"| node_android_proxy
node_config -->|"configures"| node_native_connect
node_config -->|"configures"| node_ios_connect
node_config -->|"provides CA"| node_cert_injection
node_config -->|"provides CA"| node_native_tls
node_config -->|"provides CA"| node_android_unpin
node_config -->|"provides CA"| node_flutter_unpin
node_android_proxy -->|"sets proxy"| node_proxy
node_native_connect -->|"redirects sockets"| node_proxy
node_ios_connect -->|"redirects connections"| node_proxy
node_cert_injection -->|"adds trusted CA"| node_target
node_native_tls -->|"overrides TLS checks"| node_target
node_android_unpin -->|"patches pinning"| node_target
node_flutter_unpin -->|"patches Flutter TLS"| node_target
node_fallback_unpin -->|"patches failures"| node_target
node_fallback_unpin -->|"uses helpers"| node_android_unpin
node_android_root -->|"bypasses root checks"| node_target
node_ios_detection -->|"bypasses jailbreak checks"| node_target

click node_config "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/config.js"
click node_android_proxy "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-proxy-override.js"
click node_native_connect "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/native-connect-hook.js"
click node_ios_connect "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/ios/ios-connect-hook.js"
click node_cert_injection "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-system-certificate-injection.js"
click node_native_tls "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/native-tls-hook.js"
click node_android_unpin "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-certificate-unpinning.js"
click node_flutter_unpin "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-disable-flutter-certificate-pinning.js"
click node_fallback_unpin "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-certificate-unpinning-fallback.js"
click node_android_root "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-disable-root-detection.js"
click node_ios_detection "https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/ios/ios-disable-detection.js"

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_config toneBlue
class node_android_proxy,node_native_connect,node_ios_connect toneAmber
class node_cert_injection,node_native_tls toneMint
class node_android_unpin,node_flutter_unpin,node_fallback_unpin,node_android_root,node_ios_detection toneRose
class node_operator,node_frida,node_target,node_proxy toneIndigo
```

## Components

### Configuration

- [Proxy and CA config](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/config.js): `config.js`

### Traffic routing

- [Android proxy settings](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-proxy-override.js): `android/android-proxy-override.js`
- [Native socket redirect](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/native-connect-hook.js): `native-connect-hook.js`
- [iOS Network redirect](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/ios/ios-connect-hook.js): `ios/ios-connect-hook.js`

### TLS trust

- [Android system CA](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-system-certificate-injection.js): `android/android-system-certificate-injection.js`
- [Native TLS trust](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/native-tls-hook.js): `native-tls-hook.js`

### App protections

- [Android pinning bypass](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-certificate-unpinning.js): `android/android-certificate-unpinning.js`
- [Flutter pinning bypass](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-disable-flutter-certificate-pinning.js): `android/android-disable-flutter-certificate-pinning.js`
- [Pinning fallback](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-certificate-unpinning-fallback.js): `android/android-certificate-unpinning-fallback.js`
- [Android root bypass](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/android/android-disable-root-detection.js): `android/android-disable-root-detection.js`
- [iOS jailbreak bypass](https://github.com/httptoolkit/frida-interception-and-unpinning/blob/main/ios/ios-disable-detection.js): `ios/ios-disable-detection.js`

### Other components

- **Operator**
- **Frida runtime**
- **Mobile app**
- **MitM proxy**

## Connections

- Operator → Proxy and CA config: sets values (evidence: `README.md`)
- Operator → Frida runtime: launches scripts (evidence: `README.md`)
- Frida runtime → Proxy and CA config: loads first (evidence: `README.md`)
- Frida runtime → Mobile app: injects into (evidence: `README.md`)
- Proxy and CA config → Android proxy settings: configures (evidence: `README.md`)
- Proxy and CA config → Native socket redirect: configures (evidence: `config.js`)
- Proxy and CA config → iOS Network redirect: configures (evidence: `README.md`)
- Proxy and CA config → Android system CA: provides CA (evidence: `config.js`)
- Proxy and CA config → Native TLS trust: provides CA (evidence: `config.js`)
- Proxy and CA config → Android pinning bypass: provides CA (evidence: `README.md`)
- Proxy and CA config → Flutter pinning bypass: provides CA (evidence: `README.md`)
- Android proxy settings → MitM proxy: sets proxy (evidence: `README.md`)
- Native socket redirect → MitM proxy: redirects sockets (evidence: `native-connect-hook.js`)
- iOS Network redirect → MitM proxy: redirects connections (evidence: `ios/ios-connect-hook.js`)
- Android system CA → Mobile app: adds trusted CA (evidence: `android/android-system-certificate-injection.js`)
- Native TLS trust → Mobile app: overrides TLS checks (evidence: `native-tls-hook.js`)
- Android pinning bypass → Mobile app: patches pinning (evidence: `android/android-certificate-unpinning.js`)
- Flutter pinning bypass → Mobile app: patches Flutter TLS (evidence: `android/android-disable-flutter-certificate-pinning.js`)
- Pinning fallback → Mobile app: patches failures (evidence: `android/android-certificate-unpinning-fallback.js`)
- Pinning fallback → Android pinning bypass: uses helpers (evidence: `android/android-certificate-unpinning-fallback.js`)
- Android root bypass → Mobile app: bypasses root checks (evidence: `android/android-disable-root-detection.js`)
- iOS jailbreak bypass → Mobile app: bypasses jailbreak checks (evidence: `ios/ios-disable-detection.js`)
