# 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** ![](https://1856518738-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LlPt_6BePnJ3oK3saP1%2F-M5lO1HbZnnLbTXZtxBy%2F-M5lOSoKiG1qXJ0Tqh-L%2FScreen%20Shot%202020-04-25%20at%2019.52.38.png?alt=media\&token=81ddc918-1d2a-4023-a09a-0647858d65e0) ## 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](https://docs.proxyman.com/debug-devices/ios-device) -> 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](https://docs.proxyman.com/debug-devices/ios-simulator) -> Make sure you've installed & trusted the Proxyman CA Certificate on your device. ### Android Device * Follow this [Android Device Setup Guide](https://docs.proxyman.com/debug-devices/android-device) -> 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](https://docs.proxyman.com/debug-devices/android-device/automatic-script-for-android-emulator) -> 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](https://docs.proxyman.com/debug-devices/react-native). ### Flutter * Please follow [Flutter Setup Guide](https://docs.proxyman.com/debug-devices/flutter) 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](https://docs.proxyman.com/debug-devices/macos) * **Windows** -> Install and trust the certificate on your Windows machine -> Follow [Windows guide](https://docs.proxyman.com/proxyman-windows) * Java -> Follow [Java VM Guide](https://docs.proxyman.com/debug-devices/java) * Firefox -> Follow [Firefox Guide](https://docs.proxyman.com/debug-devices/firefox) * Python -> Follow [Python Guide](https://docs.proxyman.com/debug-devices/python) * Ruby -> Follow [Ruby Guide](https://docs.proxyman.com/debug-devices/ruby) {% 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://app.gitbook.com/o/-LlPtWiscJCRFiRPxWvB/s/-LlPt_6BePnJ3oK3saP1/). Please also mention: Proxyman macOS/Windows, Proxyman version, your iOS/Android device, etc. {% endhint %}