# 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** ![](/files/-M5lOSoKiG1qXJ0Tqh-L) ## 2. Solution There are many reasons why SSL Handshake Failed, please walk through the below steps to address the problem. ## 2.1 Mobile devices ### iOS Device * Follow this [iOS Setup Guide](/debug-devices/ios-device.md) -> Make sure you've installed & trusted the Proxyman CA Certificate on your device. * If you're intercepting some popular apps (e.g. Facebook, Instagram, Apple, Whatsapp, ...): They are protected by SSL Pinning -> Impossible to intercept them. * Verify that your iOS app doesn't have SSL Pinning. If yes, please disable it. ### iOS Simulator Follow this [iOS Simulator Setup Guide](/debug-devices/ios-simulator.md) -> Make sure you've installed & trusted the Proxyman CA Certificate on your device. ### Android Device * Follow this [Android Device Setup Guide](/debug-devices/android-device.md) -> Make sure you've installed & trusted the Proxyman CA Certificate on your device. * Verify that the 5th step is completed (by adding your domain to two files: **res/xml/network\_security\_config.xml** and **AndroidManifest.xml**) * If you're trying to intercept Android apps that you're not an owner -> It isn't possible to intercept -> ❌ ### Android Emulator * Follow this [Android Emulator Setup Guide](/debug-devices/android-device/automatic-script-for-android-emulator.md) -> Make sure you've installed & trusted the Proxyman CA Certificate on your device. * Verify that the 5th step is completed (by adding your domain to two files: **res/xml/network\_security\_config.xml** and **AndroidManifest.xml**) * If you're trying to intercept Android apps that you're not an owner -> It isn't possible to intercept -> ❌ ### React Native app * If your app is a React Native app, please follow the [React Native Guide](/debug-devices/react-native.md). ### Flutter * Please follow [Flutter Setup Guide](/debug-devices/flutter.md) If you've tried and verified all the above steps, but still get SSL Errors? ### Verify that you're able to see HTTPS Request/Response from without any errors 1. Get your devices 2. Open the Web Browser (Safari on iOS or Google Chrome on Android) 3. Visit **** 4. Select "Enable SSL Proxying" on this domain on the Proxyman app for macOS 5. Verify if you're able to see the HTTPS Response or not. #### ✅ Success 1. You're able to see HTTPS Response, which means you set up the Certificate correctly -> It's good ✅ 2. The problem might be from your apps. Let's try again on your domains/apps -> If the SSL Error still happens, a high chance that this app is protected by the SSL Pinning. 3. If you believe that it's not an SSL Pinning case, please open a ticket on [Github](https://github.com/ProxymanApp/Proxyman/issues) (Please mention what device, OS Version, app name, etc) #### ❌ Failed! * It seems Proxyman Certificate is not installed or trusted correctly in your devices. Please go back to the [2.1 Mobile Device](#2.1-mobile-devices) section and follow it. * If you verify that everything is done, but the SSL Error still happens, please open a ticket on [Github](https://github.com/ProxymanApp/Proxyman/issues) (Please mention what device, OS Version, app name, etc) ## 2.2 Macbook or Windows PC I get SSL Errors from: * **Mac devices (Macbook, Mac Mini, Mac Studio)** -> Install & Trust the Certificate on your Macbook -> Follow [macOS Guide](/debug-devices/macos.md) * **Windows** -> Install and trust the certificate on your Windows machine -> Follow [Windows guide](/proxyman-windows/install-certificate.md) * Java -> Follow [Java VM Guide](/debug-devices/java.md) * Firefox -> Follow [Firefox Guide](/debug-devices/firefox.md) * Python -> Follow [Python Guide](/debug-devices/python.md) * Ruby -> Follow [Ruby Guide](/debug-devices/ruby.md) {% hint style="warning" %} Some networking libraries (Ruby, NodeJS, Python, Golang) don't trust the self-signed certificate by default. We have to explicitly tell the library to trust the certificate. \=> To fix it, please google **"\ self-signed certificate",** a found some answers on StackOverflow. {% endhint %} ## 2.3 SSL-Pinning? * You're still unable to see HTTPS Response on your app, it seems that your app is protected by [SSL-Pinning](https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning), which prevents MitM apps from seeing the content. All popular apps (Facebook, Apple, Instagram, Messenger, etc.) have this feature. * Please temporarily **disable SSL-Pinning** and try again. Read more about SSL-Pining: {% hint style="info" %} If you've tried everything but are not sure what is wrong? Please open a [Github ticket](https://docs.proxyman.com/). Please also mention: Proxyman macOS/Windows, Proxyman version, your iOS/Android device, etc. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.proxyman.com/troubleshooting/get-ssl-error-from-https-request-and-response.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.