aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMichael J. Bazzinotti <mbazzinotti@gmail.com>2015-12-28 15:20:45 -0500
committerMichael J. Bazzinotti <mbazzinotti@gmail.com>2015-12-28 15:20:45 -0500
commit80690b79062c739fc8adfc725d39a68d4b65b43a (patch)
treee80e05eff05a690a0c7d76ba36b46cb4329c631f /docs
parent6391b05ef1b92585765eb77e352921ec61b65020 (diff)
downloadmitmproxy-80690b79062c739fc8adfc725d39a68d4b65b43a.tar.gz
mitmproxy-80690b79062c739fc8adfc725d39a68d4b65b43a.tar.bz2
mitmproxy-80690b79062c739fc8adfc725d39a68d4b65b43a.zip
[docs/libmproxy/test] Support single client-side cert file as argument to
--client-certs
Diffstat (limited to 'docs')
-rw-r--r--docs/certinstall.rst17
1 files changed, 14 insertions, 3 deletions
diff --git a/docs/certinstall.rst b/docs/certinstall.rst
index 5ec7b7ce..5a8cce64 100644
--- a/docs/certinstall.rst
+++ b/docs/certinstall.rst
@@ -175,10 +175,21 @@ no such file exists, it will be generated automatically.
Using a client side certificate
-------------------------------
-You can use a client certificate by passing the ``--client-certs DIRECTORY`` option to mitmproxy.
+You can use a client certificate by passing the ``--client-certs DIRECTORY|FILE``
+option to mitmproxy. Using a directory allows certs to be selected based on
+hostname, while using a filename allows a single specific certificate to be used for
+all SSL connections. Certificate files must be in the PEM format and should
+contain both the unencrypted private key and the certificate.
+
+Multiple certs by Hostname
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you've specified a directory to ``--client-certs``, then the following
+behavior will be taken:
+
If you visit example.org, mitmproxy looks for a file named ``example.org.pem`` in the specified
-directory and uses this as the client cert. The certificate file needs to be in the PEM format and
-should contain both the unencrypted private key and the certificate.
+directory and uses this as the client cert.
+
.. _Certificate Pinning: http://security.stackexchange.com/questions/29988/what-is-certificate-pinning/ \ No newline at end of file