# khanh8249/fortiva architecture

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

- Interactive diagram: https://gitdiagram.com/khanh8249/fortiva
- Repository: https://github.com/khanh8249/fortiva

## Overview

Fortiva is a Rust iOS sideloading tool for Linux and Termux. Its main user journey is to log in, choose an IPA, then prepare Apple developer assets, sign the app and extensions, and install over USB; it also supports signing separately and SideStore pairing. The graph preserves authentication, developer-account management, signing, and device workflows. Several links reflect README-documented behavior or SOURCE INDEX references; unsampled implementations are represented at their exact paths, with uncertain relationships omitted.

Main entry points: [`src/sideload/auto.rs`](https://github.com/khanh8249/fortiva/blob/main/src/sideload/auto.rs) (Auto sign/install), [`src/auth/anisette.rs`](https://github.com/khanh8249/fortiva/blob/main/src/auth/anisette.rs) (Anisette client), [`src/dev/client.rs`](https://github.com/khanh8249/fortiva/blob/main/src/dev/client.rs) (Developer API client), [`src/main.rs`](https://github.com/khanh8249/fortiva/blob/main/src/main.rs) (CLI menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_menu["CLI menu<br/>[main.rs]"]
end

subgraph group_auth["Apple authentication"]
  node_authflow["Apple login<br/>[flow.rs]"]
  node_gsa["GSA client<br/>[gsa.rs]"]
  node_anisette["Anisette client<br/>[anisette.rs]"]
  node_twofa["Two-factor auth<br/>[mod.rs]"]
  node_session[("Session storage<br/>[mod.rs]")]
  node_cache[("Anisette cache<br/>[mod.rs]")]
  node_config["Anisette config<br/>[mod.rs]"]
end

subgraph group_developer["Developer services"]
  node_devclient["Developer API client<br/>[client.rs]"]
  node_cert["Certificate management<br/>[certificate.rs]"]
  node_appids["App ID management<br/>[app_ids.rs]"]
  node_appgroups["App Group management<br/>[app_groups.rs]"]
  node_devdevice["Device registration<br/>[devices.rs]"]
end

subgraph group_sideload["IPA signing"]
  node_auto["Auto sign/install<br/>[auto.rs]"]
  node_ipa["IPA application parser<br/>[application.rs]"]
  node_bundle["Bundle inspection<br/>[bundle.rs]"]
  node_identity["Certificate identity<br/>[cert_identity.rs]"]
  node_signer["Code signing<br/>[signer.rs]"]
  node_repack["IPA repacking<br/>[repack.rs]"]
end

subgraph group_device["Device workflows"]
  node_installer["Device installer<br/>[installer.rs]"]
  node_usb["USB device access<br/>[mod.rs]"]
  node_pairing["SideStore pairing"]
end

node_user(("Fortiva user"))
node_iphone(("iPhone"))
node_apple["Apple services"]

node_user -->|"selects commands"| node_menu
node_menu -->|"starts login"| node_authflow
node_menu -->|"starts workflow"| node_auto
node_authflow -->|"performs SRP"| node_gsa
node_authflow -->|"handles 2FA"| node_twofa
node_gsa -->|"uses headers"| node_anisette
node_twofa -->|"fetches headers"| node_anisette
node_anisette -->|"reads cache"| node_cache
node_anisette -->|"loads endpoint"| node_config
node_authflow -.->|"persists session"| node_session
node_devclient -->|"builds auth headers"| node_anisette
node_devclient -->|"sends API requests"| node_apple
node_cert -->|"uses API client"| node_devclient
node_appids -->|"uses API client"| node_devclient
node_appids -->|"uses group data"| node_appgroups
node_auto -->|"manages developer assets"| node_devclient
node_auto -->|"processes IPA"| node_ipa
node_auto -->|"prepares certificate"| node_identity
node_ipa -->|"inspects bundle"| node_bundle
node_ipa -->|"uses certificate identity"| node_identity
node_auto -->|"signs app"| node_signer
node_signer -->|"signs application"| node_ipa
node_auto -->|"accesses device"| node_usb
node_auto -->|"installs signed app"| node_installer
node_installer -->|"installs app"| node_iphone
node_usb -->|"detects device"| node_iphone
node_menu -->|"starts pairing setup"| node_pairing
node_pairing -->|"writes pairing file"| node_iphone
node_installer -->|"uses repacking"| node_repack
node_auto -->|"registers app IDs"| node_appids
node_auto -->|"creates certificate"| node_cert
node_auto -.->|"registers device"| node_devdevice

click node_menu "https://github.com/khanh8249/fortiva/blob/main/src/main.rs"
click node_auto "https://github.com/khanh8249/fortiva/blob/main/src/sideload/auto.rs"
click node_authflow "https://github.com/khanh8249/fortiva/blob/main/src/auth/srp/flow.rs"
click node_gsa "https://github.com/khanh8249/fortiva/blob/main/src/auth/gsa.rs"
click node_anisette "https://github.com/khanh8249/fortiva/blob/main/src/auth/anisette.rs"
click node_twofa "https://github.com/khanh8249/fortiva/blob/main/src/auth/twofa/mod.rs"
click node_session "https://github.com/khanh8249/fortiva/blob/main/src/session/mod.rs"
click node_cache "https://github.com/khanh8249/fortiva/blob/main/src/cache/mod.rs"
click node_config "https://github.com/khanh8249/fortiva/blob/main/src/config/mod.rs"
click node_devclient "https://github.com/khanh8249/fortiva/blob/main/src/dev/client.rs"
click node_cert "https://github.com/khanh8249/fortiva/blob/main/src/dev/certificate.rs"
click node_appids "https://github.com/khanh8249/fortiva/blob/main/src/dev/app_ids.rs"
click node_appgroups "https://github.com/khanh8249/fortiva/blob/main/src/dev/app_groups.rs"
click node_devdevice "https://github.com/khanh8249/fortiva/blob/main/src/dev/devices.rs"
click node_ipa "https://github.com/khanh8249/fortiva/blob/main/src/sideload/application.rs"
click node_bundle "https://github.com/khanh8249/fortiva/blob/main/src/sideload/bundle.rs"
click node_identity "https://github.com/khanh8249/fortiva/blob/main/src/sideload/cert_identity.rs"
click node_signer "https://github.com/khanh8249/fortiva/blob/main/src/sideload/signer.rs"
click node_repack "https://github.com/khanh8249/fortiva/blob/main/src/sideload/repack.rs"
click node_installer "https://github.com/khanh8249/fortiva/blob/main/src/install/installer.rs"
click node_usb "https://github.com/khanh8249/fortiva/blob/main/src/usb/mod.rs"
click node_pairing "https://github.com/khanh8249/fortiva/blob/main/src/tools/sidestore_pairing.rs"

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_menu,node_user toneBlue
class node_authflow,node_gsa,node_anisette,node_twofa,node_session,node_cache,node_config toneAmber
class node_devclient,node_cert,node_appids,node_appgroups,node_devdevice toneMint
class node_auto,node_ipa,node_bundle,node_identity,node_signer,node_repack toneRose
class node_installer,node_usb,node_pairing,node_iphone,node_apple toneIndigo
```

## Components

### User interaction

- [CLI menu](https://github.com/khanh8249/fortiva/blob/main/src/main.rs): `src/main.rs`

### Apple authentication

- [Apple login](https://github.com/khanh8249/fortiva/blob/main/src/auth/srp/flow.rs): `src/auth/srp/flow.rs`
- [GSA client](https://github.com/khanh8249/fortiva/blob/main/src/auth/gsa.rs): `src/auth/gsa.rs`
- [Anisette client](https://github.com/khanh8249/fortiva/blob/main/src/auth/anisette.rs): `src/auth/anisette.rs`
- [Two-factor auth](https://github.com/khanh8249/fortiva/blob/main/src/auth/twofa/mod.rs): `src/auth/twofa/mod.rs`
- [Session storage](https://github.com/khanh8249/fortiva/blob/main/src/session/mod.rs): `src/session/mod.rs`
- [Anisette cache](https://github.com/khanh8249/fortiva/blob/main/src/cache/mod.rs): `src/cache/mod.rs`
- [Anisette config](https://github.com/khanh8249/fortiva/blob/main/src/config/mod.rs): `src/config/mod.rs`

### Developer services

- [Developer API client](https://github.com/khanh8249/fortiva/blob/main/src/dev/client.rs): `src/dev/client.rs`
- [Certificate management](https://github.com/khanh8249/fortiva/blob/main/src/dev/certificate.rs): `src/dev/certificate.rs`
- [App ID management](https://github.com/khanh8249/fortiva/blob/main/src/dev/app_ids.rs): `src/dev/app_ids.rs`
- [App Group management](https://github.com/khanh8249/fortiva/blob/main/src/dev/app_groups.rs): `src/dev/app_groups.rs`
- [Device registration](https://github.com/khanh8249/fortiva/blob/main/src/dev/devices.rs): `src/dev/devices.rs`

### IPA signing

- [Auto sign/install](https://github.com/khanh8249/fortiva/blob/main/src/sideload/auto.rs): `src/sideload/auto.rs`
- [IPA application parser](https://github.com/khanh8249/fortiva/blob/main/src/sideload/application.rs): `src/sideload/application.rs`
- [Bundle inspection](https://github.com/khanh8249/fortiva/blob/main/src/sideload/bundle.rs): `src/sideload/bundle.rs`
- [Certificate identity](https://github.com/khanh8249/fortiva/blob/main/src/sideload/cert_identity.rs): `src/sideload/cert_identity.rs`
- [Code signing](https://github.com/khanh8249/fortiva/blob/main/src/sideload/signer.rs): `src/sideload/signer.rs`
- [IPA repacking](https://github.com/khanh8249/fortiva/blob/main/src/sideload/repack.rs): `src/sideload/repack.rs`

### Device workflows

- [Device installer](https://github.com/khanh8249/fortiva/blob/main/src/install/installer.rs): `src/install/installer.rs`
- [USB device access](https://github.com/khanh8249/fortiva/blob/main/src/usb/mod.rs): `src/usb/mod.rs`
- [SideStore pairing](https://github.com/khanh8249/fortiva/blob/main/src/tools/sidestore_pairing.rs): `src/tools/sidestore_pairing.rs`

### Other components

- **Fortiva user**
- **iPhone**
- **Apple services**

## Connections

- Fortiva user → CLI menu: selects commands (evidence: `README.md`)
- CLI menu → Apple login: starts login (evidence: `README.md`)
- CLI menu → Auto sign/install: starts workflow (evidence: `README.md`)
- Apple login → GSA client: performs SRP (evidence: `src/auth/srp/flow.rs`)
- Apple login → Two-factor auth: handles 2FA (evidence: `src/auth/srp/flow.rs`)
- GSA client → Anisette client: uses headers (evidence: `src/auth/gsa.rs`)
- Two-factor auth → Anisette client: fetches headers (evidence: `src/auth/twofa/mod.rs`)
- Anisette client → Anisette cache: reads cache (evidence: `src/auth/anisette.rs`)
- Anisette client → Anisette config: loads endpoint (evidence: `src/auth/anisette.rs`)
- Apple login → Session storage: persists session
- Developer API client → Anisette client: builds auth headers (evidence: `src/dev/client.rs`)
- Developer API client → Apple services: sends API requests (evidence: `src/dev/client.rs`)
- Certificate management → Developer API client: uses API client (evidence: `src/dev/certificate.rs`)
- App ID management → Developer API client: uses API client (evidence: `src/dev/app_ids.rs`)
- App ID management → App Group management: uses group data (evidence: `src/dev/app_ids.rs`)
- Auto sign/install → Developer API client: manages developer assets (evidence: `src/sideload/auto.rs`)
- Auto sign/install → IPA application parser: processes IPA (evidence: `src/sideload/auto.rs`)
- Auto sign/install → Certificate identity: prepares certificate (evidence: `src/sideload/auto.rs`)
- IPA application parser → Bundle inspection: inspects bundle (evidence: `src/sideload/application.rs`)
- IPA application parser → Certificate identity: uses certificate identity (evidence: `src/sideload/application.rs`)
- Auto sign/install → Code signing: signs app (evidence: `src/sideload/auto.rs`)
- Code signing → IPA application parser: signs application (evidence: `src/sideload/signer.rs`)
- Auto sign/install → USB device access: accesses device (evidence: `src/sideload/auto.rs`)
- Auto sign/install → Device installer: installs signed app (evidence: `README.md`)
- Device installer → iPhone: installs app (evidence: `README.md`)
- USB device access → iPhone: detects device (evidence: `src/usb/mod.rs`)
- CLI menu → SideStore pairing: starts pairing setup (evidence: `README.md`)
- SideStore pairing → iPhone: writes pairing file (evidence: `README.md`)
- Device installer → IPA repacking: uses repacking (evidence: `src/install/installer.rs`)
- Auto sign/install → App ID management: registers app IDs (evidence: `README.md`)
- Auto sign/install → Certificate management: creates certificate (evidence: `README.md`)
- Auto sign/install → Device registration: registers device
