X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Factions-file.html;h=a5a7d7a4e8b3cf531e20f45b8f8328bbd3ab100f;hp=db8dae24afd32b29e00265d8f294858d14cbc553;hb=2d1af75a04189057eb4cf4949908a3cdf9ca2b6e;hpb=2727c136ceb730015412df0cf32d8761ffe13930 diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index db8dae24..a5a7d7a4 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

@@ -394,6 +394,9 @@

While flexible, this is not the sophistication of full regular expression based syntax.

+

When compiled with FEATURE_PCRE_HOST_PATTERNS patterns can be prefixed with "PCRE-HOST-PATTERN:" in which case full regular expression (PCRE) can be used for the host + pattern as well.

8.4.2. The Path Pattern

@@ -1403,50 +1406,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 +1468,7 @@ www.example.com
-

8.5.17. fast-redirects

+

8.5.16. fast-redirects

Typical use:
@@ -1567,7 +1527,7 @@ www.example.com

To detect a redirection URL, fast-redirects only looks for the string "http://", either in plain text (invalid but often used) or encoded as "http%3a//". Some sites use their own URL encoding scheme, encrypt the address - of the target server or replace it with a database id. In theses cases fast-redirects is fooled and the request reaches the redirection server where it probably gets logged.

@@ -1589,7 +1549,7 @@ www.example.com
-

8.5.18. filter

+

8.5.17. filter

Typical use:
@@ -1665,8 +1625,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 +1634,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 +1643,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 +1652,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 +1661,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 +1686,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 +1703,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 +1712,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 +1721,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 +1730,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 +1739,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 +1748,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 +1757,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 +1782,8 @@ www.example.com
-
-                    +filter{fun}                 # Text replacements for subversive browsing fun!
+
+filter{fun}                 # Text replacements for subversive browsing fun!
@@ -1831,8 +1791,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 +1800,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 +1809,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 +1818,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 +1827,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 +1836,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 +1845,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 +1854,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 +1864,7 @@ www.example.com
-

8.5.19. force-text-mode

+

8.5.18. force-text-mode

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

8.5.20. forward-override

+

8.5.19. forward-override

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

8.5.21. +

8.5.20. handle-as-empty-document

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

-

8.5.22. handle-as-image

+

8.5.21. handle-as-image

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

8.5.23. +

8.5.22. hide-accept-language

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

-

8.5.24. +

8.5.23. hide-content-disposition

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

-

8.5.25. +

8.5.24. hide-if-modified-since

@@ -2349,7 +2309,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 +2360,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-

8.5.27. hide-referrer

8.5.26. hide-referrer
@@ -2481,7 +2441,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 +2501,53 @@ 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 HTTPS inspection 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.

+

This is an experimental feature.

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

8.5.29. ignore-certificate-errors

@@ -2564,11 +2571,14 @@ 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.

-

If the certificate is invalid the connection is aborted.

-

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

+

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

+

If the certificate can't be validated by Privoxy the connection is + aborted.

+

This action disables the certificate check so requests to sites with certificates that can't be + validated are allowed.

+

Note that enabling this action allows Man-in-the-middle attacks.

Example usage:
@@ -2728,8 +2738,9 @@ nasty-banner-server.example.com/junk.cgi\?output=trash action settings.

Note that some (rare) ill-configured sites don't handle requests for uncompressed documents correctly. Broken PHP applications tend to send an empty document body, some IIS versions only send the beginning of - the content. If you enable prevent-compression per default, you might want to - add exceptions for those sites. See the example for how to do that.

+ the content and some content delivery networks let the connection time out. If you enable prevent-compression per default, you might want to add exceptions for those sites. See the + example for how to do that.

Example usage (sections):