Charles Proxy

Як налаштувати Charles Proxy для тестування

Kostya avatar
Автор: Kostya
Оновлено протягом останнього тижня

Мотивація

У деяких тестах вам може знадобитися використання проксі-сервера для налагодження веб-протоколу, щоб реєструвати трафік даних між пристроєм, який використовується для тестування, та інтернетом. Один з інструментів, який використовується для цієї мети, називається Charles Proxy, і вам може знадобитися його використання під час тестування з деякими нашими клієнтами. Процес встановлення та налаштування Charles Proxy описано нижче

Перший крок: Налаштування Charles Proxy на вашому комп'ютері

Для тестування як веб, так і додатків вам знадобиться комп'ютер і встановлена на ньому програма Charles Proxy.

  1. Завантажте пробну версію проксі-сервера Charles, яка відповідає вашій комп'ютерній системі тут.

  2. Встановіть проксі-програму Charles.

  3. У додатку Charles перейдіть до пункту меню Проксі > Налаштування зовнішнього проксі....

  4. Встановіть прапорець Використовувати зовнішні проксі-сервери.

  5. Встановіть галочку для веб-проксі (HTTP) і галочку Проксі-серверу потрібен пароль.

    Введіть дані про проксі, як показано нижче:

    1. Веб-проксі сервер: forward.test.io:3128

    2. Домен: forward.test.io

    3. Ім'я користувача: ви можете знайти цю інформацію в описі тесту.

    4. Пароль: ви можете знайти цю інформацію в описі тесту.

  6. Встановіть прапорець Безпечний веб-проксі (HTTPS) і поставте галочку Проксі-сервер вимагає пароль. Повторіть заповнення полів з попереднього кроку.

  7. Натисніть кнопку OK, щоб зберегти налаштування.

Проксі Test IO тепер коректно збережено як зовнішній проксі у вашому додатку Charles Proxy.

Встановлення SSL-сертифіката на комп'ютері з Windows

Перш ніж спробувати перейти на веб-сайт клієнта, який ви хочете протестувати, ви повинні встановити SSL-сертифікат на свій пристрій, щоб інтернет-трафік міг правильно перехоплюватися.

Передумова: Ви встановили та налаштували Charles Proxy на своєму комп'ютері.

  1. Запустіть програму Charles Proxy на своєму комп'ютері.

  2. У меню перейдіть до Довідка > Проксі-сервер SSL > Встановити кореневий сертифікат Charles.

  3. Натисніть Встановити сертифікат... і виберіть Поточний користувач.

  4. Натисніть кнопку Далі. Вам буде запропоновано вибрати місце зберігання сертифікатів у вашій системі.

  5. Виберіть пункт Помістити всі сертифікати у наступне сховище і натисніть кнопку Огляд...

  6. Виберіть Довірені кореневі центри сертифікації і натисніть кнопку OK.

  7. Натисніть кнопку Далі, а потім кнопку Готово.

  8. Перезавантажте комп'ютер, щоб завершити встановлення.

Тепер SSL-сертифікат Charles Proxy повністю встановлений на вашому пристрої.

Налаштування пристрою iOS

Передумова: Ви встановили та налаштували Charles Proxy на своєму комп'ютері.

  1. Переконайтеся, що ваш мобільний пристрій і комп'ютер підключені до однієї мережі WiFi.

  2. Запустіть програму Charles Proxy на вашому комп'ютері.

  3. У меню перейдіть до пункту Допомога > SSL-Proxying > Встановити кореневий сертифікат Charles на мобільному пристрої або віддаленому браузері.

    Відкриється вікно, в якому буде вказано вашу локальну IP-адресу і порт для використання.

  4. На вашому пристрої iOS перейдіть до налаштувань Wi-Fi і натисніть синю іконку "i" поруч з вашим Wi-Fi..

  5. У нижній частині екрана натисніть Налаштувати проксі і виберіть опцію Вручну.

  6. Введіть локальну IP-адресу в поле "Сервер" і порт, вказаний у додатку Charles Proxy на кроці 3.

  7. Збережіть налаштування > На вашому комп'ютері має з'явитися діалогове вікно з проханням дозволити цей новий доступ.

  8. Дайте дозвіл.

