4704d464262d5b2a732be12e43f635b317380f52
[privoxy.git] / trust
1 ######################################################################
2 #
3 #  File        :  trust
4 #
5 #  Purpose     :  Trustfiles can be used to build "whitelists"
6 #                 (versus the usual "blacklists" techniques).
7 #
8 #  Copyright   :  Written by and Copyright
9 #                 Privoxy team. https://www.privoxy.org/
10 #
11 #                 Based on the Internet Junkbuster originally written
12 #                 by and Copyright (C) 1997 Anonymous Coders and
13 #                 Junkbusters Corporation.  http://www.junkbusters.com
14 #
15 # We value your feedback. However, to provide you with the best support,
16 # please note:
17 #
18 #  * Use the support forum to get help:
19 #    https://sourceforge.net/p/ijbswa/support-requests/
20 #  * Submit bugs only thru our bug forum:
21 #    https://sourceforge.net/p/ijbswa/bugs/
22 #    Make sure that the bug has not already been submitted. Please try
23 #    to verify that it is a Privoxy bug, and not a browser or site
24 #    bug first. If you are using your own custom configuration, please
25 #    try the stock configs to see if the problem is a configuration
26 #    related bug. And if not using the latest development snapshot,
27 #    please try the latest one. Or even better, git sources.
28 #  * Submit feature requests only thru our feature request tracker:
29 #    https://sourceforge.net/p/ijbswa/feature-requests/
30 #
31 # For any other issues, feel free to use the mailing lists.
32 # Anyone interested in actively participating in development and related
33 # discussions can join the appropriate mailing list here:
34 # https://lists.privoxy.org/mailman/listinfo. Archives are available
35 # here too.
36 #
37 ######################################################################
38 #
39 #                      Sample Trustfile for Privoxy
40
41 # For this file to have any effect, the line in the main config file beginning
42 # with "trustfile" must be uncommented, with the name of this file following the
43 # word "trustfile".
44
45 # Trustfiles are an experimental feature used for building "whitelists"
46 # of "trusted" sites (versus the usual "blacklists" technique). For more
47 # detail, see https://www.privoxy.org/user-manual/config.html#TRUSTFILE.
48
49 # List trusted domains here. The default is to block any URL that is NOT
50 # referenced. Access to trusted domains includes all paths within that
51 # domain.
52
53 # Preceding a domain with a '+' character will designate that domain
54 # as a "trusted referrer", meaning any requests whose HTTP "Referer" headers
55 # contain an URL from that domain will be allowed, and the previously untrusted
56 # host will be dynamically added to this file. Thus, this builds a "white-list"
57 # of hosts the user is allowed to visit.
58
59 # Note this means that the file will grow with use!
60
61 # Also note that you can only trust referrers if you control the user's
62 # system and make sure that there are no programs available that allow
63 # to set arbitrary headers.
64
65 # Preceding the domain with '~' character allows access to that domain only
66 # (including all paths within that domain), but does not allow access to links
67 # to other, outside domains. Sites that are added dynamically by trusted
68 # referrers will include the '~' character, and thus do not become trusted
69 # referrers themselves.
70
71 # Example: to allow example.com and to white-list domains that appear to
72 # be reached through links from example.com, uncomment this line:
73
74 # +example.com
75
76 # The next two lines make sure that the user can access Privoxy's
77 # CGI pages, without automatically trusting their links.
78
79 ~config.privoxy.org
80 ~p.p