Charles Proxy — ce este, configurarea și interceptarea traficului HTTPS

Ce este Charles Proxy?

Charles Proxy — este un proxy HTTP și monitor HTTP care acționează ca intermediar între client și server. Toate cererile și răspunsurile trec prin Charles, permițând vizualizarea conținutului, analiza structurii, modificarea datelor în timp real și simularea diferitelor condiții de rețea. Disponibil pentru Windows, macOS și Linux.

Istoric și poziționare

Charles Proxy a fost creat în 2004 de Karl von Randow și rămâne unul dintre cele mai populare instrumente pentru depanarea traficului de rețea. Spre deosebire de alternativele gratuite, Charles oferă o licență plătită cu o perioadă de încercare de 30 de zile. Instrumentul este poziționat ca o soluție profesională pentru dezvoltatorii de aplicații mobile, web developeri și ingineri QA care au nevoie de control complet asupra comunicațiilor HTTP.

Compatibilitate cu platforme

Charles funcționează ca proxy de sistem pe computer și poate intercepta trafic de pe orice dispozitive din aceeași rețea: Android, iOS, simulatoare, emulatoare, browsere web și dispozitive IoT. Pentru interceptarea HTTPS, trebuie să instalați certificatul rădăcină Charles pe fiecare dispozitiv. Traficul este suportat pe HTTP/1.1 și HTTP/2 (parțial). HTTP/3 (QUIC) nu este suportat la nivelul de interceptare.

Cum funcționează Charles Proxy

Charles funcționează pe principiul proxy-ului MITM (Man-in-the-Middle): când un client trimite o cerere prin Charles, instrumentul interceptează această cerere, o redirecționează către serverul țintă, primește răspunsul și îl transmite înapoi clientului. Tot traficul trece prin Charles, permițând analiza și modificarea acestuia.

Arhitectura proxy-ului

La pornire, Charles creează un proxy HTTP local pe portul 8888 (implicit). Sistemul de operare sau aplicația este configurată să utilizeze acest proxy. Toate cererile HTTP sunt trimise mai întâi la Charles, care acționează apoi ca un client complet pentru serverul țintă. Pentru HTTPS, Charles utilizează propria tehnică de SSL-proxy: generează un certificat din mers pentru fiecare domeniu, semnat de certificatul rădăcină Charles. Dacă certificatul rădăcină este instalat ca de încredere pe dispozitiv, Charles poate decripta și vizualiza traficul HTTPS.

Moduri de funcționare

Charles suportă două moduri: Proxy (server proxy clasic) și SOCKS Proxy (pentru trafic UDP și TCP). Pentru dezvoltarea web, se utilizează proxy-ul HTTP standard. Pentru dispozitive mobile — configurarea WiFi Proxy pe dispozitiv cu specificarea adresei IP a computerului pe care rulează Charles. MacOS suportă configurarea automată a proxy-ului pentru simulatorul iOS.

<!-- Configurarea network_security_config.xml pentru Android cu suport Charles -->
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <debug-overrides>
        <trust-anchors>
            <!-- Aveți încredere în certificatul Charles în construcția Debug -->
            <certificates src="user" />
        </trust-anchors>
    </debug-overrides>
</network-security-config>

Caracteristici principale ale Charles Proxy

Charles Proxy oferă un set de instrumente profesionale pentru analiza și modificarea traficului, care depășește cu mult simpla interceptare a cererilor.

Rewrite și Breakpoints

Instrumentul Rewrite permite modificarea automată a anumitor părți ale cererilor sau răspunsurilor: antete, parametri URL, corpul răspunsului. De exemplu, puteți înlocui antetul User-Agent cu o valoare de pe alt dispozitiv sau elimina anumite cookie-uri. Breakpoints funcționează ca un debugger: cererea este oprită la etapa selectată (înainte de trimitere sau înainte de primire), iar dezvoltatorul poate modifica manual conținutul său înainte ca acesta să meargă mai departe. Acest lucru este util pentru testarea gestionării răspunsurilor eronate sau a stărilor non-standard.

Map Local și Map Remote

Map Local permite înlocuirea unei resurse de rețea (CSS, JS, JSON) cu un fișier local de pe disc. Acest lucru este indispensabil în dezvoltarea frontend: puteți modifica CSS/JS și vedea imediat rezultatul fără a implementa pe server. Map Remote redirecționează cererile de la un URL la altul — de exemplu, de la serverul de producție la staging pentru testare. Ambele instrumente funcționează pe baza modelelor de URL cu suport pentru wildcards.