Інтернет-трафік вашого пристрою тепер спрямовується через Charles Proxy. Відтепер інтернет на вашому пристрої працюватиме лише тоді, коли програма Charles Proxy відкрита на вашому комп'ютері.

Встановлення SSL-сертифікату на iOS

Before you attempt to launch the customer app you want to test, you must install an SSL certificate on your device so the internet traffic can be correctly captured.

Передумови:

  1. Перейдіть за адресою chls.pro/ssl за допомогою браузера Safari на вашому мобільному пристрої. На вашому пристрої має з'явитися діалогове вікно з проханням встановити SSL-сертифікат.

  2. Дозвольте встановити сертифікат. Має з'явитися діалогове вікно з поясненням, що ви маєте переглянути профіль у програмі "Налаштування" на вашому пристрої.

  3. Закрийте модальне вікно і браузер Safari.

  4. Перейдіть до програми "Налаштування" на вашому пристрої та перейдіть за шляхом Загальні > VPN та керування пристроями > Завантажений профіль і виберіть Charles Proxy CA.

  5. Натисніть Встановити, щоб встановити сертифікат на ваш пристрій. Вам буде запропоновано ввести пароль вашого пристрою. Після успішної автентифікації буде показано попереджувальне вікно. Натисніть Встановити, щоб завершити встановлення сертифіката.

  6. З'явиться вікно підтвердження встановлення профілю. Просто натисніть Готово.

  7. Поверніться до підменю Налаштування > Загальні та перейдіть до розділу Про компанію > Налаштування довіри до сертифікатів.

  8. Увімкніть сертифікат Charles Proxy CA.

  9. З'явиться вікно з попередженням. Натисніть кнопку Продовжити.

Тепер SSL-сертифікат Charles Proxy повністю встановлений на вашому пристрої.

Налаштування пристрою Android

Передумова: Ви встановили та налаштували Charles Proxy на своєму комп'ютері.

  1. Переконайтеся, що ваш мобільний пристрій і комп'ютер знаходяться в одній мережі WiFi.

  2. Запустіть програму Charles Proxy на вашому комп'ютері.

  3. У меню перейдіть до Довідка > SSL-проксінг > Встановити кореневий сертифікат Charles на мобільному пристрої або віддаленому браузері. Відкриється вікно, в якому буде вказано вашу локальну IP-адресу і порт, який потрібно використовувати.

  4. На пристрої Android перейдіть до налаштувань Wi-Fi і виберіть редагування поточної мережі.

  5. Знайдіть опцію Проксі та виберіть Вручну.

  6. Введіть локальну IP-адресу в поле Ім'я хоста проксі-сервера і порт, вказаний у додатку Charles Proxy на кроці 3.

  7. Збережіть налаштування > На вашому комп'ютері має з'явитися діалогове вікно з проханням дозволити цей новий доступ.

  8. Дайте дозвіл.

Інтернет-трафік вашого пристрою тепер спрямовується через Charles Proxy. Відтепер інтернет на вашому пристрої працюватиме лише тоді, коли програма Charles Proxy відкрита на вашому комп'ютері.

Встановлення SSL-сертифікату на Android 10 або новішої версії

Передумови:

Перш ніж спробувати запустити клієнтську програму, яку ви хочете протестувати, ви повинні встановити SSL-сертифікат на своєму пристрої, щоб інтернет-трафік міг правильно перехоплюватися, виконавши наступні кроки:

  1. Перейдіть за адресою chls.pro/ssl за допомогою браузера Chrome на вашому мобільному пристрої. На ваш пристрій почнеться завантаження файлу сертифіката у форматі "*.crt".

  2. Відкрийте завантажений файл і пройдіть автентифікацію.

  3. Назвіть сертифікат будь-яким ім'ям і переконайтеся, що в розділі Використання облікових даних вибрано опцію VPN і додатки.

  4. Натисніть на OK.

