Charles Proxy ile Mobil Uygulama Hatası Ayıklama: Trafik Yakalama ve HTTP/HTTPS Analizi için Tam Kılavuz

```html

Uygulamayı başlatıyorsunuz ve o öngörülemez bir şekilde davranıyor: veriler yüklenmiyor, reklamlar gösterilmiyor, hesap görünür bir sebep olmadan yasaklanıyor. "Kaputun altında" neler olduğunu anlamak için uygulama ile sunucu arasındaki gerçek HTTP isteklerini görmeniz gerekiyor. İşte bu nedenle Charles Proxy var — mobil uygulamaların trafiğini gerçek zamanlı olarak yakalayıp analiz etmenizi ve değiştirebilmenizi sağlayan bir araç.

Bu kılavuzda, iOS ve Android için Charles Proxy'nin tam ayarlarını, HTTPS ile çalışma, sunucu yanıtlarını değiştirme ve dış proxy sunucuları ile entegrasyonu ele alacağız — tüm bunları gereksiz teori olmadan, sadece pratikle.

Charles Proxy nedir ve ne işe yarar

Charles Proxy, Windows, macOS ve Linux için bir masaüstü uygulamasıdır ve cihazınız (akıllı telefon, emülatör) ile internet arasında bir HTTP/HTTPS proxy olarak çalışır. Trafiği Charles üzerinden yönlendirdiğinizde, program tüm istekleri ve yanıtları kaydeder, böylece uygulamanın sunuculara gönderdiği her veri baytını görebilirsiniz.

Temelde, Charles, Chrome tarayıcısındaki Geliştirici Araçları'nın yaptığı şeyi yapar — sadece yerleşik bir denetleyiciye sahip olmayan mobil uygulamalar için. Bu, özellikle anlamanız gereken durumlarda önemlidir:

• Uygulamanın kimlik doğrulama veya hesap kaydı sırasında hangi parametreleri ilettiği
• Sunucuya giden hangi başlıkların (User-Agent, Device-ID, token'lar) olduğu
• Facebook, TikTok veya Instagram'ın girişte cihazı nasıl kontrol ettiği
• Uygulamanın belirli koşullar altında neden hata döndürdüğü
• Pazar yerinin fiyat veya katalog talep ederken hangi verileri ilettiği

Arabulucular için Charles Proxy, istihbarat aracı gibidir: Facebook Reklamlarının cihazdan topladığı parmak izi verilerini görebilir ve hesabın neden hemen yasaklandığını anlayabilirsiniz. SMM uzmanları, Instagram ve TikTok API'sini analiz etmek için Charles'ı kullanarak limitleri ve istek kalıplarını anlamaya çalışırlar. Geliştiriciler ve test uzmanları, sunucu yanıtlarını taklit etmek ve uygulamanın alışılmadık durumlarda nasıl davrandığını kontrol etmek için kullanır.

Charles Proxy'nin temel özellikleri:

• HTTP ve HTTPS trafiğinin yakalanması (TLS 1.3 dahil)
• İsteklerin ve yanıtların içeriğini kullanışlı bir formatta görüntüleme (JSON, XML, metin)
• Sunucu yanıtlarının değiştirilmesi (Rewrite, Map Local, Map Remote)
• İstekleri manuel olarak düzenlemek için duraklama noktaları (Breakpoints)
• Yavaş internet simülasyonu için bağlantıyı yavaşlatma
• Oturumların kaydedilmesi ve yeniden oynatılması
• Dış proxy desteği (HTTP, SOCKS5)

Charles Proxy'nin kurulumu ve ilk ayarları

Charles Proxy, 30 günlük deneme süresi ile ücretli bir uygulama olarak dağıtılmaktadır. Resmi web sitesinden charlesproxy.com indirilebilir. macOS, Windows ve Linux için sürüm işlevsellik açısından aynıdır.

Adım 1. Uygulamanın kurulumu

İşletim sisteminize uygun yükleyiciyi indirin, çalıştırın ve standart kurulum prosedürünü izleyin. Charles başlatıldığında, hemen bilgisayarınızdaki 8888 portunu dinlemeye başlar. Bu, cihazların trafiği yönlendireceği varsayılan porttur.

Adım 2. Bilgisayarın IP adresini kontrol etme

Mobil cihazın Charles'a bağlanabilmesi için, aynı Wi-Fi ağı içinde olması gerekir. Yerel ağınızdaki bilgisayarın IP adresini öğrenin:

• macOS: Sistem Ayarları → Ağ → Wi-Fi'yi seçin → IP adresi
• Windows: Komut İstemi → ipconfig → IPv4 adresi
• Charles içinde: Yardım → Yerel IP Adresi

Bu adresi aklınızda bulundurun — akıllı telefonda proxy ayarlarını yaparken gerekecek. Genellikle 192.168.1.X gibi bir şeydir.

Adım 3. Cihazlardan gelen bağlantılara izin verme

Mobil cihaz ilk bağlandığında, Charles bir iletişim kutusu gösterir ve "IP xxx.xxx.x.x ile bağlantıya izin verilsin mi?" sorusunu sorar. Allow butonuna tıklayın. Eğer bu pencere görünmediyse, Windows veya macOS güvenlik duvarının Charles'ı engelleyip engellemediğini kontrol edin. macOS'ta, Sistem Ayarları → Güvenlik → Güvenlik Duvarı altında gelen bağlantılara açıkça izin vermeniz gerekebilir.

Android için Charles Proxy ayarları

Android'deki ayar iki bölümden oluşur: trafiği Charles üzerinden yönlendirmek ve HTTPS'yi şifre çözmek için sertifika yüklemek. Sertifika olmadan yalnızca şifrelenmiş verileri göreceksiniz — bu, işe yaramaz bir karakter setidir.

Android'de Wi-Fi proxy ayarları

1. Ayarlar → Wi-Fi bölümünü açın
2. Bağlı ağa basılı tutun → Ağı değiştir
3. Gelişmiş seçenekler'i etkinleştirin
4. Proxy alanında Manuel'i seçin
5. Proxy sunucusu: Bilgisayarınızın IP adresi (örneğin, 192.168.1.5)
6. Port: 8888
7. Ayarları kaydedin

Bundan sonra, cihazdan gelen tüm HTTP trafiği Charles üzerinden geçecektir. Uygulama ekranında istek kayıtları görünmeye başlayacaktır.

Android'de Charles sertifikasının yüklenmesi

1. Cihazda bir tarayıcı açın ve chls.pro/ssl adresine gidin
2. .pem uzantılı sertifika dosyası indirilecektir
3. Ayarlar → Güvenlik → Sertifika yükleme bölümünü açın
4. İndirilen dosyayı seçin ve CA Sertifikası olarak yükleyin
5. Herhangi bir isim verin, örneğin "Charles SSL"

Android 7 ve üzerindeki uygulamalar varsayılan olarak kullanıcı sertifikalarına güvenmez. Bu, sistem uygulamalarının ve çoğu üçüncü taraf uygulamanın (Facebook, Instagram, TikTok) yakalamayı engelleyeceği anlamına gelir. Bu tür uygulamalarla çalışmak için ya root erişimi ya da sertifikayı sistem deposuna yükleyebilen bir Android emülatörü (örneğin, Genymotion veya Android Studio Emulator) kullanmanız gerekecektir.

iOS için Charles Proxy ayarları

iOS'ta prosedür biraz daha basittir — Apple, profiller aracılığıyla sertifika yüklemek için standart bir mekanizma sağlar ve çoğu uygulama sistem proxy ayarlarına saygı gösterir.

iPhone/iPad'de Wi-Fi proxy ayarları

1. Ayarlar → Wi-Fi bölümünü açın
2. Bağlı ağın yanındaki (i) simgesine dokunun
3. HTTP proxy bölümüne kadar aşağı kaydırın
4. Manuel'i seçin
5. Sunucu: Charles ile bilgisayarın IP adresi
6. Port: 8888
7. Kimlik doğrulama: kapalı (eğer Charles'da ayarlanmadıysa)

iOS'ta Charles sertifikasının yüklenmesi

1. iPhone'da Safari tarayıcısını açın ve chls.pro/ssl adresine gidin
2. Safari, yapılandırma profilini yüklemeyi önerir — İzin Ver butonuna tıklayın
3. Ayarlar → Genel → VPN ve Cihaz Yönetimi bölümüne gidin
4. Charles profilini bulun ve Yükle butonuna tıklayın
5. Gerekirse cihazın PIN kodunu girin
6. Şimdi Ayarlar → Genel → Bu Cihaz Hakkında → Sertifikalara Güven bölümüne gidin
7. Charles Proxy CA yanındaki anahtarı açın

Bundan sonra, Charles çoğu iOS uygulamasının HTTPS trafiğini şifre çözebilecektir. Sertifika pinleme (Certificate Pinning) etkin olan uygulamalar, örneğin banka uygulamaları ve bazı Instagram sürümleri hariçtir. Bu tür uygulamaların analizi için jailbreak ve SSL Kill Switch gibi özel tweak'ler gerekecektir.

HTTPS trafiğini yakalama: SSL Proxying ayarları

Sertifika yüklendikten sonra bile, Charles varsayılan olarak HTTPS trafiğini şifre çözmez — hangi alanlar için SSL Proxying'in etkinleştirileceğini açıkça belirtmeniz gerekir. Bu, arayüzü gereksiz verilerle aşırı yüklememek için yapılmıştır.

SSL Proxying nasıl etkinleştirilir

1. Charles menüsünde Proxy → SSL Proxying Settings'i seçin
2. Enable SSL Proxying seçeneğini işaretleyin
3. Include bölümünde Add butonuna tıklayın
4. Host alanına * (yıldız = tüm alanlar) yazın
5. Port alanına 443 yazın
6. OK butonuna tıklayın ve yakalamayı yeniden başlatın

Artık Charles, tüm alanlar için HTTPS trafiğini şifre çözecektir. Belirli bir hizmetle ilgileniyorsanız, yıldız yerine o alanı belirtin. Örneğin, Instagram'ı analiz etmek için *.instagram.com, Facebook için ise *.facebook.com yazın.

SSL Proxying etkinleştirildikten sonra neler görülür

Charles'ın sol panelinde alanların ağaç yapısını göreceksiniz. Herhangi bir isteğe tıkladığınızda, sağ kısımda detaylı bilgi açılacaktır: URL, yöntem (GET/POST), istek başlıkları, istek gövdesi (varsa) ve sunucu yanıtı. Request ve Response sekmeleri, verileri ham haliyle veya kullanışlı bir biçimlendirilmiş şekilde (JSON, XML, HTML) gösterir.

Özellikle istek başlıkları değerlidir — burada yetkilendirme token'ları, cihaz kimlikleri, uygulama sürümü ve platformların doğrulama için kullandığı diğer veriler iletilir. Facebook Reklamları veya TikTok'a yapılan isteklere şüpheli parametreler görüyorsanız — bu, hesabın neden yasaklandığını anlamanın ilk adımıdır.

Analiz araçları: Breakpoints, Rewrite ve Map Local

Charles sadece trafik görüntüleyici değil, aynı zamanda onu değiştirmek için güçlü bir araçtır. En sık kullanılan üç ana araç:

Breakpoints — duraklama noktaları

Breakpoints, bir isteği veya yanıtı geçerken yakalayıp, alıcıya ulaşmadan önce verileri manuel olarak düzenlemenizi sağlar. Bu, test için güçlü bir araçtır: istek parametrelerini değiştirebilir, başka bir token ekleyebilir veya sunucu yanıtını değiştirebilirsiniz.

Breakpoint ayarlamak için: listede bir isteğe sağ tıklayın → Breakpoint. Artık uygulama bu URL'ye bir sonraki erişiminde, Charles iletimi durduracak ve düzenleme penceresini açacaktır. Herhangi bir parametreyi değiştirebilir ve devam etmek için Execute butonuna tıklayabilirsiniz.

Rewrite — otomatik veri değiştirme

Rewrite otomatik olarak çalışır: "Eğer istekte X varsa — Y ile değiştir" kuralını belirlersiniz ve Charles, bu kurallara uyan tüm isteklere bunu uygular. Bu, toplu testler için kullanışlıdır: örneğin, belirli bir alan için tüm isteklere belirli bir başlık değerini değiştirmek.

Ayarlama: Tools → Rewrite → Add → kural setinin adını belirleyin → Kural ekleyin → türü (Header, Body, URL vb.) belirtin, neyi arayacağınızı ve ne ile değiştireceğinizi belirtin.

Map Local — yanıtı yerel dosya ile değiştirme

Map Local, sunucu yanıtını yerel bir dosyanın içeriğiyle değiştirmeyi sağlar. Bu, gerçek bir arka uç olmadan uygulamaları test etmek için vazgeçilmezdir: gerekli verilerle bir JSON dosyası oluşturursunuz ve uygulama bunları gerçek API yanıtı yerine alır.

Ayarlama: Tools → Map Local → Add → yakalamak için URL'yi ve yerel dosyanın yolunu belirtin. Artık bu URL'ye yapılan her istek, dosyanızın içeriğini döndürecektir. Bu, sınır durumlarını test etmeyi sağlar: boş ürün listesi, sunucu hatası 500, standart dışı veri formatı.

Araç	Ne zaman kullanılmalı	Zorluk
Breakpoints	Tek seferlik manuel istek/yanıt düzenlemesi	Düşük
Rewrite	Kurallara göre otomatik değiştirme	Orta
Map Local	API yanıtını yerel dosya ile değiştirme	Düşük
Map Remote	İsteği başka bir sunucuya yönlendirme	Orta
Throttle	Yavaş bağlantı simülasyonu	Düşük

Charles üzerinden dış proxy sunucusu nasıl bağlanır

Charles Proxy, sadece yerel bir yakalayıcı olarak değil, aynı zamanda cihaz ile dış proxy sunucusu arasında bir ara bağlantı olarak da çalışabilir. Bu, trafiği aynı anda analiz etmek ve belirli bir IP adresi üzerinden yönlendirmek gerektiğinde özellikle faydalıdır — örneğin, uygulamanın başka bir ülkeden veya mobil IP üzerinden nasıl davrandığını kontrol etmek için.

Bu şema şöyle görünür: Akıllı telefon → Charles Proxy (bilgisayar) → Dış proxy sunucusu → İnternet. Tüm trafiği Charles'ta görebilirsiniz, ancak istekler gerekli IP üzerinden gider.

Charles'ta dış proxy ayarları

1. Proxy → Dış Proxy Ayarları bölümünü açın
2. Dış proxy sunucularını kullan seçeneğini işaretleyin
3. HTTP trafiği için: Web Proxy (HTTP)'yi etkinleştirin, proxy'nin host ve portunu girin
4. HTTPS trafiği için: Güvenli Web Proxy (HTTPS)'yi etkinleştirin, aynı bilgileri girin
5. Eğer proxy kimlik doğrulama gerektiriyorsa — kullanıcı adı ve şifreyi girin
6. OK butonuna tıklayın

Charles, HTTP ve SOCKS5 proxy'lerini destekler. SOCKS5 için aynı ayarlarda SOCKS Proxy sekmesini kullanın. Eğer konut proxy'leri ile IP rotasyonu yapıyorsanız — her yeni istek farklı bir adresten gidecektir, bu da platformların IP değiştiğinde nasıl davrandığını test etmek için uygundur.

Yerel trafik için istisnalar

Eğer trafiğin bir kısmının doğrudan (dış proxy olmadan) gitmesini istiyorsanız, Bypass external proxies for the following hosts alanına istisnalar ekleyin. Örneğin, yerel adresler localhost ve 127.0.0.1 genellikle hariç tutulmalıdır, böylece yerel hizmetler bozulmaz.

Pratik senaryolar: arabuluculuk, SMM ve uygulama testleri

Charles Proxy'nin gerçek işlerde kullanıldığı belirli görevleri inceleyelim — gereksiz teori olmadan.

Senaryo 1. Arabuluculuk — Facebook Reklamlarının parmak izinin analizi

Arabulucunun en önemli görevlerinden biri, Facebook'un hesapları neden hemen yasakladığını anlamaktır. Charles, Facebook uygulamasının kimlik doğrulama sırasında yaptığı ilk istekleri yakalayarak, Meta sunucularına hangi cihaz verilerinin gönderildiğini görmenizi sağlar.

graph.facebook.com adresine yapılan isteklere baktığınızda, device_id, hardware_id, advertiser_id gibi parametreleri göreceksiniz. Bu, hangi verilerin, birden fazla hesapla çalışırken anti-tespit tarayıcıları (Dolphin Anty veya AdsPower gibi) içinde izole edilmesi gerektiğini anlamanıza yardımcı olacaktır.

Ayrıca, yasaklama durumunda sunucu yanıtını yakalamak da faydalıdır — genellikle hata kodu ve bazen Facebook'un uygulama arayüzünde göstermediği engelleme sebebi içerir.

Senaryo 2. SMM — Instagram ve TikTok API'sinin incelenmesi

10-50 müşteri hesabı yöneten SMM uzmanları, platformların limitleriyle sık sık karşılaşırlar: Instagram, saat başına beğeni, takip ve yorum sayısını sınırlar. Charles, bu limitleri tam olarak ölçmenizi sağlar, hesabı manuel olarak kullanırken istekleri yakalayarak.

i.instagram.com adresine yapılan isteklere bakarak API yapısını göreceksiniz: uç noktalar, parametreler, yetkilendirme token'ları. Bu, otomasyonu gerçek bir kullanıcının davranışını taklit edecek şekilde ayarlamanıza ve engellenmemesine yardımcı olur. TikTok ile de benzer şekilde çalışır — api16-normal-c-useast1a.tiktokv.com adresine yapılan isteklerin analizi, platformun hangi parametreleri kontrol ettiğini gösterir.

Senaryo 3. E-ticaret — Pazar yerlerinin API'sinin analizi

Wildberries, Ozon ve Avito'daki satıcılar, rakiplerin fiyatlarını izlemek için aktif olarak kullanmaktadır. Charles, pazar yerinin mobil uygulamasının isteklerini yakalayarak, fiyat ve stok bilgilerini hangi uç noktalar üzerinden yüklediğini görmenizi sağlar. Bu, mobil uygulamanın davranışını taklit eden bir ayrıştırıcıyı ayarlamanıza yardımcı olur — bu tür istekler, tarayıcıdan gelen ayrıştırıcı isteklerine göre çok daha kolay geçer.

Örneğin, Wildberries uygulamasında catalog.wb.ru adresine yapılan istekleri yakalayarak, filtreleme ve sayfalama parametrelerinin tam yapısını görebilirsiniz. Bu, korumayı çok daha etkili bir şekilde aşacak bir ayrıştırıcı oluşturmak için hazır bir şablon sağlar. Bunun için yüksek hız ve bağlantı kararlılığı gerektiren veri merkezi proxy'leri gerekecektir.

Senaryo 4. Mobil uygulamaların QA testi

Test uzmanları, uygulamanın alışılmadık durumlarda nasıl davrandığını kontrol etmek için Charles'ı kullanır. Map Local ile sunucu yanıtını 500 hatası ile değiştirebilir ve uygulamanın arka uç hatasını nasıl işlediğini kontrol edebilirsiniz. Throttle, yavaş internet simülasyonu (3G, Edge) yapmanıza ve uygulamanın uzun yüklemelerde takılıp kalıp kalmadığını kontrol etmenize olanak tanır. Breakpoints, verileri manuel olarak değiştirme ve sınır durumlarını test etme imkanı sağlar — örneğin, sunucu bir ürün listesi yerine boş bir dizi döndürdüğünde ne olacağını kontrol edebilirsiniz.

Sık karşılaşılan sorunlar ve çözümleri

Charles Proxy ile çalışırken, yeni başlayanlar sık sık aynı sorunlarla karşılaşmaktadır. En yaygın olanları inceleyelim.

Sorun 1: Charles, HTTPS isteklerinin içeriği yerine "unknown" gösteriyor

Neden: SSL Proxying etkin değil veya sertifika cihazda yüklenmemiş.
Çözüm: Proxy → SSL Proxying Settings bölümünde SSL Proxying'in etkin olduğunu ve *:443 alanının eklendiğini kontrol edin. Charles sertifikasının cihazda yüklü olduğundan ve tam güvenin etkinleştirildiğinden emin olun (iOS'ta — sertifikalara güven ayarları aracılığıyla).

Sorun 2: Trafik yakalanmıyor, istek listesi boş

Neden: Cihaz, trafiği Charles üzerinden yönlendirmiyor veya Charles bağlantıları kabul etmiyor.
Çözüm: Cihazın ve bilgisayarın aynı Wi-Fi ağında olduğundan emin olun. Cihazdaki proxy ayarlarında doğru bilgisayar IP'sinin ve 8888 portunun belirtildiğini kontrol edin. Charles'ta yakalamanın etkin olduğunu kontrol edin: Proxy → Start Recording (veya araç çubuğundaki kırmızı nokta butonu).

Sorun 3: Charles açıkken uygulama çalışmıyor

Neden: Uygulama Sertifika Pinleme kullanıyor — sadece güven zincirini değil, aynı zamanda belirli bir sunucu sertifikasını da kontrol ediyor. Charles sertifikası bekleneni karşılamıyor.
Root'lu Android için çözüm: Magisk modülü TrustUserCerts'i yükleyin veya SSL Pinleme'yi aşmak için Frida kullanın. Jailbreak'li iOS için — SSL Kill Switch 2. Root/jailbreak olmadan Sertifika Pinleme'yi aşmak son derece zordur.

Sorun 4: Charles çok fazla trafiği yakalıyor, arayüz yavaşlıyor

Neden: Cihazdaki tüm uygulamalardan, sistem hizmetleri de dahil olmak üzere tüm trafik kaydediliyor.
Çözüm: Filtreleme kullanın. Filtre alanına (sol panelin alt kısmında) ilginç hizmetin alanını girin. Ya da Proxy → Access Control Settings bölümünde Erişim Kontrolü ayarlayarak, Charles'ın yalnızca belirli uygulamalardan gelen bağlantıları kabul etmesini sağlayın: Proxy → Recording Settings → Include/Exclude.

Sorun 5: Charles kapatıldıktan sonra internet çalışmıyor

Neden: Mobil cihazda proxy ayarları kaldı, ancak Charles artık çalışmıyor — trafik gidecek bir yer bulamıyor.
Çözüm: Charles ile çalışmayı bitirdikten sonra her zaman cihazdaki proxy ayarlarını kaldırın. Wi-Fi ayarlarında proxy ayarını "Yok" veya "Kapalı" konumuna geri döndürün.

Sorun	Hızlı çözüm
HTTPS "unknown" gösteriyor	SSL Proxying'i etkinleştir + sertifikayı yükle
İstek listesi boş	IP'yi, portu kontrol et ve Charles'ın kayıt modunda olduğunu kontrol et
Uygulama açılmıyor	Sertifika Pinleme — root/jailbreak gerekiyor
Arayüz yavaşlıyor	Filtre alanına alan adı ekleyin
Kapatıldıktan sonra internet yok	Cihazdaki proxy ayarlarını kaldırın

Sonuç

Charles Proxy, mobil uygulamalarla çalışan herkes için en yararlı araçlardan biridir: ister Facebook Reklamlarının doğrulama mekanizmalarını anlamak isteyen bir arabulucu, ister Instagram API'sini inceleyen bir SMM uzmanı, ister uygulamasının alışılmadık koşullarda nasıl davrandığını test eden bir geliştirici olun. Kurulum 15-20 dakika sürer ve ayarlandıktan sonra açılan olanakları abartmak zordur.

Unutulmaması gereken en önemli şey: Charles, analiz ve hata ayıklama aracı olup, anonimleştirme aracı değildir. Birden fazla hesapla çalışmak, farklı coğrafi konumlardan test yapmak veya platform kısıtlamalarını aşmak için ayrı bir koruma seviyesi gereklidir — gerçek IP adresleri ile proxy sunucuları.

Eğer mobil uygulamaların trafiğini arabuluculuk veya sosyal medya hesapları için analiz ediyorsanız, Charles'ı konut proxy'leri ile birleştirmenizi öneririz — bunlar gerçek ev kullanıcılarının IP'lerini sağlar, bu da test ve hesaplarla çalışırken yasaklama riskini en aza indirir. Yüksek hız ve bağlantı kararlılığının önemli olduğu görevler için — örneğin, pazar yerlerinin API'sini toplu olarak ayrıştırmak — yüksek uptime'a sahip veri merkezi proxy'leri uygundur.