Proxy in Postman einrichten

Proxies in Postman konfigurieren

Postman ist das beliebteste Tool für API-Tests. Die Konfiguration von Proxies in Postman ist notwendig für: das Arbeiten in Unternehmensnetzwerken mit obligatorischen Proxies, das Testen von APIs von verschiedenen geografischen Standorten, das Debuggen des Datenverkehrs über einen abfangenden Proxy (Fiddler, mitmproxy) und das Umgehen von Ratenbegrenzungen.

Proxy-Konfiguration

Über die Einstellungen

1. Postman öffnen
2. Auf das Zahnradsymbol (Einstellungen) oder Strg+, klicken
3. Zum Tab "Proxy" wechseln

System-Proxy

Standardmäßig verwendet Postman den System-Proxy:
1. "System-Proxy verwenden" aktivieren (standardmäßig aktiviert)
2. Postman verwendet automatisch die Proxy-Einstellungen von Windows/macOS
3. Erfordert keine zusätzliche Konfiguration

Benutzerdefinierter Proxy

1. "System-Proxy verwenden" deaktivieren
2. "Benutzerdefinierte Proxy-Konfiguration hinzufügen" aktivieren
3. Eingeben:
   - HTTP-Proxy: Adresse und Port
   - HTTPS-Proxy: Adresse und Port (kann derselbe sein)
4. Umgehen: Domains, die den Proxy umgehen

Authentifizierung

Wenn der Proxy einen Benutzernamen/Passwort erfordert:
1. In den Proxy-Einstellungen "Dieser Proxy erfordert Authentifizierung" aktivieren
2. Benutzernamen und Passwort eingeben
3. Postman sendet automatisch den Proxy-Authorization-Header

Umgebungsvariablen verwenden

Für ein flexibles Proxy-Management verwenden Sie Postman-Variablen:

1. Eine Umgebung erstellen (z.B. "Produktion via Proxy")
2. Variablen hinzufügen: proxy_url, proxy_user, proxy_pass
3. Variablen im Pre-request Script verwenden

Arbeiten mit SSL über Proxy

SSL-Verifizierung deaktivieren

Beim Arbeiten über einen abfangenden Proxy (mitmproxy, Fiddler):
1. Einstellungen → Allgemein
2. "SSL-Zertifikatsprüfung" deaktivieren
3. Dies ermöglicht Postman, selbstsignierte Proxy-Zertifikate zu akzeptieren

Ein CA-Zertifikat hinzufügen

Für Unternehmens-Proxies:
1. Einstellungen → Zertifikate
2. Auf "CA-Zertifikat hinzufügen" klicken
3. Die PEM-Datei des Unternehmenszertifikats hochladen
4. Postman wird dieser CA vertrauen

Client-Zertifikat

Einige Proxies erfordern ein Client-Zertifikat:
1. Einstellungen → Zertifikate
2. Auf "Zertifikat hinzufügen" klicken
3. Host, CRT-Datei, KEY-Datei angeben
4. Postman sendet das Zertifikat bei der Verbindung

Postman als Proxy (Interceptor)

Postman kann selbst als Proxy fungieren, um Anfragen von einem Browser abzufangen:

Postman Interceptor

1. Die Erweiterung "Postman Interceptor" in Chrome installieren
2. Interceptor in Postman aktivieren
3. Anfragen von Chrome werden in Postman abgefangen
4. Nützlich zum Aufzeichnen von Website-API-Aufrufen

Postman Proxy

1. Einstellungen → Proxy → Postman als Proxy aktivieren
2. Den Port angeben (Standard 5555)
3. Ihr Gerät so konfigurieren, dass es localhost:5555 als Proxy verwendet
4. Alle Anfragen werden in der Postman-Historie aufgezeichnet

Proxies in Postman CLI (Newman)

Newman ist die CLI für Postman, die verwendet wird, um Collections über die Kommandozeile auszuführen:

# Über Umgebungsvariable
export HTTP_PROXY=http://proxy_ip:8080
export HTTPS_PROXY=http://proxy_ip:8080
newman run collection.json

# Über Flag
newman run collection.json --env-var "proxy_url=http://proxy_ip:8080"

Pre-request Script für Proxy-Logik

// Dynamische Proxy-Auswahl basierend auf der Umgebung
const env = pm.environment.get("target_env");
if (env === "production") {
    pm.request.proxy = {
        match: "https://*.api.com/*",
        host: "proxy_ip",
        port: 8080
    };
}

Debugging

Postman-Konsole

1. Postman-Konsole öffnen (Ansicht → Postman-Konsole anzeigen oder Strg+Alt+C)
2. Alle HTTP-Anfragen, einschließlich Proxy-Verbindungen, sind hier sichtbar
3. Nützlich zum Debuggen von Proxy-Problemen

Netzwerkprotokoll

In der Konsole sehen Sie:
- Verbindung zum Proxy
- CONNECT-Anfrage (für HTTPS)
- Proxy-Antwort
- Endgültige Serverantwort

Häufige Probleme

"Keine Antwort erhalten"

• Proxy-Adresse und Port überprüfen
• Sicherstellen, dass der Proxy läuft
• Überprüfen, ob eine Firewall die Verbindung zum Proxy blockiert

SSL-Fehler über Proxy

• SSL-Verifizierung in den Einstellungen deaktivieren
• Oder das CA-Zertifikat des Proxys hinzufügen
• Für einen abfangenden Proxy (Fiddler) dessen CA-Zertifikat installieren

407 Proxy-Authentifizierung erforderlich

• Authentifizierung in den Proxy-Einstellungen aktivieren
• Benutzernamen und Passwort überprüfen
• Sicherstellen, dass der Proxy Basic Auth unterstützt

Fazit

Postman bietet flexible Proxy-Einstellungen für verschiedene Szenarien: von Unternehmens-Proxies bis zum Debugging über einen abfangenden Proxy. Die Unterstützung für SSL-Zertifikate, Umgebungsvariablen und CLI (Newman) macht die Arbeit mit Proxies sowohl in der GUI als auch in automatisierten Pipelines komfortabel.