diff --git a/docs/src/content/concepts-certificates.md b/docs/src/content/concepts-certificates.md index 783575a7a..acf57a705 100644 --- a/docs/src/content/concepts-certificates.md +++ b/docs/src/content/concepts-certificates.md @@ -151,6 +151,27 @@ mitmproxy. Mitmproxy will then look for `mitmproxy-ca.pem` in the specified directory. If no such file exists, it will be generated automatically. +The `mitmproxy-ca.pem` certificate file has to look roughly like this: + + -----BEGIN PRIVATE KEY----- + + -----END PRIVATE KEY----- + -----BEGIN CERTIFICATE----- + + -----END CERTIFICATE----- + +When looking at the certificate with +`openssl x509 -noout -text -in ~/.mitmproxy/mitmproxy-ca.pem` +it should have at least the following X509v3 extensions so mitmproxy can +use it to generate certificates: + + X509v3 extensions: + X509v3 Key Usage: critical + Certificate Sign + X509v3 Basic Constraints: critical + CA:TRUE + + ## Using a client side certificate You can use a client certificate by passing the `--set client_certs=DIRECTORY|FILE`