Wfquery

From Wiki of WFilter NG Firewall
(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
{{DISPLAYTITLE:Internet Usage}}
+
{{DISPLAYTITLE:Internet Usage Monitoring}}
= Recording Policy =
+
== Internet Usage Monitoring ==
* 设置需要记录的内容,如果应用对象对应了多个记录级别,则对应的记录级别一起生效。
+
The "Internet Usage Monitoring" module records internet activities, including:
== Record Content ==
+
* Web Surf
 +
* Web Post
 +
* HTTPS Inspection
 +
* Outgoing Emails
 +
* Incoming Emails
 +
* SSL Email Inspection
 +
 
 +
This module works both in "gateway mode" and "bridge mode". Enterprise license is required.
 +
 
 +
== Recording Policy ==
 +
 
 +
For every client, multiple policies can be applied. For example:
 +
* A policy: record web surfing for a whole subnet.
 +
* B policy: enable "https inspection" for a special IP in this subnet.
 +
For this ip, both "web surfing recording" and "https inspection" will be enabled.
 +
 
 +
Besides the applied to "clients" and "time", detailed "recording policy" settings are described in below.
 +
 
 
=== Web Recording ===
 
=== Web Recording ===
<p>'''Web Surf''':记录访问的web网页标题,该功能不能记录https网站的页面标题(只记录域名),如需记录https网页的页面标题,请启用“HTTPS监控”。</p>
+
* '''Web Surf''': record titles of visited web pages for http websites. For https websites, only domains will be recorded. To record https webpages, please enable "HTTPS Inspector".
<p>'''Web Post''':记录通过网页发送的内容,比如论坛发帖、网页附件上传等。可以对记录内容的大小进行设置。该功能不能记录https网站的发送内容,如需记录https网页的发送内容,请启用“HTTPS监控”。</p>
+
* '''Web Post''': record web post content for http websites. To record https web posts, you need to enable "HTTPS Inspector".
<p>'''HTTPS Inspector''':该功能可以监控https网站的网页浏览和网页粘贴的内容。HTTPS监控基于中间人拦截的技术,会把https网站的原始证书替换掉,从而解密其内容。为了使客户机的浏览器不提示证书告警信息,您可以在“高级配置”中下载证书并导入客户机的“受信任的根证书颁发机构”。</p>
+
* '''Web Post Size Limit''': no recording of web post exceeds size limit.
<p>'''Smart Filter''':自动过滤掉非人工访问的网址。该功能由程序自动进行判断,可以有效过滤掉一些非人工访问的网站,不过不能100%过滤掉。</p>
+
* '''HTTPS Inspector''': This feature enables you to inspect surfing and posting content for https websites. Please check: [[#SSL Inspection]]
<p>'''Domains Exception''':任何与配置在列表中的域名有关的内容将不被记录。</p>
+
* '''Smart Filter''': With this feature enabled, WFilter will not record visits by non-human. (Not 100% accurate)
[[File:Wfrecorder_setweb_en.jpg]]
+
* '''Domains Exception''': no recording of domains in the exception list. Wildcards "*?" are supported.
 +
[[File:Wfrecorder_setweb_en.jpg|650px]]
  
 
=== Email Recording ===
 
=== Email Recording ===
<p>'''Outgoing Emails''':记录发送的邮件内容,支持SMTP、POP3、IMAP4和发送的网页邮件。如需记录SSL邮件,您需要启用“SSL邮件监控”功能。否则不记录通过SSL加密的客户端邮件内容。超过大小限制的邮件不会被记录。</p>
+
 
<p>'''Incoming Emails''':记录接收的邮件内容,支持SMTP、POP3、IMAP4。如需记录SSL邮件,您需要启用“SSL邮件监控”功能。否则不记录通过SSL加密的客户端邮件内容。超过大小限制的邮件不会被记录。</p>
+
[[File:Wfrecorder_sermail_en.jpg|650px]]
<p>'''SSL Emails Inspector''':该功能用于监控SSL加密的客户端邮件,如需监控https的网页邮件,需要启用“HTTPS监控”功能。同“HTTPS监控”功能用于,“SSL邮件监控”会替换掉原始证书,从而导致某些邮件客户端产生告警信息。</p>
+
 
[[File:Wfrecorder_sermail_en.jpg]]
+
* Emails exceed size limit will not be recorded.
 +
* Emails supported: SMTP, POP3, IMAP4 and outgoing web-based emails.
 +
* If "SSL Emails Inspector" is disabled, only plain SMTP, POP3, IMAP4 and http web-based emails can be recorded.
 +
* To record ssl emails(SMTP/POP/IMAP over SSL), you need to enable "SSL Emails Inspector" option. Please check: [[#SSL Inspection]]
 +
* STARTTLS of SMTP/POP3/IMAP can not be recorded.
  
 
== Advanced Settings ==
 
== Advanced Settings ==
* 该页面可以对一些高级的选项进行设置。
+
 
 
[[File:Wfrecorder_advanced_en.jpg]]
 
[[File:Wfrecorder_advanced_en.jpg]]
 +
 
=== SSL Certificate ===
 
=== SSL Certificate ===
* 可以查看当前证书的信息,并且重新生成证书和下载证书。该证书会用于在“SSL监控”中替换网站的现有证书,您可以下载该证书并导入到客户机的“受信任的根证书颁发机构”,从而使客户机浏览器不再出现证书告警。
+
* This "SSL Certificate" will replace remote server's certificate for SSL interception.
<p>'''Replace''':填写相对应的信息后,会根据填写的信息生成一个证书,其中“国家”,“省份”,“城市”,“组织”和“通用名”是必填项,填写时只能输入英文字符。</p>
+
* When "HTTPS Inspector" is enabled, there will be a certificate warning in the client browser. You may download and import this certificate into "trusted root certification authorities store" to silence client browser.
<p>'''Download''':可以下载当前证书,导入到客户机的“受信任的根证书颁发机构”后,客户机浏览器不再出现证书告警。</p>
+
* You can click "Replace" to generate a new certificate.
[[File:Wfrecorder_setcrt_en.jpg]]
+
  
 
=== System ===
 
=== System ===
<p>'''Enable Debug''':可以开启调试模式并查看日志文件进行调试。</p>
+
* '''Enable Debug''': write debug logs for diagnose.
<p>'''Monitoring Cache''':用于监控和记录的缓存区域大小,需要根据被监控机器的台数和记录内容的多少去设置。</p>
+
* '''Monitoring Cache''': cache for packet monitoring.  On "Automatic", cache will be calculated according to WAN bandwidth defined in "Bandwidth"->"Shaper".
<p>'''Database Commit''':数据库提交频率。反复对数据库进行提交会占用大量系统资源,我们会根据修改的次数去进行提交,先将提交记录在临时文件中,满足配置的次数后再进行提交,可以减轻系统资源的消耗。</p>
+
* '''Database Commit''': reserved.
[[File:Wfrecorder_setsystem_en.jpg]]
+
 
 +
== SSL Inspection ==
 +
 
 +
SSL Inspection is based on [[https://en.wikipedia.org/wiki/Man-in-the-middle_attack|Man-in-the-middle attack]]. It redirects SSL connections to a local SSL server, so it can intercept the ssl traffic. Though it can decode SSL traffic, there are some disadvantages you should know:
 +
* Performance issue. Please check:[[SSL_Performance|SSL Inspector Performance]]
 +
* Certificate warning issue. With https inspector enabled, there will be certificate warning. To silence client browser, please follow below steps to import WFilter's certificate into "trusted root certification authorities store" in client devices.
 +
 
 +
=== HTTPS Inspector ===
 +
* There will be a certificate warning when visiting https websites. You may choose "continue to this website" to access this site, web surf and post will be recorded.
 +
[[File:Wfrecorder_cert_01.png|600px]]
 +
 
 +
To get rid of this certificate warning, please follow below steps:
 +
* Download WFilter's certificate
 +
[[File:Wfrecorder_cert_02.png|450px]]
 +
* Double click the "ca.crt" file, click "Install Certificate" and "Next". Enable "place all certificates in the following store" and choose "trusted root certification authorities". Then "Next" and "Finish".
 +
[[File:Wfrecorder_cert_03.png|450px]]
 +
* The certificate warning won't appear again.
 +
[[File:Wfrecorder_cert_04.png|600px]]
 +
* And this https visiting will be recorded.
 +
[[File:Wfrecorder_cert_05.png|600px]]
 +
 
 +
=== SSL Email Inspection ===
 +
There are three types of email connection.
 +
* Plain text, emails can be recorded without "SSL Email Inspection".
 +
* STARTTLS, even "SSL Email Inspection" can not record it.
 +
* SSL/TLS, with "SSL Email Inspection" enabled, emails via SSL connections can be recorded.
 +
 
 +
Let's take "Mozilla Thunderbird" as an example:
 +
 
 +
[[File:Wfrecorder_ssl_01.png]]
 +
 
 +
=== SSL Inspection for Mobile ===

Revision as of 18:10, 22 December 2015

Contents

1 Internet Usage Monitoring

The "Internet Usage Monitoring" module records internet activities, including:

  • Web Surf
  • Web Post
  • HTTPS Inspection
  • Outgoing Emails
  • Incoming Emails
  • SSL Email Inspection

This module works both in "gateway mode" and "bridge mode". Enterprise license is required.

2 Recording Policy

For every client, multiple policies can be applied. For example:

  • A policy: record web surfing for a whole subnet.
  • B policy: enable "https inspection" for a special IP in this subnet.

For this ip, both "web surfing recording" and "https inspection" will be enabled.

Besides the applied to "clients" and "time", detailed "recording policy" settings are described in below.

2.1 Web Recording

  • Web Surf: record titles of visited web pages for http websites. For https websites, only domains will be recorded. To record https webpages, please enable "HTTPS Inspector".
  • Web Post: record web post content for http websites. To record https web posts, you need to enable "HTTPS Inspector".
  • Web Post Size Limit: no recording of web post exceeds size limit.
  • HTTPS Inspector: This feature enables you to inspect surfing and posting content for https websites. Please check: #SSL Inspection
  • Smart Filter: With this feature enabled, WFilter will not record visits by non-human. (Not 100% accurate)
  • Domains Exception: no recording of domains in the exception list. Wildcards "*?" are supported.

Wfrecorder setweb en.jpg

2.2 Email Recording

Wfrecorder sermail en.jpg

  • Emails exceed size limit will not be recorded.
  • Emails supported: SMTP, POP3, IMAP4 and outgoing web-based emails.
  • If "SSL Emails Inspector" is disabled, only plain SMTP, POP3, IMAP4 and http web-based emails can be recorded.
  • To record ssl emails(SMTP/POP/IMAP over SSL), you need to enable "SSL Emails Inspector" option. Please check: #SSL Inspection
  • STARTTLS of SMTP/POP3/IMAP can not be recorded.

3 Advanced Settings

Wfrecorder advanced en.jpg

3.1 SSL Certificate

  • This "SSL Certificate" will replace remote server's certificate for SSL interception.
  • When "HTTPS Inspector" is enabled, there will be a certificate warning in the client browser. You may download and import this certificate into "trusted root certification authorities store" to silence client browser.
  • You can click "Replace" to generate a new certificate.

3.2 System

  • Enable Debug: write debug logs for diagnose.
  • Monitoring Cache: cache for packet monitoring. On "Automatic", cache will be calculated according to WAN bandwidth defined in "Bandwidth"->"Shaper".
  • Database Commit: reserved.

4 SSL Inspection

SSL Inspection is based on [attack]. It redirects SSL connections to a local SSL server, so it can intercept the ssl traffic. Though it can decode SSL traffic, there are some disadvantages you should know:

  • Performance issue. Please check:SSL Inspector Performance
  • Certificate warning issue. With https inspector enabled, there will be certificate warning. To silence client browser, please follow below steps to import WFilter's certificate into "trusted root certification authorities store" in client devices.

4.1 HTTPS Inspector

  • There will be a certificate warning when visiting https websites. You may choose "continue to this website" to access this site, web surf and post will be recorded.

Wfrecorder cert 01.png

To get rid of this certificate warning, please follow below steps:

  • Download WFilter's certificate

Wfrecorder cert 02.png

  • Double click the "ca.crt" file, click "Install Certificate" and "Next". Enable "place all certificates in the following store" and choose "trusted root certification authorities". Then "Next" and "Finish".

Wfrecorder cert 03.png

  • The certificate warning won't appear again.

Wfrecorder cert 04.png

  • And this https visiting will be recorded.

Wfrecorder cert 05.png

4.2 SSL Email Inspection

There are three types of email connection.

  • Plain text, emails can be recorded without "SSL Email Inspection".
  • STARTTLS, even "SSL Email Inspection" can not record it.
  • SSL/TLS, with "SSL Email Inspection" enabled, emails via SSL connections can be recorded.

Let's take "Mozilla Thunderbird" as an example:

Wfrecorder ssl 01.png

4.3 SSL Inspection for Mobile

Personal tools
Namespaces

Variants
Actions
Navigation
Tools