diff options
author | Aldo Cortesi <aldo@nullcube.com> | 2014-01-22 13:33:02 +1300 |
---|---|---|
committer | Aldo Cortesi <aldo@nullcube.com> | 2014-01-22 13:33:02 +1300 |
commit | 8f88fcedd601c0033b4469b66626a83011879baf (patch) | |
tree | 878b2c737f2483f52e7c222541483773af1c152a /doc-src/certinstall | |
parent | 7ddc941116852b191d80643af70af90a6fd8849c (diff) | |
download | mitmproxy-8f88fcedd601c0033b4469b66626a83011879baf.tar.gz mitmproxy-8f88fcedd601c0033b4469b66626a83011879baf.tar.bz2 mitmproxy-8f88fcedd601c0033b4469b66626a83011879baf.zip |
Move the doc tree out into its own repo.
Diffstat (limited to 'doc-src/certinstall')
-rw-r--r-- | doc-src/certinstall/android-settingssecurityinstallca.png | bin | 57723 -> 0 bytes | |||
-rw-r--r-- | doc-src/certinstall/android-settingssecuritymenu.png | bin | 75679 -> 0 bytes | |||
-rw-r--r-- | doc-src/certinstall/android-settingssecurityuserinstalledca.png | bin | 47263 -> 0 bytes | |||
-rw-r--r-- | doc-src/certinstall/android-shellwgetmitmproxyca.png | bin | 22198 -> 0 bytes | |||
-rw-r--r-- | doc-src/certinstall/android.html | 45 | ||||
-rw-r--r-- | doc-src/certinstall/firefox.html | 23 | ||||
-rw-r--r-- | doc-src/certinstall/index.py | 10 | ||||
-rw-r--r-- | doc-src/certinstall/ios-simulator.html | 23 | ||||
-rw-r--r-- | doc-src/certinstall/ios.html | 21 | ||||
-rw-r--r-- | doc-src/certinstall/osx.html | 16 | ||||
-rw-r--r-- | doc-src/certinstall/windows7.html | 32 |
11 files changed, 0 insertions, 170 deletions
diff --git a/doc-src/certinstall/android-settingssecurityinstallca.png b/doc-src/certinstall/android-settingssecurityinstallca.png Binary files differdeleted file mode 100644 index f0f97273..00000000 --- a/doc-src/certinstall/android-settingssecurityinstallca.png +++ /dev/null diff --git a/doc-src/certinstall/android-settingssecuritymenu.png b/doc-src/certinstall/android-settingssecuritymenu.png Binary files differdeleted file mode 100644 index fea412fe..00000000 --- a/doc-src/certinstall/android-settingssecuritymenu.png +++ /dev/null diff --git a/doc-src/certinstall/android-settingssecurityuserinstalledca.png b/doc-src/certinstall/android-settingssecurityuserinstalledca.png Binary files differdeleted file mode 100644 index 1f7717ad..00000000 --- a/doc-src/certinstall/android-settingssecurityuserinstalledca.png +++ /dev/null diff --git a/doc-src/certinstall/android-shellwgetmitmproxyca.png b/doc-src/certinstall/android-shellwgetmitmproxyca.png Binary files differdeleted file mode 100644 index 4a4e326f..00000000 --- a/doc-src/certinstall/android-shellwgetmitmproxyca.png +++ /dev/null diff --git a/doc-src/certinstall/android.html b/doc-src/certinstall/android.html deleted file mode 100644 index 9b0c5d71..00000000 --- a/doc-src/certinstall/android.html +++ /dev/null @@ -1,45 +0,0 @@ -The proxy situation on Android is [an -embarrasment](http://code.google.com/p/android/issues/detail?id=1273). It's -scarcely credible, but Android didn't have a global proxy setting at all until -quite recently, and it's still not supported on many common Android versions. -In the meantime the app ecosystem has grown used to life without this basic -necessity, and many apps merrily ignore it even if it's there. This situation -is improving, but in many circumstances using [transparent -mode](@!urlTo("transparent.html")!@) is mandatory for testing Android apps. - -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. - - -## Getting the certificate onto the device - -First we need to get the __mitmproxy-ca-cert.cer__ file into the -__/sdcard__ folder on the device (/sdcard/Download on older devices). 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: - -<img src="android-shellwgetmitmproxyca.png"/> - - -## 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": - -<img src="android-settingssecuritymenu.png"/> - -The certificate in /sdcard is automatically located and offered for -installation. Installing the cert will delete the download file from the local -disk: - -<img src="android-settingssecurityinstallca.png"/> - -Afterwards, you should see the certificate listed in the Trusted Credentials -store: - -<img src="android-settingssecurityuserinstalledca.png"/> - diff --git a/doc-src/certinstall/firefox.html b/doc-src/certinstall/firefox.html deleted file mode 100644 index 66fa9d79..00000000 --- a/doc-src/certinstall/firefox.html +++ /dev/null @@ -1,23 +0,0 @@ - -How to install the __mitmproxy__ certificate authority in Firefox: - -<ol class="tlist"> - <li> If needed, copy the ~/.mitmproxy/mitmproxy-ca-cert.pem file to the target. </li> - - <li>Open preferences, click on "Advanced", then select"Encryption": - <img src="@!urlTo('firefox3.jpg')!@"/> - </li> - - <li> Click "View Certificates", "Import", and select the certificate file: - <img src="@!urlTo('firefox3-import.jpg')!@"/> - </li> - - <li>Tick "Trust this CS to identify web sites", and click "Ok": - <img src="@!urlTo('firefox3-trust.jpg')!@"/> - </li> - - <li> You should now see the mitmproxy certificate listed in the Authorities - tab.</li> - -</ol> - diff --git a/doc-src/certinstall/index.py b/doc-src/certinstall/index.py deleted file mode 100644 index 3f145fbc..00000000 --- a/doc-src/certinstall/index.py +++ /dev/null @@ -1,10 +0,0 @@ -from countershape import Page - -pages = [ - Page("firefox.html", "Firefox"), - 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 deleted file mode 100644 index 9eb98108..00000000 --- a/doc-src/certinstall/ios-simulator.html +++ /dev/null @@ -1,23 +0,0 @@ - -How to install the __mitmproxy__ certificate authority in the IOS simulator: - -<ol class="tlist"> - - <li> First, check out the <a - href="https://github.com/ADVTOOLS/ADVTrustStore">ADVTrustStore</a> tool - from github.</li> - - <li> Now, run the following command: - - <pre class="terminal">./iosCertTrustManager.py -a ~/.mitmproxy/mitmproxy-ca-cert.pem</pre> - - </li> - -</ol> - - -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. - diff --git a/doc-src/certinstall/ios.html b/doc-src/certinstall/ios.html deleted file mode 100644 index fd14e65a..00000000 --- a/doc-src/certinstall/ios.html +++ /dev/null @@ -1,21 +0,0 @@ - -How to install the __mitmproxy__ certificate authority on IOS devices: - -<ol class="tlist"> - <li>Set up the Mail app on the device to receive email.</li> - - <li>Mail the mitmproxy-ca-cert.pem file to the device, and tap on the attachment.</li> - - <li>You will be prompted to install a profile. Click "Install": - - <img src="@!urlTo('ios-profile.png')!@"/></li> - - <li>Accept the warning by clicking "Install" again: - - <img src="@!urlTo('ios-warning.png')!@"/></li> - - <li>The certificate should now be trusted: - - <img src="@!urlTo('ios-installed.png')!@"/></li> - -</ol> diff --git a/doc-src/certinstall/osx.html b/doc-src/certinstall/osx.html deleted file mode 100644 index a532d538..00000000 --- a/doc-src/certinstall/osx.html +++ /dev/null @@ -1,16 +0,0 @@ - -How to install the __mitmproxy__ certificate authority in OSX: - -<ol class="tlist"> - - <li>Open Finder, and double-click on the mitmproxy-ca-cert.pem file.</li> - - <li>You will be prompted to add the certificate. Click "Always Trust": - - <img src="@!urlTo('osx-addcert-alwaystrust.png')!@"/> - </li> - - <li> You may be prompted for your password. You should now see the - mitmproxy cert listed under "Certificates".</li> -</ol> - diff --git a/doc-src/certinstall/windows7.html b/doc-src/certinstall/windows7.html deleted file mode 100644 index 47c807c6..00000000 --- a/doc-src/certinstall/windows7.html +++ /dev/null @@ -1,32 +0,0 @@ - -How to install the __mitmproxy__ certificate authority in Windows 7: - -<ol class="tlist"> - - <li> Copy the ~/.mitmproxy/mitmproxy-ca-cert.p12 file to the target system. </li> - - <li> - Double-click the certificate file. You should see a certificate import wizard: - - <img src="@!urlTo('win7-wizard.png')!@"/> - </li> - - <li> - Click "Next" until you're prompted for the certificate store: - - <img src="@!urlTo('win7-certstore.png')!@"/> - - </li> - - - <li> - <p>Select "Place all certificates in the following store", and select "Trusted Root Certification Authorities":</p> - - <img src="@!urlTo('win7-certstore-trustedroot.png')!@"/> - - </li> - - <li> Click "Next" and "Finish". </li> - -</ol> - |