Version 3

    What is this

    This guide will demonstrate how to install and use mitmproxy, which is a helpful tool for troubleshooting connectivity and network issues with Jive Mobile and Jive Daily.

     

    Is Jive Support is unable to reproduce a mobile issue and it is believed that the issue may be caused by your specific wireless network configuration, then a Jive support agent may ask you to use this tool to help aid in the troubleshooting process.

     

    This tool is most often used for login and connectivity errors with Jive Mobile and Jive Daily.

     

    What is mitmproxy?

    An interactive console program that allows traffic flows to be intercepted, inspected, modified and replayed through your computer.

    mitmproxy2.gif

     

    mobile1.png   image+(1).png image+(2).png

     

    mitmproxy Installation

    From the terminal run:

     

    brew install mitmproxy 

     

    Screen+Shot+2016-03-28+at+2.43.42+PM.png

     

    Notice Brew provides the installation location: /usr/local/Cellar/mitmproxy/0.16.  This may be different for you make note of it.

     

    Validate that mitmproxy installed correctly by checking the version number:

     

     

    mitmproxy --version

    Screen+Shot+2016-03-28+at+2.46.12+PM.png

     

    Running mitmproxy

    Determine your network IP address using ifconfig:

     

    ifconfig 

    Screen+Shot+2016-03-28+at+3.03.34+PM.png

     

    In my example I will be using 10.61.32.52. Run mitmproxy using the following command:

    mitmproxy -b 10.61.32.52 -p 8889 

     

    Screen+Shot+2016-03-28+at+3.06.09+PM.png

     

    Your mitmproxy is now running.

     

    Configure your mobile device to go through mitmproxy

    Since you are going to be connecting to your local machine you will need to connect your mobile device to the same Wifi network that your computer is connected to. In the example screenshots below the wifi network is "Jive"

     

    Installing the mitmproxy CA certificate to view SSL traffic.

     

    Android

    Once you are connected to the Jive wifi network go to Settings > Wi-Fi on your device.  Long press the Jive SSID and click Modify network.  Scroll down to Advanced options.  Set Proxy to Manual and enter the proxy IP:port.  Click Save.

    ipandport.png

    Navigate to the website mitm.it from your mobile device.  If everything was configured correctly, you should see the following screen.

    mitmit.png

     

    Click on the icon for your device.  The certificate will download and prompt you to name the certificate.  Name the Certificate mitmproxy and under the "Credential use" drop down menu choose VPN and apps.  Click OK.

    image+(3).png

    You will now be able to see the Android mobile network traffic on your mitmproxy terminal window.

     

    IOS

    Once you are connected to the Jive wifi network go to Settings > Wi-Fi on your device.  Press the button next to the Jive SSID and select Manual under HTTP PROXY.  Enter the proxy Server and Port.

    image.jpg

    Navigate to the website mitm.it from your mobile device.  If everything was configured correctly, you should see the following screen.

    image+(1).jpg

    Select Install when prompted to install the mitmproxy certificate.

    image+(2).jpg

    You will now be able to see the IOS mobile network traffic on your mitmproxy terminal window.