Proxyman으로 iOS 15 시뮬레이터 트래픽 검사하기
API 호출을 작업하다 보면 Xcode에는 아무 오류가 표시되지 않는데도 앱에 데이터가 나타나지 않았던 적이 있으신가요? 앱을 디버깅하려고 네트워크 호출을 검사하고 싶었던 적은 없으신가요? 이 튜토리얼에서는 Proxyman을 중간자(man-in-the-middle) 프록시로 사용해 iOS 시뮬레이터의 네트워크 트래픽을 캡처하고 검사하는 방법을 알아봅니다.
1. 사전 준비 사항
- 최신 버전의 Proxyman을 다운로드하고 설정합니다.
- Mac에서 Xcode 11.4 이상을 사용합니다.
2. 시작하기
-
이 튜토리얼에서는 디버깅 예제 앱으로 Alamofire를 사용합니다. 소스 코드는 여기에서 확인할 수 있습니다.
-
Proxyman을 다운로드해서 설치하면 네트워크 트래픽이 바로 Proxyman 창에 나타납니다.
Proxyman과 샘플 프로젝트가 모두 실행 중이지만, 아직 트래픽이 보이지 않습니다. 이제 시뮬레이터에 Proxyman 인증서를 설치해 봅시다!
3. iOS 시뮬레이터에 인증서 설치하기
탭 바 메뉴에서 Certificate -> Install Certificate on iOS -> Simulators를 선택합니다.
4. iOS 시뮬레이터에 Proxyman 인증서 설치 및 신뢰 설정하기
Proxyman은 수동 작업을 줄일 수 있도록 설정 가이드를 제공합니다. 설정 창에서 Install and Trust를 클릭하면 인증서가 자동으로 구성됩니다.
5. iOS 시뮬레이터 재부팅하기
그다음 시뮬레이터를 재부팅해야 합니다. Reboot를 클릭하기만 하면 됩니다... 이제 iOS 시뮬레이터의 네트워크 트래픽을 캡처할 준비가 끝났습니다.
6. 네트워크 트래픽 검사하기
인증서를 설치하고 시뮬레이터를 재부팅한 뒤에는 앱을 다시 실행하고 API 호출을 해 봅니다. Proxyman이 디버깅에 필요한 요청과 응답의 내용을 캡처해서 보여 줍니다.
7. 팁과 참고 사항
7.1 Proxyman은 실행 중인 시뮬레이터 개수를 감지할 수 있습니다
참고로 Proxyman은 실행 중인 시뮬레이터 개수를 자동으로 감지해서 알려 줍니다. 따라서 앱을 아직 실행하지 않았거나 실행을 중지했다면 창은 다음과 같이 나타납니다.
시뮬레이터를 2개 동시에 실행 중이라면 Proxyman이 이 사실도 알려 줍니다.
7.2 iOS 시뮬레이터의 트래픽이 보이지 않는다면 어떻게 하나요?
iOS 시뮬레이터에서 SSL 오류가 발생하거나 HTTP/HTTPS 요청이 보이지 않는다면, Proxyman 문서의 문제 해결 섹션을 확인해 문제가 해결되는지 살펴보세요. 그래도 해결되지 않는다면 주저하지 말고 이메일을 보내 주세요. 기꺼이 도와드리겠습니다.
8. 마무리
네트워크 호출을 다루는 일은 때때로 까다롭고 답답할 수 있지만, 이제 디버깅은 한결 쉬워질 것입니다. Proxyman이나 다른 mitm 프록시 도구는 iOS 시뮬레이터의 HTTP/HTTPS 트래픽을 캡처하고 검사하는 데 도움이 됩니다. 이 튜토리얼을 마치고 네트워크 전문가가 되고 싶다면, Map Local, Breakpoint, Scripting 도구처럼 Proxyman의 고급 기능을 다룬 시리즈도 확인해 보세요. 이 기능들을 사용하면 HTTP/HTTPS 요청과 응답을 수정할 수 있습니다.
이 튜토리얼이 도움이 되었기를 바랍니다. 즐거운 디버깅 되세요! 👨🏻🚀
도움이 되는 업데이트
같은 설정이 최신 iOS 시뮬레이터 버전에서도 동작합니다. 먼저 시뮬레이터를 부팅한 다음 Proxyman 인증서 설정을 실행합니다. 시뮬레이터를 지우거나 새로 만들거나 콘텐츠를 초기화했다면 인증서를 다시 설치합니다. 예상한 요청이 보이지 않으면 프록시 설정을 바꾸기 전에 새 요청을 보내고, 앱이 캐시된 응답을 반환했는지 확인합니다.
Proxyman은 iOS 기기, iOS 시뮬레이터, Android 기기에서 앱과 도메인의 HTTP(s) 트래픽을 캡처하고 검사할 수 있게 해 주는 고성능 macOS 앱입니다.
다운로드: https://proxyman.com/
