Mobile Devices

Mobile Devices

Solpuga can intercept traffic from iOS and Android devices and emulators. Each has a dedicated setup wizard accessible from the SSL Certificate menu.

iOS Simulator (macOS only)

SSL Certificate → Install certificate on iOS Simulator

The wizard has four steps:

  1. Install root CA — installs the certificate into the macOS system keychain (if not already done).
  2. Push to simulator — installs the certificate into each booted simulator's trust store via xcrun simctl keychain.
  3. Reboot — reboots the simulator(s) to apply trust settings.
  4. Enable SSL trust (optional) — if HTTPS traffic still isn't captured, manually enable trust in the simulator: Settings → General → About → Certificate Trust Settings.

A Test Connection button opens a test page in the simulator to verify interception.

Requirements: Xcode Command Line Tools.

iOS Device (macOS only)

SSL Certificate → Install certificate on iOS Device

  1. Install root CA — installs the certificate into the macOS system keychain.
  2. Deliver certificate — transfer the profile to your device:
    • QR / Browser — scan the QR code with your device's camera (proxy must be running). The device downloads the profile from http://solpuga.proxy/ssl.
    • AirDrop — send the certificate file directly to the device.
  3. Install profile — on the device, go to Settings → tap the "Profile Downloaded" banner → Install.
  4. Enable full trust — Settings → General → About → Certificate Trust Settings → enable the Solpuga CA toggle.
  5. Configure Wi-Fi proxy — on your device: Settings → Wi-Fi → tap (i) on your network → Configure Proxy → Manual. Enter the computer's IP and port 7070.

Disable VPN on both your Mac and iOS device before configuring the proxy.

Removing the Profile

Settings → General → VPN & Device Management → Solpuga profile → Remove Profile.

Android Emulator (all platforms)

SSL Certificate → Install certificate on Android Emulator

  1. Install root CA — generates and stores the certificate.
  2. Push to emulator — pushes the certificate to /system/etc/security/cacerts/ via adb push (requires writable system partition).
  3. Configure proxy — sets the Android global HTTP proxy to 10.0.2.2:7070 (the emulator-to-host gateway).
  4. Apply settings — restart running apps.

A Test Connection button verifies interception. When done, use the Revert Configuration section to clear the proxy and remove the certificate.

Requirements: Android SDK, ADB.

Google Play images are not supported (system partition is read-only). Certificate may reset on emulator reboot — re-run the installer.

Android Device (all platforms)

SSL Certificate → Install certificate on Android Device

Two modes: USB (ADB) and Wi-Fi (QR).

USB Mode

  1. Install root CA — generates and stores the certificate.
  2. Detect device — connect via USB with USB Debugging enabled. Solpuga detects the device and checks root status.
  3. Configure proxy — set the Wi-Fi proxy manually on the device: Settings → Network → tap your network → Modify → Advanced → Proxy → Manual. Enter the computer's IP and port 7070. Alternatively, for USB, use ADB to set the global proxy.
  4. Install certificate:
    • Rooted device — certificate is pushed directly to /system/etc/security/cacerts/. Trusted by all apps including those targeting API 24+. Device reboots.
    • Non-rooted device — certificate is pushed as a user certificate via adb push + install intent. Must be confirmed on the device. Note: Chrome ignores user CAs on Android 7+ — use Firefox, or root for system-level trust.
  5. Verify — opens a test HTTPS page on the device to confirm interception.

Wi-Fi Mode

No USB needed. Phone and computer must be on the same Wi-Fi network.

  1. Set the Wi-Fi proxy manually on the phone (Settings → Wi-Fi → long-press network → Modify → Proxy → Manual, enter IP and port).
  2. Scan the QR code to download and install the certificate.

Platform Notes

  • Linux: ADB may need udev rules for USB access.
  • Windows: may require Google USB Driver.

Removing Configuration

On the device: remove the proxy from Wi-Fi settings, then go to Settings → search "Trusted credentials" → remove the Solpuga CA from the User or System tab. Restart the device.