summaryrefslogtreecommitdiff
path: root/transport.h
diff options
context:
space:
mode:
authorJeff King <peff@peff.net>2015-09-16 13:12:52 -0400
committerJunio C Hamano <gitster@pobox.com>2015-09-23 11:35:48 -0700
commita5adaced2e13c135d5d9cc65be9eb95aa3bacedf (patch)
treee4ad0544170f80c65ee073d08d2974780be5d5df /transport.h
parentecad27cf98c391d5cfdc26ce0e442e02347baad0 (diff)
downloadgit-a5adaced2e13c135d5d9cc65be9eb95aa3bacedf.tar.gz
transport: add a protocol-whitelist environment variable
If we are cloning an untrusted remote repository into a sandbox, we may also want to fetch remote submodules in order to get the complete view as intended by the other side. However, that opens us up to attacks where a malicious user gets us to clone something they would not otherwise have access to (this is not necessarily a problem by itself, but we may then act on the cloned contents in a way that exposes them to the attacker). Ideally such a setup would sandbox git entirely away from high-value items, but this is not always practical or easy to set up (e.g., OS network controls may block multiple protocols, and we would want to enable some but not others). We can help this case by providing a way to restrict particular protocols. We use a whitelist in the environment. This is more annoying to set up than a blacklist, but defaults to safety if the set of protocols git supports grows). If no whitelist is specified, we continue to default to allowing all protocols (this is an "unsafe" default, but since the minority of users will want this sandboxing effect, it is the only sensible one). A note on the tests: ideally these would all be in a single test file, but the git-daemon and httpd test infrastructure is an all-or-nothing proposition rather than a test-by-test prerequisite. By putting them all together, we would be unable to test the file-local code on machines without apache. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'transport.h')
-rw-r--r--transport.h7
1 files changed, 7 insertions, 0 deletions
diff --git a/transport.h b/transport.h
index 3e0091eaab..f7df6ec1d2 100644
--- a/transport.h
+++ b/transport.h
@@ -132,6 +132,13 @@ struct transport {
/* Returns a transport suitable for the url */
struct transport *transport_get(struct remote *, const char *);
+/*
+ * Check whether a transport is allowed by the environment,
+ * and die otherwise. type should generally be the URL scheme,
+ * as described in Documentation/git.txt
+ */
+void transport_check_allowed(const char *type);
+
/* Transport options which apply to git:// and scp-style URLs */
/* The program to use on the remote side to send a pack */