Миграция с Charles Proxy
Таблица соответствия инструментов Charles и перенос записанной сессии через HAR по шагам: что переносится, что теряется и какие есть ограничения.
Что соответствует чему
Charles разложен по меню Tools; у Solpuga часть того же в меню Инструменты, часть в Настройках, часть в контекстном меню списка запросов. Где соответствия нет, стоит прочерк.
| Charles | Solpuga |
|---|---|
| Map Local | Локальная подмена |
| Breakpoints | Брейкпоинты |
| Rewrite | Перезапись, с импортом правил из Charles |
| SSL Proxying Settings: Include и Exclude | SSL-прокси: выбранные или все хосты, список исключений |
| Bypass Domains | Список исключений |
| Client Process | Приложение-источник |
| Focus | Закрепить хост |
| Copy cURL Request | Скопировать как cURL |
| Export Session → HAR | Экспорт HAR 1.2 |
| Import Session → HAR | Импорт HAR, только чтение |
| Структура по хостам | Группировка по хостам, приложениям и устройствам |
| Filter | Поиск, в том числе по телам, и фильтры |
| Timing | Тайминг по фазам |
| Корневой сертификат на мобильном устройстве | Мастера установки: iOS (на macOS) и Android |
| External Proxy Settings | Частично: только прокси системы или PAC, без авторизации |
| WebSocket | Частично: запись сообщений, без отправки |
| Map Remote | Частично: через «Перезапись» |
| Throttling | — |
| Repeat, Repeat Advanced, Compose | — |
| DNS Spoofing, Mirror, Auto Save, Block List | — |
| HTTP/2 | — |
| Скрипты | — |
Перенос сессий через HAR
Свой формат .chlz не читает ничто, кроме Charles, поэтому переносить надо через
HAR: Charles отдаёт его с версии 3.6, Solpuga открывает.
В Charles. File → Export Session… → формат HTTP Archive (.har) →
сохранить. Для части записи: выделить нужные запросы и
File → Export Selected Session….
В Solpuga. Меню Инструменты → Импорт сессии из HAR…
(Cmd/Ctrl + Shift + I), либо открыть .har из файлового менеджера. Файл
открывается в отдельном окне только для чтения со своим списком и
инспектором: живой перехват при этом не затрагивается, так что импортировать
чужую сессию можно не останавливая свою.
Ограничение одно: файлы больше 500 МБ не принимаются. Сессия Charles на сутки записи легко переваливает за эту границу — выгружайте выборкой.
Что переносится
Заголовки запроса и ответа, тела, статусы, тайминги — всё, что HAR 1.2 описывает. В импортированном окне работает тот же инспектор, что и в живом перехвате: JSON сворачивается деревом, изображения открываются с масштабом, двоичное — как hex. Тела и исходные сообщения можно сохранить в файлы.
Что теряется
Это ограничения формата, а не чьей-то реализации:
- Правила. Map Local, брейкпоинты и фильтры в HAR не входят вообще — формат описывает трафик, а не настройки. Правила придётся создать заново, и быстрее всего это делается из запроса в живом перехвате: правило заполняется тем ответом, который реально пришёл. В окне HAR правила не создаются. Правила Rewrite переносятся отдельно (см. ниже).
- WebSocket. В HAR для них нет места.
- Двоичные тела запросов. В HAR 1.2 у тела запроса нет поля кодировки:
Solpuga пишет такие тела в base64 и помечает своим полем
_encoding, а импортёр, который этого поля не знает, покажет base64 как текст. У других экспортёров свои пределы на размер. - Незавершённые запросы. В экспорте Solpuga их нет, а неудачные уезжают со
статусом
0. - Повторное распаковывание. Тела в HAR от Solpuga лежат расшифрованными и
распакованными, а заголовки ответа — такими, как пришли. Импортёр, который
верит
Content-Encoding, попробует распаковать второй раз. Если текст открылся мусором — дело в этом, а не в файле.
Перенос правил Rewrite
Правила Rewrite переносятся файлом.
В Charles. Tools → Import/Export Settings → вкладка Export → отметить
Rewrite → Export.
В Solpuga. Меню Инструменты → Перезапись → Импорт… → выбрать файл. Наборы правил переносятся с названиями и условиями. То, что перенести нельзя, Solpuga пропускает и сообщает об этом.
После импорта расшифровка HTTPS не включается: добавьте хосты из правил в Настройки → SSL-прокси.
Что взамен
Интерфейс на русском и английском и бесплатный тариф без ограничения по времени.