From c34d1e3de6483b1ab8a1a3add53fb84364c68249 Mon Sep 17 00:00:00 2001 From: Aldo Cortesi Date: Mon, 11 Mar 2013 11:49:36 +1300 Subject: Docs, examples. --- doc-src/certinstall/firefox.html | 24 ++++++++++++++---------- doc-src/certinstall/ios.html | 19 +++++++++++-------- doc-src/certinstall/osx.html | 13 ++++++++----- doc-src/certinstall/windows7.html | 29 +++++++++++++++++++++-------- 4 files changed, 54 insertions(+), 31 deletions(-) (limited to 'doc-src/certinstall') diff --git a/doc-src/certinstall/firefox.html b/doc-src/certinstall/firefox.html index a107aebc..2b299868 100644 --- a/doc-src/certinstall/firefox.html +++ b/doc-src/certinstall/firefox.html @@ -1,19 +1,23 @@ How to install the __mitmproxy__ certificate authority in Firefox: -### 1. If needed, copy the ~/.mitmproxy/mitmproxy-ca-cert.pem file to the target. +
    +
  1. If needed, copy the ~/.mitmproxy/mitmproxy-ca-cert.pem file to the target.
    2. -### 2: Open preferences, click on "Advanced", then select"Encryption": +
  2. Open preferences, click on "Advanced", then select"Encryption": + +
    3. - +
  3. Click "View Certificates", "Import", and select the certificate file: + +
    4. -### 3: Click "View Certificates", "Import", and select the certificate file: +
  4. Tick "Trust this CS to identify web sites", and click "Ok": + +
    5. - +
  5. You should now see the mitmproxy certificate listed in the Authorities + tab.
    6. -### 4: Tick "Trust this CS to identify web sites", and click "Ok": - - - -You should now see the mitmproxy certificate listed in the Authorities tab. +
diff --git a/doc-src/certinstall/ios.html b/doc-src/certinstall/ios.html index d306dfc6..81e2cce6 100644 --- a/doc-src/certinstall/ios.html +++ b/doc-src/certinstall/ios.html @@ -1,18 +1,21 @@ How to install the __mitmproxy__ certificate authority on IOS devices: -### 1: Set up the Mail app on the device to receive email. +
    +
  1. Set up the Mail app on the device to receive email.
    2. -### 2: Mail the mitmproxy-ca-cert.pem file to the device, and tap on the attachment. +
  2. Mail the mitmproxy-ca-cert.pem file to the device, and tap on the attachment.
    3. -### 3: You will be prompted to install a profile. Click "Install": +
  3. You will be prompted to install a profile. Click "Install": - +
    4. -### 4: Accept the warning by clicking "Install" again: +
  4. Accept the warning by clicking "Install" again: - +
    5. -### 5: The certificate should now be trusted: +
  5. The certificate should now be trusted: - +
    6. + +
diff --git a/doc-src/certinstall/osx.html b/doc-src/certinstall/osx.html index 465ada43..61e4be71 100644 --- a/doc-src/certinstall/osx.html +++ b/doc-src/certinstall/osx.html @@ -1,13 +1,16 @@ How to install the __mitmproxy__ certificate authority in OSX: -### 1: Open Finder, and double-click on the mitmproxy-ca-cert.pem file. +
    +
  1. Open Finder, and double-click on the mitmproxy-ca-cert.pem file.
    2. -### 2: You will be prompted to add the certificate. Click "Always Trust": +
  2. You will be prompted to add the certificate. Click "Always Trust": - + +
    3. -You may be prompted for your password. You should now see the mitmproxy cert -listed under "Certificates". +
  3. You may be prompted for your password. You should now see the + mitmproxy cert listed under "Certificates".
    4. +