Тепер SSL-сертифікат Charles Proxy повністю інстальовано на вашому пристрої.

Встановлення SSL-сертифікату на Android 11+

Перш ніж спробувати запустити клієнтську програму, яку ви хочете протестувати, ви повинні встановити SSL-сертифікат на своєму пристрої, щоб інтернет-трафік міг правильно перехоплюватися, виконавши наступні кроки:

Передумови:

  1. Перейдіть за адресою chls.pro/ssl за допомогою браузера Chrome на вашому мобільному пристрої. На ваш пристрій почнеться завантаження файлу сертифіката у форматі "*.crt".

  2. Після завантаження файлу перейдіть до програми Налаштування пристрою і знайдіть аналогічну опцію Встановити зі сховища пристрою (зазвичай вона знаходиться в налаштуваннях розширеної безпеки на вашому пристрої).

  3. Виберіть CA Certificate, а потім Встановити все одно, якщо з'явиться попереджувальний екран.

  4. Пройдіть автентифікацію та знайдіть завантажений файл "*.crt".

  5. Виберіть завантажений файл і натисніть Готово.

Тепер SSL-сертифікат Charles Proxy повністю встановлений на вашому пристрої.

Захоплення журналу (log)

Передумова: Переконайтеся, що ви встановили і налаштували Charles Proxy на вашому комп'ютері, як описано вище. Також переконайтеся, що на пристрої, який ви використовуєте для тестування, правильно встановлено SSL-сертифікат.

Передумови:

  • Захоплення журналу трафіку вашого комп'ютера: Переконайтеся, що опція Windows Proxy в пункті меню Проксі увімкнена.

  • Захоплення журналу мобільного трафіку: Переконайтеся, що опція Windows Proxy в пункті меню Проксі вимкнена.

Примітка: Завжди переконайтеся, що до Charles Proxy під час запису журналу підключено лише один пристрій, інакше дані про трафік з усіх пристроїв будуть записані до вашого журналу.

  1. Запустіть програму Charles Proxy на своєму комп'ютері.

  2. У меню перейдіть до Проксі > Налаштування проксі-сервера SSL...

  3. Переконайтеся, що ви встановили прапорець Увімкнути SSL-Proxying, і в розділі Включити натисніть кнопку Додати.

  4. Введіть сервер(и) клієнта, за якими ви хочете спостерігати, і порт (ця інформація буде надаватися в кожному циклі тестування).

  5. Натисніть OK, щоб повернутися до вікна Налаштування проксі-сервера SSL.

  6. Натисніть OK ще раз, щоб зберегти налаштування.

Тепер Charles proxy застосовуватиме SSL-проксі тільки до вибраного(их) сервера(ів). Щоб почати новий сеанс, ви повинні:

  1. Переконайтеся, що кнопка запису (червоне коло, розташоване прямо під головним меню програми Charles Proxy) увімкнена.

  2. Натисніть на іконку з пензлем, щоб очистити минулі журнали.

  3. Перейдіть до тестового середовища (або відкрийте клієнтську програму, або перейдіть на цільову сторінку веб-сайту).

  4. Відтворіть бажану поведінку (згадану в інструкціях циклу, звіті про помилку, історії користувача або тестовому кейсі).

  5. Закінчивши, вимкніть кнопку запису, щоб зупинити запис журналу.

  6. У меню перейдіть до пункту Файл > Зберегти сеанс як..., виберіть місце для збереження файлу, дайте йому належне ім'я і переконайтеся, що вибрано розширення Charles Session File (.chls).

Тепер ви можете зберегти файл журналу Charles Proxy і відправити його.

ПОШИРЕНІ ЗАПИТАННЯ

