Proxyman Documentation
HomepagePricingBlogDownload
Search…
Overview
Changelog
License
License Manager
Command-line
Proxyman iOS
Proxyman for iOS
Debug on Devices
macOS
iOS Device
iOS Simulator
tvOS & watchOS
Android Device & Emulator
Firefox
Java VMs
Python
Ruby
React Native
Flutter
HTTP Clients
Docker
Atlantis
Atlantis for iOS
BASIC FEATURES
Proxyman Proxy Helper Tool
Request / Response Previewer
SSL Proxying
Import / Export
Content Filter
Multiple Tabs
Horizontal/Vertical/Window Layout
Copy as
Custom Previewer Tab
Custom Header Column
Regex (Regular Expression)
Filter JSON Response
Highlight by Color and Add Comment
Import / Export Settings
Multipart Form-Data Previewer
JSONPath
Customize Toolbar
ADVANCED FEATURES
Repeat
Edit & Repeat
Compose new Request
No Caching
Breakpoint
Breakpoint Templates
Map Local (File)
Map Local (Directory)
Map Remote
External Proxy
Save Session
Protobuf
WebSocket
Clear Session
Block List
Allow List
Charles Proxy Converter
Custom Certificates
GraphQL
Network Conditions
Multiple Filters
Publish to Gist
Reverse Proxy
Code Generator
Diff
Scripting
Scripting
async/await Request
Addons
Built-in JS Libraries
Write your own Addons
Snippet Code
Environment Variables
Troubleshooting
Proxyman does not work with VPN apps
My Remote Devices (iOS/Android) could not connect to Proxyman?
SSL Error from HTTPS Request/Response
I could not see any requests from my localhost server
*.local requests do not appear on Proxyman
I couldn't see any traffics on Proxyman
I couldn't see any requests from 3rd-party network libraries
[Breakpoint] Modify Request/Response by Raw Message
Could not change Proxyman App Icons
Lost data after updating Proxyman app?
Powered By GitBook
SSL Error from HTTPS Request/Response

1. Problems

  • You could not see any HTTPS traffic on the Proxyman app
  • You get SSL Error from HTTPS Requests and Responses
  • You get SSL Handshake Failed

2. Solution

There are many reasons why you see these SSL Errors, please follow the troubleshooting to find the root of problems:

2.1 Verify that you're able to see other HTTPS Request/Response without any errors

Let try to intercept https://google.com from the Safari app:
  1. 1.
    Open Safari on macOS or iOS Devices and open https://google.com
  2. 2.
    Select "Enable SSL Proxying" on this domain on the Proxyman app for macOS
  3. 3.
    Verify if you're able to see the HTTPS Response or not.

If success:

  1. 1.
    You're able to see https://google.com HTTPS Response, which means you set up the Certificate properly. It's good
  2. 2.
    The problem might be from your apps or devices. Let try again on your domains/apps -> If the SSL Error still happens, please verify:
  • If it's from your Remote Devices (iPhone/iPad or Android) or your code
=> Please follow the iOS Remote device Document again. Verify that you install and trust the certificate.
=> Some Android devices require extra configuration or try to run the sample project​
=> Verify if your app is protected with SSL-Pinning -> Try to disable it
  • If it's from iOS Simulator
=> Please follow the iOS Simulator => Try to install again and restart the simulator
  • If it's from Java Machine
=> Follow Java VMS guideline​
  • If it's from Firefox
=> Follow Firefox guideline ​
  • If you're using NodeJS, Ruby Rail Command-Line, or any networking libraries
=> Those libraries and frameworks might not trust Proxyman self-signed CA Certificate by default. Therefore, the certificate verification process might be failed.
=> To fix it, please google "<Your framework/library> self-signed certificate" (e.g Ruby Rail self-signed certificate).
References:
------------------------------
  • If you couldn't fix it
=> Open Github ticket or email us at [email protected]

If not:

Look like you set up a Proxyman Root Certificate on your mac machine is not correct.
  1. 1.
    Try to remove the current certificate by going to Preference -> Find the Certificate -> Click on Action button -> Delete
  2. 2.
    Install again: Certificate menu -> Install Certificate on Mac
  3. 3.
    Verify that your certificate is installed and trusted. You can see the green tick
  4. 4.
    Try again on your apps/domains
  • If you're trying to intercept an Android app that you're not a developer => You couldn't do it, since we have to add extra configurations to the Android project.
  • If you couldn't fix it
=> Open Github ticket or email us at [email protected]
If you still encounter the SSL Error even though you've already installed & trusted the Certificate on your iOS/Android devices, please try to restart your mobile devices.

2.2 SSL-Pinning

You're still unable to see HTTPS Response on your app, it seems that your app is protected by SSL-Pinning, which prevent MitM apps to see the content.
Please temporarily disable SSL-Pinning and try again.

2.3 Install Proxyman CA on Firefox

If you encounter the SSL Error on Firefox, it means that we need to install Proxyman CA into Firefox's Trust Store. Please read the Firefox installation page.​
Troubleshooting - Previous
My Remote Devices (iOS/Android) could not connect to Proxyman?
Next - Troubleshooting
I could not see any requests from my localhost server
Last modified 2mo ago
Copy link
Contents
1. Problems
2. Solution
2.1 Verify that you're able to see other HTTPS Request/Response without any errors
If success:
If not:
2.2 SSL-Pinning
2.3 Install Proxyman CA on Firefox