X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Factions-file.html;h=f5a98de2db7cf46c68cb935f1385b2153e27a6dc;hb=0f3edd93a652011049e2bfc9b67947f92e236ef8;hp=db8dae24afd32b29e00265d8f294858d14cbc553;hpb=2727c136ceb730015412df0cf32d8761ffe13930;p=privoxy.git diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index db8dae24..f5a98de2 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -73,7 +73,7 @@

The default profiles, and their associated actions, as pre-defined in default.action are:

- +

Table 1. Default Configurations

@@ -1403,50 +1403,7 @@ problem-host.example.com
-

8.5.15. - enable-https-filtering

-
-
-
Typical use:
-
-

Filter encrypted requests and responses

-
-
Effect:
-
-

Encrypted requests are decrypted, filtered and forwarded encrypted.

-
-
Type:
-
-

Boolean.

-
-
Parameter:
-
-

N/A

-
-
Notes:
-
-

This action allows Privoxy to filter encrypted requests and - responses. For this to work Privoxy has to generate a certificate and - send it to the client which has to accept it.

-

Before this works the directives in the TLS section of the config file have - to be configured.

-
-
Example usage (section):
-
-
- - - -
-
{+enable-https-filtering}
-www.example.com
-
- - -
- -
-

8.5.16. external-filter

+

8.5.15. external-filter

Typical use:
@@ -1508,7 +1465,7 @@ www.example.com
-

8.5.17. fast-redirects

+

8.5.16. fast-redirects

Typical use:
@@ -1589,7 +1546,7 @@ www.example.com
-

8.5.18. filter

+

8.5.17. filter

Typical use:
@@ -1665,8 +1622,8 @@ www.example.com
-
-                    +filter{js-annoyances}       # Get rid of particularly annoying JavaScript abuse.
+
+filter{js-annoyances}       # Get rid of particularly annoying JavaScript abuse.
@@ -1674,8 +1631,8 @@ www.example.com
-
-                    +filter{js-events}           # Kill JavaScript event bindings and timers (Radically destructive! Only for extra nasty sites).
+
+filter{js-events}           # Kill JavaScript event bindings and timers (Radically destructive! Only for extra nasty sites).
@@ -1683,8 +1640,8 @@ www.example.com
-
-                    +filter{html-annoyances}     # Get rid of particularly annoying HTML abuse.
+
+filter{html-annoyances}     # Get rid of particularly annoying HTML abuse.
@@ -1692,8 +1649,8 @@ www.example.com
-
-                    +filter{content-cookies}     # Kill cookies that come in the HTML or JS content.
+
+filter{content-cookies}     # Kill cookies that come in the HTML or JS content.
@@ -1701,8 +1658,8 @@ www.example.com
-
-                    +filter{refresh-tags}        # Kill automatic refresh tags if refresh time is larger than 9 seconds.
+
+filter{refresh-tags}        # Kill automatic refresh tags if refresh time is larger than 9 seconds.
@@ -1726,8 +1683,8 @@ www.example.com
-
-                    +filter{img-reorder}         # Reorder attributes in <img> tags to make the banners-by-* filters more effective.
+
+filter{img-reorder}         # Reorder attributes in <img> tags to make the banners-by-* filters more effective.
@@ -1743,8 +1700,8 @@ www.example.com
-
-                    +filter{banners-by-link}     # Kill banners by their links to known clicktrackers.
+
+filter{banners-by-link}     # Kill banners by their links to known clicktrackers.
@@ -1752,8 +1709,8 @@ www.example.com
-
-                    +filter{webbugs}             # Squish WebBugs (1x1 invisible GIFs used for user tracking).
+
+filter{webbugs}             # Squish WebBugs (1x1 invisible GIFs used for user tracking).
@@ -1761,8 +1718,8 @@ www.example.com
-
-                    +filter{tiny-textforms}      # Extend those tiny textareas up to 40x80 and kill the hard wrap.
+
+filter{tiny-textforms}      # Extend those tiny textareas up to 40x80 and kill the hard wrap.
@@ -1770,8 +1727,8 @@ www.example.com
-
-                    +filter{jumping-windows}     # Prevent windows from resizing and moving themselves.
+
+filter{jumping-windows}     # Prevent windows from resizing and moving themselves.
@@ -1779,8 +1736,8 @@ www.example.com
-
-                    +filter{frameset-borders}    # Give frames a border and make them resizable.
+
+filter{frameset-borders}    # Give frames a border and make them resizable.
@@ -1788,8 +1745,8 @@ www.example.com
-
-                    +filter{iframes}             # Removes all detected iframes. Should only be enabled for individual sites.
+
+filter{iframes}             # Removes all detected iframes. Should only be enabled for individual sites.
@@ -1797,8 +1754,8 @@ www.example.com
-
-                    +filter{demoronizer}         # Fix MS's non-standard use of standard charsets.
+
+filter{demoronizer}         # Fix MS's non-standard use of standard charsets.
@@ -1822,8 +1779,8 @@ www.example.com
-
-                    +filter{fun}                 # Text replacements for subversive browsing fun!
+
+filter{fun}                 # Text replacements for subversive browsing fun!
@@ -1831,8 +1788,8 @@ www.example.com
-
-                    +filter{crude-parental}      # Crude parental filtering. Note that this filter doesn't work reliably.
+
+filter{crude-parental}      # Crude parental filtering. Note that this filter doesn't work reliably.
@@ -1840,8 +1797,8 @@ www.example.com
-
-                    +filter{ie-exploits}         # Disable some known Internet Explorer bug exploits.
+
+filter{ie-exploits}         # Disable some known Internet Explorer bug exploits.
@@ -1849,8 +1806,8 @@ www.example.com
-
-                    +filter{site-specifics}      # Cure for site-specific problems. Don't apply generally!
+
+filter{site-specifics}      # Cure for site-specific problems. Don't apply generally!
@@ -1858,8 +1815,8 @@ www.example.com
-
-                    +filter{no-ping}             # Removes non-standard ping attributes in <a> and <area> tags.
+
+filter{no-ping}             # Removes non-standard ping attributes in <a> and <area> tags.
@@ -1867,8 +1824,8 @@ www.example.com
-
-                    +filter{google}              # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement.
+
+filter{google}              # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement.
@@ -1876,8 +1833,8 @@ www.example.com
-
-                    +filter{yahoo}               # CSS-based block for Yahoo text ads. Also removes a width limitation.
+
+filter{yahoo}               # CSS-based block for Yahoo text ads. Also removes a width limitation.
@@ -1885,8 +1842,8 @@ www.example.com
-
-                    +filter{msn}                 # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation.
+
+filter{msn}                 # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation.
@@ -1894,8 +1851,8 @@ www.example.com
-
-                    +filter{blogspot}            # Cleans up some Blogspot blogs. Read the fine print before using this.
+
+filter{blogspot}            # Cleans up some Blogspot blogs. Read the fine print before using this.
@@ -1904,7 +1861,7 @@ www.example.com
-

