Postman'de proxy ayarlama

Postman'de proxy yapılandırma

Postman, API testi için en popüler araçtır. Postman'de proxy yapılandırmak şunlar için gereklidir: proxy'nin zorunlu olduğu kurumsal ağlarda çalışmak, API'leri farklı coğrafi konumlardan test etmek, trafiği araya giren bir proxy (Fiddler, mitmproxy) üzerinden hata ayıklamak ve rate limiting'i aşmak.

Proxy yapılandırması

Settings üzerinden

1. Postman'i açın
2. Dişli simgesine (Settings) tıklayın veya Ctrl+, tuşlarına basın
3. "Proxy" sekmesine gidin

Sistem proxy'si

Varsayılan olarak Postman sistem proxy'sini kullanır:
1. "Use the system proxy" seçeneğini etkinleştirin (varsayılan olarak açıktır)
2. Postman, Windows/macOS proxy ayarlarını otomatik olarak kullanır
3. Ek yapılandırma gerektirmez

Özel proxy

1. "Use the system proxy" seçeneğini kapatın
2. "Add a custom proxy configuration" seçeneğini etkinleştirin
3. Girin:
   - HTTP Proxy: adres ve port
   - HTTPS Proxy: adres ve port (aynı olabilir)
4. Bypass: proxy'yi atlayacak alan adları

Kimlik doğrulama

Proxy kullanıcı adı/şifre istiyorsa:
1. Proxy ayarlarında "This proxy requires authentication" seçeneğini etkinleştirin
2. Username ve Password girin
3. Postman, Proxy-Authorization başlığını otomatik olarak gönderecektir

Ortam değişkenlerini kullanma

Esnek proxy yönetimi için Postman değişkenlerini kullanın:

1. Bir Environment oluşturun (örneğin "Production via Proxy")
2. Değişkenleri ekleyin: proxy_url, proxy_user, proxy_pass
3. Değişkenleri Pre-request Script içinde kullanın

Proxy üzerinden SSL ile çalışma

SSL doğrulamasını kapatma

Araya giren bir proxy (mitmproxy, Fiddler) üzerinden çalışırken:
1. Settings → General
2. "SSL certificate verification" seçeneğini kapatın
3. Bu, Postman'in kendinden imzalı proxy sertifikalarını kabul etmesini sağlar

CA sertifikası ekleme

Kurumsal proxy'ler için:
1. Settings → Certificates
2. "Add CA Certificate" düğmesine tıklayın
3. Kurumsal sertifikanın PEM dosyasını yükleyin
4. Postman bu CA'ya güvenecektir

İstemci sertifikası

Bazı proxy'ler istemci sertifikası ister:
1. Settings → Certificates
2. "Add Certificate" düğmesine tıklayın
3. Host, CRT dosyası ve KEY dosyasını belirtin
4. Postman bağlanırken sertifikayı gönderecektir

Proxy olarak Postman (Interceptor)

Postman, tarayıcıdan gelen istekleri yakalamak için kendisi de proxy görevi görebilir:

Postman Interceptor

1. Chrome'a "Postman Interceptor" eklentisini kurun
2. Postman'de Interceptor'ı etkinleştirin
3. Chrome'dan gelen istekler Postman'de yakalanacaktır
4. Web sitelerinin API çağrılarını kaydetmek için kullanışlıdır

Postman Proxy

1. Settings → Proxy → Enable Postman as a proxy
2. Portu belirtin (varsayılan 5555)
3. Cihazınızı localhost:5555 adresini proxy olarak kullanacak şekilde ayarlayın
4. Tüm istekler Postman History'de kaydedilir

Postman CLI'de (Newman) proxy'ler

Newman, koleksiyonları komut satırından çalıştırmak için kullanılan Postman CLI'sidir:

# Via environment variable
export HTTP_PROXY=http://proxy_ip:8080
export HTTPS_PROXY=http://proxy_ip:8080
newman run collection.json

# Via flag
newman run collection.json --env-var "proxy_url=http://proxy_ip:8080"

Proxy mantığı için Pre-request Script

// Ortama göre dinamik proxy seçimi
const env = pm.environment.get("target_env");
if (env === "production") {
    pm.request.proxy = {
        match: "https://*.api.com/*",
        host: "proxy_ip",
        port: 8080
    };
}

Hata ayıklama

Postman Console

1. Postman Console'u açın (View → Show Postman Console veya Ctrl+Alt+C)
2. Proxy bağlantıları dâhil tüm HTTP istekleri burada görünür
3. Proxy sorunlarını ayıklamak için kullanışlıdır

Network Log

Console'da şunları görebilirsiniz:
- Proxy'ye bağlantı
- CONNECT isteği (HTTPS için)
- Proxy yanıtı
- Nihai sunucu yanıtı

Sık karşılaşılan sorunlar

"Could not get any response"

• Proxy adresini ve portunu kontrol edin
• Proxy'nin çalıştığından emin olun
• Bir güvenlik duvarının proxy bağlantısını engelleyip engellemediğini kontrol edin

Proxy üzerinden SSL hatası

• Settings'te SSL doğrulamasını kapatın
• Veya proxy'nin CA sertifikasını ekleyin
• Araya giren bir proxy (Fiddler) için onun CA sertifikasını kurun

407 Proxy Authentication Required

• Proxy ayarlarında kimlik doğrulamayı etkinleştirin
• Kullanıcı adı ve şifreyi kontrol edin
• Proxy'nin Basic auth desteklediğinden emin olun

Sonuç

Postman, kurumsal proxy'lerden araya giren proxy ile hata ayıklamaya kadar çeşitli senaryolar için esnek proxy ayarları sunar. SSL sertifikaları, ortam değişkenleri ve CLI (Newman) desteği, proxy'lerle çalışmayı hem arayüzde hem de otomatik pipeline'larda kolaylaştırır.