diff --git a/doc-src/certinstall/windows7.html b/doc-src/certinstall/windows7.html index 7c2bb3ef..7a2414a2 100644 --- a/doc-src/certinstall/windows7.html +++ b/doc-src/certinstall/windows7.html @@ -1,19 +1,32 @@ How to install the __mitmproxy__ certificate authority in Windows 7: -### 1: Copy the ~/.mitmproxy/mitmproxy-ca-cert.p12 file to the target system. +
    -### 2: Double-click the certificate file. You should see a certificate import wizard: +
  1. Copy the ~/.mitmproxy/mitmproxy-ca-cert.p12 file to the target system.
    2. - +
  2. + Double-click the certificate file. You should see a certificate import wizard: -### 3: Click "Next" until you're prompted for the certificate store: + +
    3. - +
  3. + Click "Next" until you're prompted for the certificate store: -### 4: Select "Place all certificates in the following store", and select "Trusted Root Certification Authorities": + - +
    4. -### 5: Click "Next" and "Finish". + +
  4. +

    Select "Place all certificates in the following store", and select "Trusted Root Certification Authorities":

    + + + +
    5. + +
  5. Click "Next" and "Finish".
    6. + +
-- cgit v1.2.3 From b6727bf7d284cb51d765376e474dd93f44281730 Mon Sep 17 00:00:00 2001 From: Aldo Cortesi Date: Sun, 17 Mar 2013 10:35:40 +1300 Subject: Add instructions for installing the CA in the IOS Simulator. --- doc-src/certinstall/index.py | 1 + doc-src/certinstall/ios-simulator.html | 23 +++++++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 doc-src/certinstall/ios-simulator.html (limited to 'doc-src/certinstall') diff --git a/doc-src/certinstall/index.py b/doc-src/certinstall/index.py index 8ba3b7df..3f145fbc 100644 --- a/doc-src/certinstall/index.py +++ b/doc-src/certinstall/index.py @@ -5,5 +5,6 @@ pages = [ Page("osx.html", "OSX"), Page("windows7.html", "Windows 7"), Page("ios.html", "IOS"), + Page("ios-simulator.html", "IOS Simulator"), Page("android.html", "Android"), ] diff --git a/doc-src/certinstall/ios-simulator.html b/doc-src/certinstall/ios-simulator.html new file mode 100644 index 00000000..0cef63f8 --- /dev/null +++ b/doc-src/certinstall/ios-simulator.html @@ -0,0 +1,23 @@ + +How to install the __mitmproxy__ certificate authority in the IOS simulator: + +
    + +
  1. First, check out the ADVTrustStore tool + from github.
    2. + +
  2. Now, run the following command: + + 
    ./iosCertTrustManager.py -a ~/.mitmproxy/mitmproxy-ca-cert.pem
    + +
    3. + +
