Digital Arts i-Filter

SamurAI [Local] CollectorSamurAI [Cloud] Collector
Picture1.svg

This guide describes the steps required to configure Digital Arts i-Filter to send events to a Samurai Local Collector deployed in your environment.

Product Version Requirements

i-Filter must at least the following version:

  • i-Filter for Linux v.10

Connectivity Requirements

SourceDestinationPortsDescription
i-FilterSamurai local collectorTCP/514For log transmission

i-Filter Access Log Settings

Follow the steps outlined within each section below:

Access Log Settings

  1. Login to the i-Filter management console

  2. Go to System / Log / Access Log Settings

  3. Configure the parameters below:

    • Set Format Setting to Detailed Mode
    • Specify Format as indicated in the table below.
Output OrderField NameField Content
1output_log_dateAccess log output date and time
2process_idProcess number
3productProduct
4vendorVendor
5ifilter_versioni-Filter version
6realy_proxyipUpper proxy server IP address
7public_ip SourceIP address
8src_ipClient
9hostnameComputer name
10access_dateAccess start date and time
11statusHTTP response code
12bytes_inHTTP response size
13bytes_outHTTP request size
14filter_actionFilter action
15r_idRule object ID
16virus_nameVirus name
17ssl_parameterSSL parameter encryption presence
18post_infoFile information at the time of POST
19http_methodHTTP method
20http_versionHTTP version
21http_refererHTTP referrer
22http_user_agentHTTP user agent
23http_content_type_rawHTTP content type
24dest_ipDestination IP address
25dest_portDestination port number
26src_portSource port number
27client_portClient port number
28dest_hostDestination host name
29userAuthentication user name (non-encoded)
30group_nameGroup name (non-encoded)
31urlURL (non-encoded)
32ss_timeSession time
33au_statusAuthentication status
34filter_reasonFilter reason (non-encoded)
35url_category_listURL category list name (non-encoded)
36web_service_nameWeb service name (non-encoded)
37http_responseHTTP response code (upper)
38checksumChecksum

Log Output Settings

The log format must be set as follows. In this document it is displayed with line breaks but in reality it is a single line:

output_log_date="%ltl",process_id="%pid",product="ifilter",vendor="DigitalArts",ifilter_version="%vr"
,realy_proxyip="%pp",public_ip="%sip",src_ip="%>a",hostname="%>A",access_date="%tl",status="%hst",
bytes_in="%<st",bytes_out="%>st",filter_action="%bk",r_id="%rid",virus_name="%vi",ssl_parameter="%en"
,post_info="%pl",http_method="%rm",http_version="%rv",http_referer="%hrf",http_user_agent="%hua",
http_content_type_raw="%mt",dest_ip="%dip",dest_port="%dpt",src_port="%spt",client_port="%cpt",
dest_host="%hnm",user="%Dul",group_name="%Dgn",url="%Dru",ss_time="%Tss",au_status="%Aus",
filter_reason="%DFR",url_category_list="%DCT",web_service_name="%DWID",http_response="%hrst",checksum="%ccs"

Access Log Transfer Settings

  1. From the i-Filter management console

  2. Go to System / Log / Access Log Transfer Settings

  3. Configure the parameters below:

    • Enable the Access Log Transfer Function
    • Set the Maximum Size per Line to 64 KB

Access Log Transfer Server Settings

  1. From the i-Filter management console

  2. Go to System / Log / Access Log Transfer Server Settings

  3. Configure the parameters below:

    • Enable the Effective Setting
    • Specify the target set in Access Log Tansfer Settings for Access Log Settings
    • Set the Address to the IP address of the Samurai Local Collector deployed on your network
    • Set the Port Number to 514
    • Set the Transfer Protocol to TCP
    • Set the Transfer Format to syslog format

For integrations that utilize a Local Collector where we ingest syslog only, you do not need to follow specific steps in the SamurAI MDR portal as we auto detect the vendor and product. The only reason you need to use the SamurAI MDR portal is if you need to determine the Local Collector IP address. Of course you will still need to ensure the integration is functioning! See Integrations for more information on checking status.

Our Integration guide was accurate at the time of writing but vendors change things frequently! If you find errors or anything is outdated, let us know by raising a request in the SamurAI MDR Portal and we shall get it updated.