Throttle și simularea condițiilor de rețea

Instrumentul Throttle permite simularea diferitelor tipuri de conexiuni de rețea pe baza profilelor prestabilite: 3G, EDGE, GPRS, DSL, WiFi. Puteți configura limite de viteză (download/upload), latență, pierdere de pachete și stabilitate. Acest lucru este critic pentru testarea comportamentului aplicației în condiții de conexiune lentă sau instabilă — gestionarea corectă a timeout-urilor, reîncercări, mod offline.

Auto Save și Recording

Charles poate salva automat sesiunile de trafic în fișiere .chls, permițând analiza ulterioară sau partajarea cu colegii. Recording Control permite configurarea flexibilă a traficului care trebuie salvat: pe domenii, tipuri de conținut, coduri de stare. Acest lucru este convenabil pentru monitorizarea pe termen lung a API-ului.

Configurarea Charles Proxy pentru dispozitive mobile

Pentru depanarea traficului aplicațiilor mobile, Charles este configurat ca WiFi Proxy: toate dispozitivele din aceeași rețea cu computerul pot direcționa traficul prin Charles. Configurarea corectă HTTPS necesită instalarea certificatului Charles pe dispozitivul mobil.

Configurare pe Android

Pentru Android: deschideți Settings → WiFi → Advanced → Proxy, selectați Manual și introduceți adresa IP a computerului cu portul 8888. Apoi deschideți browserul pe dispozitiv și accesați http://chls.pro/ssl pentru a descărca certificatul Charles. Pe Android 7+ (API 24+), este necesar network_security_config.xml pentru a avea încredere în certificatele de utilizator în build-ul Debug — altfel, aplicația poate să nu direcționeze traficul prin Charles.

Configurare pe iOS

Pentru iOS: Settings → WiFi → configurați proxy-ul pe IP și portul 8888. Apoi Safari → http://chls.pro/ssl → instalați profilul de certificat. Pe iOS 10.3+, trebuie să activați încrederea în certificat: Settings → General → About → Certificate Trust Settings → activați Charles Proxy. iOS este mai strict cu certificatele: unele aplicații pot utiliza SSL Pinning, blocând traficul prin Charles chiar și cu un certificat de încredere.

Rezolvarea problemelor cu SSL Pinning

Dacă aplicația utilizează SSL Pinning (fixarea certificatului serverului), proxy-ul standard prin Charles nu va funcționa — aplicația va respinge certificatul Charles. Soluții: dezactivați SSL Pinning în build-ul Debug prin setările OkHttp sau URLSession, utilizați Frida pentru a ocoli pinning-ul în runtime, sau folosiți Android Emulator cu acces root.

Scenarii practice de utilizare a Charles Proxy

Charles Proxy rezolvă sarcini specifice de dezvoltare și testare. Să analizăm cele mai frecvente scenarii în care instrumentul este indispensabil.

Depanarea integrării API

Cel mai frecvent scenariu — verificarea corectitudinii cererilor API. Charles arată URL-ul exact al cererii, antetele, corpul, parametrii. Dacă serverul returnează un răspuns neașteptat, sunt imediat vizibile: structura JSON, codul de eroare, antetele răspunsului. Acest lucru permite distingerea erorilor de pe client de erorile de pe server fără loguri din ambele părți.

Testarea cu conexiune lentă

Folosind profilele Throttle, puteți testa cum se comportă aplicația la viteză mică de conexiune: dacă este afișat indicatorul de încărcare, dacă timeout-ul este gestionat corect, dacă UI se blochează la pierderea conexiunii. Testarea cache-ului este deosebit de importantă — dacă datele sunt deja încărcate, aplicația ar trebui să le arate din cache, nu să intre în încărcare infinită.

Editarea răspunsurilor serverului

Cu ajutorul Breakpoints, puteți modifica răspunsul serverului înainte ca acesta să fie trimis aplicației. De exemplu, returnați un array gol în loc de date, schimbați codul de stare la 500, adăugați un câmp nou în JSON. Acest lucru permite testarea gestionării cazurilor limită fără modificarea codului serverului — una dintre cele mai puternice aplicații ale Charles în dezvoltarea mobilă.