Proxyman: wat is het, installatie en mogelijkheden voor verkeersdebugging

Wat is Proxyman?

Proxyman is een HTTP/HTTPS proxy-client die speciaal is gemaakt voor het Apple-ecosysteem. In tegenstelling tot cross-platform oplossingen maakt Proxyman gebruik van native macOS-frameworks (Swift, AppKit), wat zorgt voor hoge prestaties en naadloze integratie met de systeemproxymechanismen. Het hulpmiddel ondersteunt macOS 11+ en iOS 14+.

Marktpositionering

Proxyman positioneert zich als een modern alternatief voor Charles Proxy voor ontwikkelaars in het Apple-ecosysteem. Belangrijkste voordelen: gratis versie met volledige basisfunctionaliteit, native interface die aansluit bij het macOS-ontwerpsysteem, automatische configuratie voor de iOS-simulator zonder extra handelingen. Proxyman wordt sinds 2018 actief ontwikkeld en heeft een open feedbacksysteem met de ontwikkelaarsgemeenschap.

Ondersteunde platforms

Proxyman werkt op macOS (native applicatie, niet Electron) en biedt een hulptoepassing voor iOS. Fysieke apparaten (iPhone, iPad) worden via WiFi Proxy geconfigureerd, vergelijkbaar met Charles. De app voor iOS (Proxyman iOS companion) maakt het mogelijk verkeer direct op het apparaat te bekijken zonder computer — deze functie is uniek voor Proxyman.

Hoe werkt Proxyman

Proxyman werkt volgens het standaard MITM-principe: de applicatie wordt geconfigureerd als een systeemproxy waar al het HTTP/HTTPS-verkeer doorheen gaat. Het hulpmiddel gebruikt native macOS Network Extension-mechanismen om verkeer te onderscheppen zonder handmatige proxyconfiguratie voor de iOS-simulator.

Onderscheppingmechanisme op macOS

Op macOS gebruikt Proxyman Apple Network Framework voor transparante verkeersonderschepping. Bij activering van de proxy creëert Proxyman een virtuele netwerkinterface waar het verkeer van alle applicaties doorheen gaat. Voor de iOS-simulator vindt configuratie automatisch plaats bij het opstarten — Proxyman detecteert via Xcode actieve simulatoren en stuurt hun verkeer door zonder handmatige proxy-instelling in de configuratie.

Verwerking van HTTPS-verkeer

Voor HTTPS-ontsleuteling installeert Proxyman een lokaal rootcertificaat in de macOS-systeemsleutelbos. Bij de eerste start biedt het programma aan het certificaat te installeren en erop te vertrouwen. Alle certificaten voor specifieke domeinen worden ter plekke gegenereerd en ondertekend met het rootcertificaat van Proxyman. Voor de iOS-simulator wordt het certificaat automatisch geïnstalleerd bij het starten van de proxy.

// Voorbeeldscript Proxyman voor het wijzigen van antwoorden
// Scripting: verander de antwoordstatus naar 500 voor het testen van fouten
function onResponse(request, response) {
    if (request.url.includes("/api/users")) {
        response.statusCode = 500;
        response.body = JSON.stringify({
            error: "Internal Server Error",
            code: "SERVER_TIMEOUT"
        });
    }
    return response;
}

Belangrijkste functies van Proxyman

Proxyman biedt een unieke set functies die het onderscheiden van andere proxy-hulpmiddelen. Speciale nadruk ligt op scriptmatige verkeerswijziging en native prestaties.

Scripting — wijziging via JavaScript

Het belangrijkste kenmerk van Proxyman — ondersteuning voor JavaScript-scripts voor het wijzigen van verzoeken en antwoorden. In plaats van elk verzoek handmatig te bewerken via Breakpoints (zoals in Charles), kan de ontwikkelaar een script schrijven dat automatisch wordt toegepast op specifieke URL's. Scripts hebben volledige toegang tot headers, de verzoek- en antwoordbody, statuscode en metadata. Dit maakt automatisering van routinematige handelingen mogelijk: vervangen van autorisatietoken, wijzigen van headers, simuleren van fouten voor testen.

Filteren en organiseren van verkeer

Proxyman biedt een flexibel filtersysteem op basis van regels. U kunt profielen maken die verkeer automatisch groeperen op domein, inhoudstype of statuscode. Bijvoorbeeld, alle verzoeken aan de API van uw applicatie komen automatisch in een aparte groep, en statische content (CSS, JS, afbeeldingen) in een andere. Dit is vooral handig bij debuggen wanneer u zich alleen op specifieke endpoints wilt concentreren.

Visualisatie van de tijdlijn

