Bizim bakış açımız: Biz Geonode olarak proxy satışı yapıyoruz; dolayısıyla bu makalenin ilk yarısı, bizim ürünümüzün Postman ile birlikte kullanılmasına odaklanıyor. Dürüst olmak gerekirse, Postman proxy kullanımının yoğun olduğu işler için pek uygun bir araç değildir — proxy ayarlarını istek bazında değil genel olarak uygular; bu nedenle bir isteği proxy üzerinden, diğerini ise doğrudan göndermek kolay değildir. Proxy'nin çalışıp çalışmadığını test etmek ve bir proxy aracılığıyla API'yi keşfetmek için mükemmeldir; ancak her çağrı için farklı yönlendirme gerektiren iş yükleri için yanlış araçtır. Yapılandırmanızı doğrulamak için kullanın, ardından asıl işi istek bazında kontrol imkanı sunan bir istemciye aktarın.
Hangi Özelliği İstiyorsunuz?
Önce bunu belirleyin, gerisi çok basit.
Postman'ın isteklerinizi bir proxy üzerinden göndermesini istiyorsunuz. Nedenleri: Kurumsal bir proxy, ağınızdan dışarı çıkmanın tek yolu olabilir veya coğrafi konum ya da erişimi kontrol etmek için bir API'yi proxy üzerinden test ediyor olabilirsiniz. Bu, bir sonraki bölümde ele alınacak olan global proxy yapılandırmasıdır.
Başka bir uygulamadan gelen istekleri yakalamak istiyorsunuz. Nedenleri: Bir mobil uygulamanın veya tarayıcının gerçekte ne gönderdiğini görmek ya da üçüncü taraf bir entegrasyonun hata ayıklamasını yapmak. Bu, daha sonra ele alınacak olan Postman’ın yerleşik proxy’sidir. Postman aracı olur ve diğer yazılımlar ona yönelir.
Bunlar farklı yerlerde yapılandırılır ve birbiriyle ilgisiz sorunları çözer.
Genel Proxy Yapılandırma
Postman’ın kılavuzu üç farklı yaklaşımı açıklamaktadır.
Varsayılan proxy, sisteminizde yapılandırılmış proxy’yi otomatik olarak kullanır. İşletim sisteminizde halihazırda bir proxy ayarlanmışsa, Postman bunu algılar ve sizin hiçbir şey yapmanıza gerek kalmaz.
Sistem proxy'si, istekler için sistem proxy'sini açıkça etkinleştirir; bu, sistem proxy'niz yapılandırılmış olmasına rağmen Postman'ın bunu yok sayıyormuş gibi göründüğü durumlarda kontrol etmeniz gereken ayardır.
Özel proxy, farklı bir sunucu belirlemenize olanak tanır. Ticari bir proxy hizmeti kullanmak istediğinizde bu seçeneği tercih etmelisiniz; bu ayar, Ayarlar'daki Proxy sekmesinden yapılır.
Desteklenen protokoller, insanların beklediğinden daha geniştir. Belgelerde "HTTP, SOCKS5, SOCKS5H, SOCKS4 ve SOCKS4A protokolleri" listelenmiştir ve açıkça belirtilen tek bir sınırlama vardır: "Postman, yalnızca SOCKS proxy üzerinden HTTP ve HTTPS isteklerinin gönderilmesini destekler."
SOCKS5H girişi dikkat çekicidir. h türü, ana bilgisayar adını yerel olarak çözümlemek yerine çözümleme için proxy'ye gönderir; bu da trafiğiniz başka bir yere giderken DNS sorgularının kendi çözümleyicinize sızmasını önler. Özellikle bulunduğunuz yeri değiştirmek için SOCKS kullanıyorsanız, SOCKS5 yerine SOCKS5H'yi seçin.
Kimlik Doğrulama ayrı bir anahtardır. Kimlik bilgileri gerektiren bir proxy için, belgelerde Proxy ayarları sekmesine kullanıcı adı ve şifre girerek "kimlik bilgilerini Postman masaüstü uygulamasına eklemeniz" gerektiği belirtilmektedir. Bunun masaüstü uygulaması olduğunu unutmayın — tarayıcı sürümü, yerel ağınızdaki bir proxy'ye erişemez.
Atlama listesi, ana bilgisayarları hariç tutmanıza olanak tanır: "ana bilgisayarların virgülle ayrılmış bir listesini girin. Bu ana bilgisayarlara gönderilen istekler, özel proxy'yi kullanmayacaktır." Buraya localhost, 127.0.0.1 ve diğer tüm dahili ana bilgisayar adlarını ekleyin; aksi takdirde, kendi geliştirme sunucunuza gönderilen istekler proxy üzerinden yönlendirilecek ve kafa karıştırıcı bir şekilde başarısız olacaktır.
Gerçekten Çalışıp Çalışmadığını Doğrulama
İnsanların atladığı, ancak bir saat kazandıran adım.
Gördüğü adresi bildiren bir servise istek gönderin:
GET https://api.ipify.org?format=json
Proxy devre dışı haldeyken komutu çalıştırın, adresi not edin, ardından proxy’yi etkinleştirin ve komutu tekrar çalıştırın. Adres değişmezse, proxy kullanılmıyor demektir. Bunu belirten bir hata mesajı çıkmaz — istek doğrudan gider ve başarılı olur.
Etkili olmamasının üç yaygın nedeni:
Baypas listesi hedefinizle eşleşiyor. Hedefinizi istemeden kapsayan bir giriş olup olmadığını kontrol edin.
Postman'ın tarayıcı sürümünü kullanıyorsunuz ve bu sürüm, bilgisayarınızdaki bir proxy'ye erişemez. Masaüstü uygulaması gereklidir.
Ayar yanlış sekmede. Varsayılan, sistem ve özel seçenekleri birbirinden ayrıdır; sistem proxy seçeneği seçiliyken özel bir proxy yapılandırmak hiçbir işe yaramaz.
Coğrafi hedeflemeli proxy'ler için adresi kontrol etmek yeterli değildir. Sonuca göre doğrulayın — bölgelere göre gerçekten farklılık gösteren bir istek gönderin ve yanıtın değiştiğini teyit edin. API'niz kendi bölgenizin verilerini döndürürken bir arama hizmetinin doğru ülkeyi bildirmesi, hedeflemenin olması gereken yere ulaşmadığı anlamına gelir.
İstekleri Bozan Ayarlar
Postman’daki iki ayar, proxy kullanımıyla etkileşime girerek kafa karıştırıcı hatalara neden olur.
SSL sertifika doğrulaması. Proxy’niz TLS trafiğini engelliyorsa — ki kurumsal proxy’ler genellikle bunu yapar — Postman, sertifikanın güvenilir bir sertifika yetkilisi yerine proxy’nin kendi sertifika yetkilisi tarafından verildiği için sertifikayı reddeder. Bunun belirtisi, her HTTPS isteğinde bir TLS hatasının ortaya çıkmasıdır.
Doğru çözüm, Postman'ın sertifika ayarlarına kuruluşunuzun CA sertifikasını eklemektir. Cazip gelen çözüm, SSL doğrulamasını genel olarak devre dışı bırakmaktır; ancak bunun neye mal olacağını anlamakta fayda vardır: Bu durumda Postman’daki her istek, herhangi bir sertifikayı kabul eder; bu, bir şeyin sizi engelleyip engellemediğini bilmek istediğiniz API’ler de dahil olmak üzere geçerlidir. Devre dışı bırakmanız gerekiyorsa, bunu bilinçli bir şekilde yapın ve daha sonra tekrar etkinleştirin.
İstek zaman aşımları. Postman'ın varsayılan istek zaman aşımı süresi cömerttir, ancak bir proxy — özellikle de ev tipi bir proxy — istek başına gerçek gecikme ekler. Proxy üzerinden yapılan istekler zaman aşımına uğrarken aynı istekler doğrudan çalışıyorsa, proxy'nin bozuk olduğu sonucuna varmadan önce ayarlardan zaman aşımı süresini artırın.
Koleksiyon çalıştırmalarıyla ilgili bir not: Kısıtlı bir proxy üzerinden büyük bir veri dosyasıyla yapılan bir koleksiyon çalıştırması, her satır için bir istek oluşturur ve her biri için ödeme yaparsınız. Bu, geriye dönüp bakıldığında barizdir, ancak faturada görüldüğünde şaşırtıcı olabilir.
Postman’ın Yerleşik Proxy’si: Trafiği Yakalama
Diğer bir özellik; ve gerçekten de kullanışlı bir özellik.
Kılavuz bunu şu şekilde açıklıyor: “Postman masaüstü uygulamasında, HTTP ve HTTPS trafiğini yakalayabilen yerleşik bir proxy bulunur.” Bu proxy, istemci uygulamalarından gelen istekleri yakalar, bunları iletir, yanıtları yakalar ve çerezleri de toplayabilir.
Varsayılan bağlantı noktası 5559'dur.
Başka bir cihazı bu proxy'ye yönlendirmek için belgelerde üç adım belirtilmiştir: bilgisayarınızın yerel IP adresini bulun, cihazın kablosuz ayarlarını bu IP adresi ve proxy bağlantı noktasını kullanacak şekilde yapılandırın ve — özellikle iOS için — Ayarlar, Wi-Fi, bilgi simgesi, Proxy'yi Yapılandır, Manuel seçeneklerine gidin, ardından sunucu IP adresini ve bağlantı noktasını girin.
Bu, “bu mobil uygulama aslında ne gönderiyor?” sorusuna cevap bulmanın en hızlı yoludur; aksi takdirde bu, şaşırtıcı derecede zor bir sorudur.
HTTPS için bir sertifika gereklidir. Belgelerde, proxy'nin "güvenli HTTPS trafiğini yakalamak için istemci cihazlara postman-proxy-ca.crt sertifikasının yüklenmesini gerektirdiği" ve ana bilgisayarda "sertifikanın yüklenmesinin, Postman proxy'sinin tarayıcılardan ve diğer istemci uygulamalarından gönderilen güvenli HTTPS trafiğini yakalamasını sağladığı" açıkça belirtilmiştir.
Bunu yapmadan önce bunun ne anlama geldiğini iyice anlayın. Herhangi bir etki alanı için sertifika verebilen bir sertifika yetkilisi kuruyorsunuz ve Postman, bunu size gösterebilmek için TLS trafiğinizin şifresini çözüyor. Mekanizma tamamen budur — şifrelemeyi sonlandırmadan şifrelenmiş trafiği incelemenin bir yolu yoktur.
Ciddiye alınması gereken iki sonuç vardır. İşiniz bittiğinde sertifikayı kaldırın, özellikle de kişisel amaçlarla kullandığınız bir telefonda. Ayrıca, sertifika yüklüyken önem verdiğiniz kimlik bilgilerini içeren trafiği yakalamayın, çünkü bu kimlik bilgileri şifresi çözülerek görüntülenir.
Proxy’ye Bağımlı İşlemleri Yönetmek İçin Ortamları Kullanma
Postman, istek başına proxy ayarını değiştiremediğinden, pratik bir çözüm olarak diğer tüm ayarları değiştirmek gerekir — ve Postman’ın ortam özelliği bu amaç için son derece uygundur.
Hedef temel URL'yi isteğe değil, bir ortam değişkenine yerleştirin. İsteklerinin tümü {{baseUrl}}
adresini kullanan bir koleksiyon, ortamlar arasında geçiş yapılarak farklı bir ana bilgisayara yönlendirilebilir; bu sayede hiçbir şeyi düzenlemeden bölgeler arası davranışları karşılaştırabilirsiniz:
{{baseUrl}}/api/products?region={{region}}
Her senaryo için bir ortam oluşturun. Her biri kendi değişkenlerine sahip bir "doğrudan" ortam ve bir "proxy üzerinden" ortam, tek bir açılır menüden bağlam arasında geçiş yapmanızı sağlar. Proxy ayarını Ayarlar'dan değiştirmeniz yine gerekecektir, ancak diğer her şey ortamla birlikte değişir.
Adres kontrolünü koleksiyonda bir istek olarak saklayın. Gerçek isteklerinizin yanına kaydedilen bir GET https://api.ipify.org?format=json
, proxy'yi doğrulamak için yeni bir sekme açmak yerine tek bir tıklama yeterlidir. Bulduklarını kaydetmesi için bir test komut dosyası ekleyin:
const ip = pm.response.json().ip;
pm.environment.set("observedIp", ip);
console.log("Exit address:", ip);
Adrese değil, bölgeye bağlı içeriğe odaklanın. Coğrafi hedeflemeli çalışmalarda, yararlı olan kontrol, yanıtın gerçekten farklı olup olmadığıdır:
pm.test("Response is region-specific", function () {
pm.expect(pm.response.json().currency).to.eql(pm.environment.get("expectedCurrency"));
});
Bu, proxy çalışmalarının diğer her yerinde geçerli olan ilkeyle aynıdır: bir IP araması, arama hizmetinin ne düşündüğünü gösterir; ancak hedeflemenin işe yarayıp yaramadığını yalnızca hedefin kendi yanıtı gösterir.
Ve kimlik bilgilerini koleksiyondan uzak tutun. Proxy kimlik bilgileri Postman’ın ayarlarında, API kimlik bilgileri ise gizli olarak işaretlenmiş ortam değişkenlerinde yer almalıdır — istek içinde değil ve kesinlikle dışa aktarmayı veya paylaşmayı planladığınız bir koleksiyonda da olmamalıdır. Dışa aktarılan bir koleksiyon, gizli olarak işaretlenmedikçe değişken değerlerini de beraberinde taşır; bu da bir token’ı yanlışlıkla yayınlamanın kolay bir yoludur.
Hangi İş İçin Hangi İstemci
Postman, belirli bir amaca yönelik iyi bir araçtır ve sınırlarının farkında olmak zaman kazandırır.
Postman’ı şunlar için kullanın: bir API’yi etkileşimli olarak keşfetmek, bir proxy’nin çalışıp çalışmadığını kontrol etmek, bir cihazdan gelen trafiği yakalamak ve bir istek koleksiyonunu iş arkadaşlarınızla paylaşmak.
curl'ü şunlar için kullanın: yeniden üretmek, komut dosyası oluşturmak veya bir bilete yapıştırmak istediğiniz her şey. -x
ile istek başına proxy kontrolü, ağ üzerinden tam olarak neyin geçtiğini gösteren ayrıntılı çıktı ve her makinede aynı şekilde çalışan bir komut:
curl -x http://user:pass@proxy.example.com:9000 https://api.ipify.org
Postman, herhangi bir istekten bir curl komutu oluşturabilir; bu, keşif aşamasından yeniden üretilebilir bir aşamaya geçmenin en hızlı yoludur.
Kodda uygun bir HTTP istemcisi kullanın: gerçek hacimli işlemler, istek başına yönlendirme, yeniden deneme mantığı veya oturum yönetimi gerektiren her şey için. Postman’ın genel proxy ayarı, tüm uygulama için tek bir değerdir; bu nedenle, istek başına farklı çıkışlar gerektiren bir iş yükü bu ayarda hiç ifade edilemez.
Pratik bir iş akışı: Postman'da proxy'nin çalıştığını doğrulayın, isteği curl olarak dışa aktarın ve GUI dışında da çalıştığını teyit edin, ardından kodda istek başına kontrol ile bunu uygulayın. Her adım, yanlış araçta bir önceki adımı hata ayıklamaktan daha hızlıdır.
Sorun Giderme
İstekler proxy olmadan çalışıyor, ancak proxy kullanıldığında başarısız oluyor. Öncelikle kimlik bilgilerinizi kontrol edin — 407 durumu, proxy’nin sizi reddettiği anlamına gelir ve bu, hedef sunucudan gelen 401 hatasından farklı bir hatadır. Ardından, sağlayıcınızın mevcut adresinizin içinde bulunmadığı bir IP izin listesi kullanıp kullanmadığını kontrol edin.
Her şey yavaş. Ev tipi proxy'ler istek başına gerçek bir gecikme ekler ve bu bir arıza değil, fiziksel bir durumdur. Herhangi bir şeyin bozuk olduğu sonucuna varmadan önce zaman aşımı süresini artırın ve ölçüm yapın.
Her HTTPS isteğinde TLS hataları. Proxy, TLS'yi engelliyor. Doğrulamayı devre dışı bırakmak yerine CA sertifikasını ekleyin.
Proxy ayarı göz ardı ediliyor gibi görünüyor. Baypas listesini kontrol edin, masaüstü uygulamasını kullandığınızdan emin olun ve doğru seçeneği etkinleştirdiğinizi doğrulayın — "özel", "sistem" ve "varsayılan" seçenekleri birbirinden ayrıdır.
Yakalama ekranında hiçbir şey görünmüyor. Cihazın aynı ağda olduğunu, bağlantı noktasının eşleştiğini ve makinenizdeki hiçbir güvenlik duvarının 5559 numaralı bağlantı noktasındaki gelen bağlantıları engellemediğini doğrulayın.
HTTPS yakalama, bağlantıları gösteriyor ancak içerik göstermiyor. CA sertifikası istemci cihaza yüklenmemiş veya güvenilir olarak işaretlenmemiş. Bazı platformlarda, sertifikanın yüklenmesi ve güvenilir olarak işaretlenmesi ayrı adımlardır.
Doğru kimlik bilgileriyle devam eden bir 407 hatası. Şifrede kodlanması gereken karakterler olup olmadığını kontrol edin ve sağlayıcınızın kimlik bilgilerini bekleyip beklemediğini doğrulayın — çoğu sağlayıcı bunun yerine IP izin listesi sunar; bu, yapılandırmadan kimlik bilgilerini tamamen kaldırır ve adresinizin sabit olduğu durumlarda kullanmaya değer bir yöntemdir.
Sık Sorulan Sorular
Postman’da proxy nasıl ayarlanır?
Masaüstü uygulamasında Ayarlar’ı açın ve Proxy sekmesine gidin; ardından özel bir proxy seçin ve ana bilgisayar adresini ile bağlantı noktasını girin. Postman, sistem proxy’sinin otomatik olarak kullanılmasını da destekler. Proxy için kimlik bilgileri gerekiyorsa, aynı sekmede bu bilgileri girin.
Postman, SOCKS proxy'lerini destekliyor mu?
Evet — belgelerde HTTP, SOCKS5, SOCKS5H, SOCKS4 ve SOCKS4A listelenmiştir. Belirtilen sınırlama, SOCKS proxy üzerinden yalnızca HTTP ve HTTPS isteklerinin gönderilebilmesidir. SOCKS5H'yi SOCKS5'e tercih edin; çünkü SOCKS5H, ana bilgisayar adlarını proxy'de çözer ve DNS sorgularının sızmasını önler.
Postman neden proxy ayarlarımı yok sayıyor?
Genellikle üç nedenden biri söz konusudur: hedef ana bilgisayar, baypas listesindeki bir girdiyle eşleşiyor, masaüstü uygulaması yerine tarayıcı sürümünü kullanıyorsunuz veya farklı bir proxy seçeneği seçiliyken özel bir proxy yapılandırdınız. Adresinizi bildiren bir hizmetten istek göndererek bunu doğrulayın.
Postman ile istekleri nasıl yakalayabilirim?
Varsayılan olarak 5559 numaralı bağlantı noktasını kullanan yerleşik proxy'yi kullanın. Bilgisayarınızın yerel IP adresini bulun, istemci cihazını bu bağlantı noktasında HTTP proxy'si olarak kullanacak şekilde yapılandırın ve HTTPS isteklerini yakalamanız gerekiyorsa cihaza postman-proxy-ca.crt sertifikasını yükleyin.
Postman'da proxy kullanırken neden SSL hataları alıyorum?
Bunun nedeni, proxy'nin TLS trafiğini durdurup Postman'ın güvenmediği kendi sertifikasını sunmasıdır. Postman'ın sertifika ayarlarına kuruluşunuzun CA sertifikasını ekleyin. SSL doğrulamasını devre dışı bırakmak da işe yarar ve bundan sonraki tüm istekler için geçerli olur; ancak bu, önemli bir maliyet anlamına gelir.
Postman'da istek başına farklı bir proxy ayarlayabilir miyim?
Hayır. Proxy ayarı uygulama genelinde geçerlidir; bu da Postman’ın istek başına farklı çıkışlar gerektiren iş yükleri için uygun olmamasının ana nedenidir. Bunun için kod tabanlı bir istemci kullanın ve kodu yazmadan önce proxy’nin çalıştığını doğrulamak için Postman’ı kullanın.
Postman’ın proxy ayarları ile yakalama proxy’si arasındaki fark nedir?
Proxy ayarları, Postman’ın kendi isteklerini harici bir proxy üzerinden yönlendirir. Yakalama proxy’si ise Postman’ın, diğer uygulamaların isteklerini ilettiği bir proxy görevi görmesini sağlar; böylece bu uygulamaların ne ilettiğini görebilirsiniz. Yönleri zıt, yapılandırmaları birbirinden bağımsızdır.
Postman CA sertifikasını yüklemek güvenli midir?
Bu, kasıtlı olarak yapılan bir ödünleşmedir. Sertifika, Postman’ın HTTPS trafiğinizi şifresini çözmesine olanak tanır; bu da trafiği incelemek için tek yoldur — ancak bu, söz konusu sertifikaya sahip herhangi bir şeyin herhangi bir etki alanı için güvenilir sertifikalar düzenleyebileceği anlamına gelir. Yakalama yapmanız gerektiğinde yükleyin, işiniz bittiğinde kaldırın ve sertifika yüklüyken hassas kimlik bilgilerini işlemekten kaçının.
Sonuç
Bu konudaki kafa karışıklığı tamamen bir isimlendirme sorunudur. Postman’ın proxy ayarları, isteklerinizi başka birinin proxy’si üzerinden gönderir; Postman’ın yakalama proxy’si ise Postman’ı diğer uygulamalar için bir aracı haline getirir. Hangisini istediğinize karar vermek on saniye sürer ve yanlış belgeleri okumaktan kurtulmanızı sağlar.
İlk seçenek için masaüstü uygulamasını kullanın, Ayarlar'da özel bir proxy ayarlayın, localhost adresini baypas listesine ekleyin ve — en önemli adım olan — adresinizi bildiren bir hizmetten istekte bulunarak doğrulayın; çünkü hiçbir işlem yapmayan bir proxy ayarı hiçbir hata mesajı vermez.
İkinci seçenek için ise 5559 numaralı bağlantı noktası ve istemci cihazda bir CA sertifikası gereklidir. Sertifikanın, Postman'ın trafiğinizi şifresini çözebilmesi için mevcut olduğunu ve işiniz bittiğinde kaldırmanız gerektiğini unutmayın.
Ayrıca Postman’ın sınırlarını da göz önünde bulundurun. Proxy ayarlarını genel olarak uygular, bu nedenle istek bazında yönlendirme yapamaz. Proxy’nin çalıştığını doğrulamak için kullanın, isteği curl olarak dışa aktarıp GUI dışında kontrol edin ve ardından asıl çözümü kodda oluşturun — bu, etkileşimli bir aracın komut dosyası işini yapmasını sağlamaya çalışmaktan daha hızlıdır.