Documentation Center
AlienVault® USM Anywhere™

Microsoft Windows IIS NXLog

When you configure Microsoft IIS to send logs through NXLog to USM Anywhere, you can use the Windows IIS NXLog plugin to translate the raw log data into normalized events for analysis.

Device Details
Device vendor Microsoft
Device type Web server
Connection type Syslog
Vendor link Collecting Windows System Logs

Integrating Microsoft IIS and NXLog

Before you configure Microsoft IIS to send logs to USM Anywhere through NXLog, you need to configure logging on IIS first.

Configure Logging in IIS

To configure Logging at the server level

  1. Open IIS Manager.
  2. In the Connections tab, select the server and double-click the Logging icon.
  3. Under One log file per, select Site.
  4. Under Log File, click Select Fields to choose the information you want to log.

    Make sure to match the screenshot below because the plugin will look for these fields.

    Configure Logging at site level in IIS Manager

  5. If using the IIS-NXLOG-Extended configuration provided by AlienVault (See "Configure NXLog" below for more information), you also need to

    • Select Bytes Sent (sc-bytes), Bytes Received (cs-bytes), and Host (cs-host).
    • Add the x-forwarded-for field. Click Add Field and fill in the information as shown.

    add custom field

  6. Click Apply.

Configure NXLog

Before you configure the integration, you must have the IP Address of the USM Anywhere Sensor.

To install NXLog CE and configure forwarding

  1. Download the newest stable NXLog Community Edition.
  2. Make a backup copy of the original C:\Program Files (x86)\nxlog\conf\nxlog.conf file and give it another name.
  3. Download the NXLog configuration for USM Anywhere and save it as your new nxlog.conf file.
  4. Open the configuration file for editing and replace usmsensoriphere with the IP address of the USM Anywhere Sensor.
  5. USM Anywhere listens for syslog at UDP port 514, TCP port 601, or TLS/TCP port 6514. Depending on the protocol you decide to use, edit the configuration file as detailed below. Make sure USM Anywhere allows inbound requests to the corresponding port.

  6. Some sections in the nxlog.conf file have been commented out to improve performance. Depending on which product you want to collect logs from, you need to uncomment the corresponding section.

    • To collect logs from the Microsoft IIS, uncomment the section between IIS-NXLOG and /IIS-NXLOG.
    • If you want to collect additional fields, such as cs-host, sc-bytes, cs-bytes, and x-forwarder-for from the IIS log, uncomment the IIS-NXLOG-Extended section instead.

      Important: Do not uncomment both sections because it will generate duplicate events in USM Anywhere.

  7. Save the file.
  8. Open Windows Services and restart the NXLog service.
  9. Open USM Anywhere and verify that you are receiving NXLog events.

Note: If you need to debug NXLog, open C:\Program Files (x86)\nxlog\data\nxlog.log.

Plugin Enablement

The Windows IIS NXLog plugin automatically processes all messages when the raw message contains SourceModuleName":"IIS_Logs, SourceModuleName":"IIS_IN, or SourceModuleName":"IIS_Extended_IN.

Available Plugin Fields

The following plugin fields are important attributes extracted from the syslog message. The USM Anywhere reports use these fields, and you can also reference them when creating custom reports. In addition to reporting, the USM Anywhere correlation rules make use of these fields.

  • timestamp_occured

  • source_address

  • destination_address

  • destination_port

  • source_username

  • request_user_agent

  • response_code

  • request_referrer

  • request_url

  • request_method

  • duration

  • event_name

Troubleshooting

For troubleshooting, refer to the vendor documentation:

https://www.iis.net/learn/troubleshoot