Proxyman toont een tijdlijn van verzoeken in de stijl van een tijdsdiagram, waarbij elk verzoek wordt weergegeven als een gekleurde balk met informatie over duur, status en grootte. De tijdlijn is interactief: u kunt een tijdsbereik selecteren en alleen de verzoeken uit die periode bekijken. Voor elk verzoek is een fase-uitsplitsing beschikbaar: DNS, Connect, TLS Handshake, Request, Response.

Proxyman iOS Companion

Een unieke mogelijkheid van Proxyman — een aparte app voor iOS die op iPhone of iPad kan worden geïnstalleerd. Hiermee kunt u netwerkverkeer direct op het apparaat bekijken zonder verbinding met een computer. Verkeer wordt in realtime weergegeven met filter- en zoekmogelijkheden. De app is vooral handig bij veldtesten wanneer er geen toegang tot een computer is.

Proxyman instellen voor mobiele apparaten

Proxyman biedt verschillende manieren van instellen voor iOS en Android. Dankzij native integratie met Xcode verloopt de configuratie voor de iOS-simulator vrijwel automatisch. Voor fysieke apparaten en Android is handmatige configuratie vereist.

Instellen voor iOS Simulator

Het eenvoudigste scenario: start Proxyman, open het tabblad iOS Simulator en klik op Start. Proxyman detecteert automatisch actieve simulatoren via Xcode en configureert de proxy. Het HTTPS-certificaat wordt ook automatisch geïnstalleerd. Er zijn geen extra handelingen nodig — het verkeer van de simulator verschijnt onmiddellijk in het Proxyman-venster. Dit is een aanzienlijk voordeel ten opzichte van Charles, waar het instellen van de simulator handmatige proxyconfiguratie vereist.

Instellen voor een fysiek iOS-apparaat

Voor iPhone of iPad: verbind het apparaat met hetzelfde WiFi-netwerk als de computer. Geef in de WiFi-instellingen van het apparaat HTTP Proxy op: het IP-adres van de computer en poort 9090 (de standaardpoort van Proxyman). Open vervolgens Safari en ga naar http://proxy.man/ssl om het certificaat te installeren. Schakel op iOS 10.3+ het vertrouwen in het certificaat in via Settings → General → About → Certificate Trust Settings.

Instellen voor Android

Android-apparaten worden vergelijkbaar met iOS ingesteld: WiFi Proxy met het IP-adres van de computer en poort 9090. Voor HTTPS is installatie van het certificaat via de browser op http://proxy.man/ssl vereist. Op Android 7+ is voor een debug-build van de applicatie een network_security_config.xml-bestand nodig met vertrouwen in gebruikerscertificaten. Gebruik voor de Android-emulator het IP-adres van de host (meestal 10.0.2.2) in plaats van het IP van de computer.

<!-- network_security_config.xml voor Android met Proxyman -->
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <debug-overrides>
        <trust-anchors>
            <certificates src="user" />
            <certificates src="system" />
        </trust-anchors>
    </debug-overrides>
    <base-config cleartextTrafficPermitted="false">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

Proxyman vs Charles Proxy: vergelijking

De keuze tussen Proxyman en Charles Proxy hangt af van de specifieke behoeften van het team en het ontwikkelplatform. Laten we de belangrijkste verschillen bekijken om de ontwikkelaar te helpen een weloverwogen beslissing te nemen.

Prestaties en native karakter

Proxyman is geschreven in Swift met AppKit, wat zorgt voor native macOS-prestaties en minimaal geheugengebruik. Charles is geschreven in Java (Eclipse RCP), wat cross-platform werking biedt, maar kan leiden tot iets hoger geheugengebruik en een niet-native interface op macOS. Voor ontwikkelaars in het Apple-ecosysteem voelt Proxyman doorgaans responsiever aan.

Functionele verschillen

Charles biedt een volwassener en breder scala aan hulpmiddelen: Rewrite Rules met een visuele editor, Repeat voor het herhalen van verzoeken, Map Local/Remote, Auto Save van sessies. Proxyman antwoordt met modernere functies: Scripting in JavaScript, automatische simulatorconfiguratie, iOS-companion voor het bekijken van verkeer op het apparaat. Charles heeft voordeel bij complexe automatiseringsscenario's (Rewrite, Repeat), en Proxyman — bij snelle en flexibele wijziging via scripts.

Kosten en licentiëring

Proxyman biedt een gratis versie met basisfunctionaliteit zonder tijdsbeperking. De Pro-versie (abonnement ~$12/jaar of eenmalige aankoop ~$59) ontgrendelt geavanceerde functies: scripting, filters, export. Charles — $50 voor een licentie met een 30-dagen trial. Voor onafhankelijke ontwikkelaars is Proxyman betaalbaarder; voor bedrijfsomgevingen is het verschil verwaarloosbaar.