Як я можу переконатися, що Charles Proxy працює правильно?

  • Ви можете перевірити, чи працює Charles Proxy для певного сервера, відкривши програму Charles Proxy, натиснувши на сервер, який ви хочете перевірити, перейшовши до розділу Огляд > Інформація про нотатки, де для цього хоста має бути ввімкнено SSL-проксі для цього хоста.

  • Значення SSL Proxying для цього хоста не ввімкнено. Увімкнути в меню Проксі, Налаштування проксі-сервера означає, що ви не додали поточний сервер до списку проксі-серверів. Ви можете додати сервер вручну, відвідавши Налаштування проксі-сервера, або клацнути правою кнопкою миші на сервері і вибрати опцію Увімкнути проксі-сервер.

Примітка: Можливо, вам доведеться почати новий сеанс журналу, щоб застосувати нові налаштування.

Чи повинні скрінкасти, наведені в повідомленні про помилку, збігатися з журналами проксі-сервера Charles?

Як і при створенні журналу збоїв, якщо вам потрібно надати скрінкаст разом з журналом (наприклад, при відправці звіту про помилку), часові мітки журналу Charles Proxy і скрінкаст повинні збігатися, інакше ваш журнал буде недійсним.

Чи можна використовувати журнали Charles Proxy у звітах про аварії?

Журнали Charles Proxy не замінюють журнали збоїв, тому якщо ви повідомляєте про збій і використання Charles Proxy також є однією з вимог циклу, ви повинні додати обидва журнали до вашого звіту.

Я не можу знайти опцію встановлення SSL-сертифіката на моєму пристрої Android.

Розташування опції встановлення SSL-сертифіката на вашому Android буде відрізнятися залежно від пристрою. Ви можете скористатися функцією чату, доступною всередині кожного циклу, щоб попросити допомоги в пошуку цієї опції на вашому пристрої.

Чому мій інтернет не працює без Charles Proxy після того, як я успішно завершив навчання?

Якщо ви виконали всі згадані кроки, дані про трафік вашого пристрою будуть перенаправлені до комп'ютерного додатку Charles Proxy. Після завершення сеансу тестування ви можете закрити комп'ютерний додаток Charles Proxy і повернути налаштування проксі-сервера на вашому мобільному пристрої до значення "Немає" (Android) або "Вимкнено" (iOS). Таким чином ви закриєте з'єднання з комп'ютером, і ваш інтернет знову запрацює в звичайному режимі.

Додаток Charles Proxy закрився посеред сеансу. Що сталося?

Комп'ютерний додаток Charles Proxy можна використовувати не більше 30 хвилин, починаючи з моменту, коли ви його відкрили. Отже, якщо програма вже відкрита деякий час і ви виявили нову помилку, рекомендується закрити програму Charles Proxy і відкрити її знову, таким чином, 30-хвилинний ліміт буде обнулено і у вас буде час записати свій журнал.

У мене немає стаціонарного комп'ютера або підключення до WiFi. Чи можу я протестувати Charles Proxy?

На жаль, для збору логів Charles Proxy обов'язковою умовою є наявність комп'ютера з Windows, MacOS або Linux, підключеного до тієї ж мережі WiFi, до якої підключено ваш мобільний пристрій. Якщо ви не відповідаєте цій вимозі, ви повинні пропустити цикл.

Чому програма Charles Proxy не записує журнал мого браузера навіть після успішного налаштування?

Зазвичай VPN та інші системні програми або налаштування (наприклад, брандмауер або антивірусне програмне забезпечення) можуть перешкоджати роботі Charles Proxy. Ми рекомендуємо закрити всі VPN-з'єднання і видалити всі розширення браузера, щоб переконатися, що додаток Charles Proxy є єдиним проксі-сервером, пов'язаним з тестовим середовищем з вашого пристрою. Ви також можете використовувати інший браузер для моніторингу трафіку.

Ви отримали відповідь на своє запитання?