Sign In with your
Trend Micro Account
Need Help?
Need More Help?

Create a technical support case if you need further support.

Precautions when using InterScan Web Security Virtual Appliance (IWSVA) in ICAP mode

    • Updated:
    • 26 Nov 2018
    • Product/Version:
    • InterScan Web Security Virtual Appliance 6.5
    • Platform:
    • N/A N/A
Summary
This article enumerates the well-known precautions when using InterScan Web Security Virtual Appliance (IWSVA) in ICAP mode.
Details
Public

The following are well-known precautions and workarounds when using InterScan Web Security Virtual Appliance (IWSVA) in ICAP mode. 

Web Reputation Service (WRS) is also implemented in ICAP mode to classify the destination URL.

You can set the HTTP proxy server used for the ICAP client as WRS's HTTP proxy. However, that would cause a slowdown when accessing web sites.

In ICAP mode, IWSVA does the WRS check and contacts the WRS server provided by Trend Micro every time the ICAP request is received. IWSVA enables the HTTP access for the WRS server to go through the HTTP proxy server you set in Update > Connection Settings.

When you set the HTTP proxy server used for the ICAP client as WRS's HTTP proxy and IWSVA receives an ICAP request, the ICAP request for the WRS query might also be received by the HTTP proxy.

Though the WRS check for the WRS server is skipped by the internal whitelist, the number of the ICAP request doubles and this might cause a slowdown in accessing web sites.

Workaround

  1. Configure the HTTP proxy in order for the WRS server to bypass the ICAP filtering.

    The FQDN of the WRS server is "iwsva65-en.url.trendmicro.com".

    For more details, contact the support of the HTTP proxy.

  2. Do not use the HTTP proxy for the WRS check.

    You can change the setting in Update > Connection Settings.

    Note: this is also used for pattern, engine and license updates.

  • IWSVA provides "Scan before delivering" / "Deferred scanning" to address large-file scan lag.
  • The settings are located on HTTP > Advanced Threat Protection > Policies > Virus/Malware Scan Rule > Large File Handling.
  • In the case of ICAP mode, however, the HTTP proxy used for ICAP client must add a "X-TE: Trailers" ICAP header for those features to work as expected.

If the ICAP request does not have a "X-TE: Trailers" header, IWSVA will assume that the ICAP client does not support data trickling and does not use the features. Therefore, IWSVA will start to send the reply to the ICAP client after it completes the scan, which might cause a delay in downloading.

Workaround

To skip the "X-TE: Trailers" ICAP header check:

  1. Log on to IWSVA as root via SSH (for example with a SSH shell such as PuTTy).
  2. Create a backup copy of /etc/iscan/IWSSPIProtocolIcap.pni:

    # cp /etc/iscan/IWSSPIProtocolIcap.pni /etc/iscan/IWSSPIProtocolIcap.pni.bak

  3. Use vi to edit the file /etc/iscan/IWSSPIProtocolIcap.pni.

    # vi /etc/iscan/IWSSPIProtocolIcap.pni

  4. Change the following value to "no".

    --------------------------------  require_xte_for_early_response=no (default:yes)  --------------------------------
  5. Save the file and quit.
  6. Run the following commands to restart the HTTP scan service.

    # /etc/iscan/S99ISproxy stop
    # /etc/iscan/S99ISproxy start

In the case of ICAP mode, the maximum number of the concurrent ICAP request is distributed to REQMOD/RESPMOD according to the following ratio:

  • Maximum number of REQMOD requests: 35% of the maximum concurrent requests.
  • Maximum number of RESPMOD requests: 65% of the maximum concurrent requests.

Note: after the installation, IWSVA adjusts its own configuration to handle these ICAP client requests without any modification, so no action is needed.

Premium
Internal
Rating:
Category:
Configure; Troubleshoot
Solution Id:
1121601
Feedback
Did this article help you?

Thank you for your feedback!

To help us improve the quality of this article, please leave your email here so we can clarify further your feedback, if neccessary:
We will not send you spam or share your email address.

*This form is automated system. General questions, technical, sales, and product-related issues submitted through this form will not be answered.

If you need additional help, you may try to contact the support team. Contact Support

To help us improve the quality of this article, please leave your email here so we can clarify further your feedback, if neccessary:
We will not send you spam or share your email address.

*This form is automated system. General questions, technical, sales, and product-related issues submitted through this form will not be answered.