8.5.19. force-text-mode

+

8.5.18. force-text-mode

Typical use:
@@ -1961,7 +1918,7 @@ www.example.com
-

8.5.20. forward-override

+

8.5.19. forward-override

Typical use:
@@ -2068,7 +2025,7 @@ TAG:^User-Agent: fetch libfetch/2\.0$
-

8.5.21. +

8.5.20. handle-as-empty-document

@@ -2121,7 +2078,7 @@ example.org/.*\.js$

-

8.5.22. handle-as-image

+

8.5.21. handle-as-image

Typical use:
@@ -2181,7 +2138,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-

8.5.23. +

8.5.22. hide-accept-language

@@ -2234,7 +2191,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash

-

8.5.24. +

8.5.23. hide-content-disposition

@@ -2290,7 +2247,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash

-

8.5.25. +

8.5.24. hide-if-modified-since

@@ -2349,7 +2306,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash

-

8.5.26. hide-from-header

+

8.5.25. hide-from-header

Typical use:
@@ -2400,7 +2357,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-

8.5.27. hide-referrer

8.5.26. hide-referrer
@@ -2481,7 +2438,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-

8.5.28. hide-user-agent

+

8.5.27. hide-user-agent

Typical use:
@@ -2541,6 +2498,51 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
+
+

8.5.28. https-inspection

+
+
+
Typical use:
+
+

Filter encrypted requests and responses

+
+
Effect:
+
+

Encrypted requests are decrypted, filtered and forwarded encrypted.

+
+
Type:
+
+

Boolean.

+
+
Parameter:
+
+

N/A

+
+
Notes:
+
+

This action allows Privoxy to filter encrypted requests and + responses. For this to work Privoxy has to generate a certificate and + send it to the client which has to accept it.

+

Before this works the directives in the TLS section of the config file have to be configured.

+

Note that the action has to be enabled based on the CONNECT request which doesn't contain a path. + Enabling it based on a pattern with path doesn't work as the path is only seen by Privoxy if the action is already enabled.

+
+
Example usage (section):
+
+ + + + +
+
{+https-inspection}
+www.example.com
+
+
+
+
+

8.5.29. ignore-certificate-errors

@@ -2564,9 +2566,9 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
Notes:
-

When the "+enable-https-filtering" action is used Privoxy by - default verifies that the remote site uses a valid certificate.

+

When the "+https-inspection" action is used Privoxy by default + verifies that the remote site uses a valid certificate.

If the certificate is invalid the connection is aborted.

This action disabled the certificate check allowing requests to sites with invalid certificates.