Налаштування проксі у Postman

Налаштування проксі в Postman

Postman — найпопулярніший інструмент для тестування API. Налаштування проксі в Postman необхідне для: роботи в корпоративних мережах з обов'язковими проксі, тестування API з різних геолокацій, налагодження трафіку через проксі-перехоплювач (Fiddler, mitmproxy) та обходу обмежень частоти запитів.

Конфігурація проксі

Через налаштування

1. Відкрийте Postman
2. Натисніть іконку шестерні (Налаштування) або Ctrl+,
3. Перейдіть на вкладку "Proxy"

Системний проксі

За замовчуванням Postman використовує системний проксі:
1. Увімкніть "Use the system proxy" (увімкнено за замовчуванням)
2. Postman автоматично використовує налаштування проксі Windows/macOS
3. Не потребує додаткової конфігурації

Власний проксі

1. Вимкніть "Use the system proxy"
2. Увімкніть "Add a custom proxy configuration"
3. Введіть:
   - HTTP Proxy: адреса та порт
   - HTTPS Proxy: адреса та порт (можуть бути однаковими)
4. Bypass: домени, які обходять проксі

Автентифікація

Якщо проксі вимагає ім'я користувача/пароль:
1. У налаштуваннях проксі увімкніть "This proxy requires authentication"
2. Введіть ім'я користувача та пароль
3. Postman автоматично надішле заголовок Proxy-Authorization

Використання змінних середовища

Для гнучкого керування проксі використовуйте змінні Postman:

1. Створіть середовище (наприклад, "Production via Proxy")
2. Додайте змінні: proxy_url, proxy_user, proxy_pass
3. Використовуйте змінні у скрипті перед запитом (Pre-request Script)

Робота з SSL через проксі

Вимкнення перевірки SSL

При роботі через проксі-перехоплювач (mitmproxy, Fiddler):
1. Налаштування → Загальні
2. Вимкніть "SSL certificate verification"
3. Це дозволяє Postman приймати самопідписані сертифікати проксі

Додавання сертифіката CA

Для корпоративних проксі:
1. Налаштування → Сертифікати
2. Натисніть "Add CA Certificate"
3. Завантажте PEM-файл корпоративного сертифіката
4. Postman довірятиме цьому CA

Клієнтський сертифікат

Деякі проксі вимагають клієнтський сертифікат:
1. Налаштування → Сертифікати
2. Натисніть "Add Certificate"
3. Вкажіть Host, CRT-файл, KEY-файл
4. Postman надішле сертифікат при підключенні

Postman як проксі (перехоплювач)

Postman сам може діяти як проксі для перехоплення запитів з браузера:

Postman Interceptor

1. Встановіть розширення "Postman Interceptor" у Chrome
2. Увімкніть Interceptor у Postman
3. Запити з Chrome будуть перехоплені в Postman
4. Корисно для запису викликів API веб-сайтів

Postman Proxy

1. Налаштування → Proxy → Увімкніть Postman як проксі
2. Вкажіть порт (за замовчуванням 5555)
3. Налаштуйте свій пристрій на використання localhost:5555 як проксі
4. Усі запити будуть записані в історію Postman

Проксі в Postman CLI (Newman)

Newman — це CLI для Postman, що використовується для запуску колекцій з командного рядка:

# 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"

Скрипт перед запитом для логіки проксі

// Dynamic proxy selection based on environment
const env = pm.environment.get("target_env");
if (env === "production") {
    pm.request.proxy = {
        match: "https://*.api.com/*",
        host: "proxy_ip",
        port: 8080
    };
}

Налагодження

Консоль Postman

1. Відкрийте консоль Postman (View → Show Postman Console або Ctrl+Alt+C)
2. Усі HTTP-запити, включаючи з'єднання через проксі, видно тут
3. Корисно для налагодження проблем з проксі

Журнал мережі

У консолі ви можете побачити:
- З'єднання з проксі
- Запит CONNECT (для HTTPS)
- Відповідь проксі
- Остаточна відповідь сервера

Поширені проблеми

"Не вдалося отримати відповідь"

• Перевірте адресу та порт проксі
• Переконайтеся, що проксі працює
• Перевірте, чи не блокує брандмауер з'єднання з проксі

Помилка SSL через проксі

• Вимкніть перевірку SSL у налаштуваннях
• Або додайте сертифікат CA проксі
• Для проксі-перехоплювача (Fiddler) встановіть його сертифікат CA

407 Потрібна автентифікація проксі

• Увімкніть автентифікацію в налаштуваннях проксі
• Перевірте ім'я користувача та пароль
• Переконайтеся, що проксі підтримує Basic auth

Висновок

Postman пропонує гнучкі налаштування проксі для різних сценаріїв: від корпоративних проксі до налагодження через проксі-перехоплювач. Підтримка SSL-сертифікатів, змінних середовища та CLI (Newman) робить роботу з проксі зручною як у графічному інтерфейсі, так і в автоматизованих конвеєрах.