From e86ded841fdb3846b070a9cbe1793f72efe540aa Mon Sep 17 00:00:00 2001 From: Patrick Georgi Date: Mon, 9 Dec 2019 10:57:34 +0100 Subject: Documentation: Describe how to deal with snooping https proxies Disabling SSL verification is far from optimal, but depending on the circumstances may be the most practical way, so describe how to do that instead of leaving users confused. It's also not _that_ bad because git's hashing scheme should uncover most attempts to tamper with code, either when checking signed tags or when people push (and see lots of modified commits). State the command in a way that isn't conductive to careless copy & paste. Change-Id: Idbd52ba5d6e8b0f0e891fca16e4159ccef10771a Signed-off-by: Patrick Georgi Reviewed-on: https://review.coreboot.org/c/coreboot/+/37599 Tested-by: build bot (Jenkins) Reviewed-by: Paul Menzel Reviewed-by: Angel Pons --- Documentation/tutorial/part2.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Documentation/tutorial/part2.md b/Documentation/tutorial/part2.md index 3009e28167..43e9253fde 100644 --- a/Documentation/tutorial/part2.md +++ b/Documentation/tutorial/part2.md @@ -58,6 +58,20 @@ the password, and add the following to your `$HOME/.netrc` file: where YourUserNameHere is your username, and YourPasswordHere is the password you just generated. +If your system is behind a snooping HTTPS proxy, you might also have to +make its SSL certificate known to curl, a system specific operation. +If that's not possible for some reason, you can also disable SSL +certificate verification in git: + + git config [--global] http.sslVerify [true|false] + +The `--global` argument sets it for all git transfers of your local +user, `false` means not to validate the certificate. + +If that still doesn't allow you to pull or push changes to the server, the +proxy is likely tampering with the data stream, in which case there's nothing +we can do. + ## Part 3: Clone coreboot and configure it for submitting patches On Gerrit, click on the **Browse** tab in the upper left corner and select -- cgit v1.2.3