This tutorial is going to demonstrate how we can quickly capture the HTTPS Response and identify the bugs 🐞 on macOS, iPhone and iOS Simulator with Proxyman.
We hope Proxyman can boost your debugging productivity 👏.
1. Download Proxyman
2. Proxyman dashboard
Proxyman is designed by the way. There are three essential parts.
- Source List (Left Panel) is where all apps and domains are listed.
- Flow List (Middle Panel): All flows from the selected Source.
- Flow Content (Right Panel) is where you can see all Request/Response content.
As soon as you start the Proxyman, Proxyman will
- Automatically override the Wifi Proxy in Network Preference. It’s super convenience for you 👏. However, you can opt-out by navigating to Proxyman -> Preference… -> Uncheck the “Auto override the Proxy Config”
- Proxying all out-going requests from your mac, iPhone and iOS Simulators.
3. Search and Pin your app/domain
You could quickly search your app / domains by using “Ctrl+Shift+F” then selecting the “Pin” in the right menu.
Search and Pin your app/domain by Ctrl+Shift+F
We choose Product Hunt as the best example to demonstrate.
Distraction-free is a integral feature of Proxyman since all other domains are entirely ignored. You won’t get lost by the flooding of additional requests. That’s cool 👏
4. HTTPS Request & Response
We can quickly start viewing the HTTPS Response by
Select your desired domains or app
Select Enable SSL on Right-Panel
By enabling SSL for particular apps or domains, Proxyman doesn’t significantly affect the Internet Connections. Therefore, the speed connection is still maintained over 80%, and all SSL-Pining domains are still alive. This is great because we don’t want your Google Analytic or Dropbox’s connections are completely dropped during debugging with Proxyman ⚡️
5. Proxyman Certificate
We understand that this process is so complicated ❌ in other tools, so we dedicated re-design in order to simplify it. There are two options to do it.
- Automatic: It’s the useful approach for installing and trusting the Proxyman Certificate.
- Manual: You can install and trust manually. It’s your choice if you’re a super-user 👍
Install Proxyman Certificate panel
6. HTTPS Request and Response
After installing the Proxyman Certificate, it’s a perfect time to debug 😋. Proxyman is now capable of intercepting the HTTPS request & response and automatically display in pretty-JSON viewers.
From Flow-Content panel (Right-Panel), you can navigate too
- Header, Query, Cookies and JSON response
All content viewers are built-in with a native search bar. So you can manipulate or search the content by pressing Ctrl-F as usual 😺
Alternatively, even with your favorited Editor apps ❤️
7. Debug with different params
Proxyman is built-in with the useful collection of debugging tools:
- Repeat and Edit the requestRepeat: Repeat your request with current parameters => It’s super easy to try out your API, to make sure it works or not
- Edit & Repeat: Start editing the parameters => Test new context quickly. It’s useful when you want to know how the Backend responses with new request.
Try out new params
8. Export your current Session
You can export your current Proxyman Session and share with your teammates or QA team ❤️ From there, your co-workers could open and reproduce the bugs/issues immediately.
Or directly attach the log session to any Project Management like Jira, Trello.
9. Multiple Tabs
Proxyman take advantages of Cocoa Document-Based app, so you can working in different tab efficiently. More interesting, all tab hot-keys are consistent with Google Chrome and Safari, so you can increase your productivity significantly 🚀
- Ctrl+T to open a new Tab.
- Ctrl+Shift+ [ or ] to navigate tab forward or backward.
- Ctrl+1, 2, 3 (number) to quickly open specific tabs.
10. Where to Go From Here?
If you have any question or feature requests, don’t hesitate to open the ticket in our Github.