+ + +Note that although the IOS simulator has its own certificate store, it shares +the proxy settings of the host operating system. You will therefore to have +configure your OSX host's proxy settings to use the mitmproxy instance you want +to test with. + -- cgit v1.2.3 From 55ff7e8387d3ddbde8988261cbc6619318fbaed2 Mon Sep 17 00:00:00 2001 From: Aldo Cortesi Date: Sun, 17 Mar 2013 10:44:42 +1300 Subject: Update Android cert install documents. --- doc-src/certinstall/android.html | 29 +++++++++++------------------ 1 file changed, 11 insertions(+), 18 deletions(-) (limited to 'doc-src/certinstall') diff --git a/doc-src/certinstall/android.html b/doc-src/certinstall/android.html index 852938ce..e4efec1d 100644 --- a/doc-src/certinstall/android.html +++ b/doc-src/certinstall/android.html @@ -12,23 +12,21 @@ We used an Asus Transformer Prime TF201 with Android 4.0.3 in the examples below - your device may differ, but the broad process should be similar. -Installing the mitmproxy certificate -==================================== +## Getting the certificate onto the device -The first step is to install mitmproxy's interception certificate on the -Android device. In your ~/.mitmproxy directory, there is a file called -__mitmproxy-ca-cert.cer__ - we need to transfer this file to -__/sdcard/Downloads__ on the Android device. If this file doesn't exist for -you, your certs were generated with an older version of mitmproxy - just copy -the __mitmproxy-ca-cert.pem__ file to __mitmproxy-ca-cert.cer__ and proceed -from there. - -In this case, we're using wget from Better Terminal Emulator Pro to transfer -the certificate from a local HTTP server. Other terminal applications may work, -and you might also transfer the file via external media like an SDcard: +First we need to get the __mitmproxy-ca-cert.cer__ file into the +__/sdcard/Downloads__ folder on the device. There are a number of ways to do +this. If you have the Android Developer Tools installed, you can use [__adb +push__](http://developer.android.com/tools/help/adb.html) to accomplish this. +Depending on your device, you could also transfer the file using external media +like an SD Card. In this example, we're using wget from within a terminal +emulator to transfer the certificate from a local HTTP server: + +## Installing the certificate + Once we have the certificate on the local disk, we need to import it into the list of trusted CAs. Go to Settings -> Security -> Credential Storage, and select "Install from storage": @@ -46,8 +44,3 @@ store: -If you're lucky enough to be working with an app that obeys the wireless proxy -settings, you're just about done - simply configure the settings to point at -mitmproxy. If not, proceed to the next step... - - -- cgit v1.2.3 From 6614498744a45138adc770ef6e5882366b96b25e Mon Sep 17 00:00:00 2001 From: Aldo Cortesi Date: Mon, 18 Mar 2013 08:36:56 +1300 Subject: Update styling, GameCenter highscore tutorial. --- doc-src/certinstall/firefox.html | 2 +- doc-src/certinstall/ios-simulator.html | 2 +- doc-src/certinstall/ios.html | 2 +- doc-src/certinstall/osx.html | 2 +- doc-src/certinstall/windows7.html | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) (limited to 'doc-src/certinstall') diff --git a/doc-src/certinstall/firefox.html b/doc-src/certinstall/firefox.html index 2b299868..66fa9d79 100644 --- a/doc-src/certinstall/firefox.html +++ b/doc-src/certinstall/firefox.html @@ -1,7 +1,7 @@ How to install the __mitmproxy__ certificate authority in Firefox: -
    +
    1. If needed, copy the ~/.mitmproxy/mitmproxy-ca-cert.pem file to the target.
    2. Open preferences, click on "Advanced", then select"Encryption": diff --git a/doc-src/certinstall/ios-simulator.html b/doc-src/certinstall/ios-simulator.html index 0cef63f8..9eb98108 100644 --- a/doc-src/certinstall/ios-simulator.html +++ b/doc-src/certinstall/ios-simulator.html @@ -1,7 +1,7 @@ How to install the __mitmproxy__ certificate authority in the IOS simulator: -
        +
        1. First, check out the ADVTrustStore tool diff --git a/doc-src/certinstall/ios.html b/doc-src/certinstall/ios.html index 81e2cce6..fd14e65a 100644 --- a/doc-src/certinstall/ios.html +++ b/doc-src/certinstall/ios.html @@ -1,7 +1,7 @@ How to install the __mitmproxy__ certificate authority on IOS devices: -
            +
            1. Set up the Mail app on the device to receive email.
            2. Mail the mitmproxy-ca-cert.pem file to the device, and tap on the attachment.
              3. diff --git a/doc-src/certinstall/osx.html b/doc-src/certinstall/osx.html index 61e4be71..a532d538 100644 --- a/doc-src/certinstall/osx.html +++ b/doc-src/certinstall/osx.html @@ -1,7 +1,7 @@ How to install the __mitmproxy__ certificate authority in OSX: -
                +
                1. Open Finder, and double-click on the mitmproxy-ca-cert.pem file.
                  2. diff --git a/doc-src/certinstall/windows7.html b/doc-src/certinstall/windows7.html index 7a2414a2..47c807c6 100644 --- a/doc-src/certinstall/windows7.html +++ b/doc-src/certinstall/windows7.html @@ -1,7 +1,7 @@ How to install the __mitmproxy__ certificate authority in Windows 7: -
                    +
                    1. Copy the ~/.mitmproxy/mitmproxy-ca-cert.p12 file to the target system.
                      2. -- cgit v1.2.3