Documentation Center
AlienVault® USM Anywhere™

Cisco WLC

When you configure Cisco Wireless LAN Controller (WLC) to send log data to USM Anywhere, you can use the Cisco WLC plugin to translate the raw log data into normalized events for analysis.

Device Details
Vendor Cisco
Device Type Wireless access point manager
Connection Type Syslog

Integrating Cisco Wireless LAN Controller

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

Note: This command supports both IPv 4 and IPv6 address formats.

To configure a remote host to send syslog messages

  1. After connecting to the Cisco WLC console, enter enable mode.

  2. Configure the remote host to send syslog messages to USM Anywhere:

    config logging syslog host <IP address of the USM Anywhere Sensor>

    Example

    (Cisco Controller)> config logging syslog host 10.92.125.52

     

    Cisco log will be sent to 10.92.125.52 from now on.

  3. Set the facility for outgoing syslog messages to the remote host:

    (Cisco Controller)> config logging syslog facility syslog

    Example

    (Cisco Controller)> config logging syslog facility authorization

  4. Set the severity level for filtering syslog messages to the remote host at informational:

    (Cisco Controller)> config logging syslog level 6

Setting the Syslog Logging Level for Cisco devices

All Cisco devices that support Syslog collection and output of system messages typically let you set a logging level which determines the type and severity of the messages that are sent to a Syslog host such as USM Anywhere for processing and analysis. The following table describes the broad classification of each of these logging levels.

Logging Level Keyword/Severity Level Description
0 emergency System is unusable. Typically devices do not generate Sylog messages with a severity/logging level of 0.
1 alert Immediate action is needed. These messages indicate that action has been taken by the security appliance to resolve a problem or that action needs to be taken by the administrator because of an interface failure, unit standby failure, or bad cables. An administrator should always follow up on an alert message.
2 critical Critical condition requiring immediate attention. These messages indicate that traffic has been blocked or dropped, that spoofed traffic has been detected, or that flags are invalid in traffic. An administrator should usually follow up on critical messages.
3 error Error condition or event. These error messages are specific to security appliance resources such as xlate failures and translation slot failures. An administrator should always follow up on error messages.
4 warning Warning condition or event. These messages are generally warnings about connection problems. An administrator might have to follow up on these warning messages.
5 notification Normal but significant conditions or events. These messages are a mix of notifications of what a security appliance logged-in user is doing on the machine and some messages about Java and ActiveX blocking. An administrator should look at these messages to ensure that unauthorized changes are not being made to the security appliance.
6 informational Informational messages only. These messages describe connections being built and torn down through the security appliance. In most cases, these messages don't need to be audited by an administrator unless users report that they are having problems with specific connections or services.
7 debugging Debugging messages only. These messages are mostly related to IPSec. An administrator uses these messages when bringing up an IPSec tunnel for the first time. For the other debug messages, refer to your device's technical documentation on the Cisco website.

When you set a logging level, all messages with the same classification number (and lower) are output to the Syslog server that collect these messages. In addition, with many of these devices, you can also limit the rate or amount of syslog message volume that is output.

Note: Refer to the vendor documentation provided for your specific device, on the logging commands that are available, and how to use them to control Syslog message output.

By default, most Cisco devices are configured at notification (5) or informational (6) levels for Syslog messages directed to USM Anywhere. (Logging level 7 is not recommended for Syslog message output.) However, you may want to monitor the volume of messages that you are receiving from any particular device, particularly if the logging level is set at informational (6), because storage space can become an issue. You can also determine whether collecting any informational messages contributes significantly to your security monitoring efforts, or is just creating a lot of "noise".

Plugin Enablement

The Cisco WLC plugin will automatically process all messages when the raw message contains "(#|%)(AAA|ACL|APF|AUTOINST|AVL|BASE|BCAST|BOOTP|BUFF|CAPWAP|CCX|CDP|CIDS|CLI|CLIWEB|CNFGR|DAPI|DEBUG|DHCP|DTL|DTLS|EAP|EMT|EMWEB|ETHOIP|FDB|FIPS|HIFN|HREAP|IAPP|IDMGR|INIT|IOS|IPSTAT|LAG|LICENSE|LOCP|LOG|LRADSIM|LWAPP|MIRROR|MM|MMC|NIM|NMSP|NULL|OSAPI|PEM|PKTDEBUG|PMALLOC|POE|POLICY|POWER|PPTP|RBCP|RF|RFID|RMGR|RRM|SIM|SNMP|SNMPUTIL|SNTP|SSHPM|SYSNET|SYSTEM|TFTP|TOOL|TRAPMGR|UPDATE|USMDB|WCP|WEB|WPS)".

Available Plugin Fields

The following plugin fields are important attributes extracted from the syslog message. 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.

  • audit_reason
  • destination_address
  • destination_hostname
  • destination_mac
  • destination_user_privileges
  • destination_username
  • device_facility
  • event_description
  • event_name
  • event_outcome
  • event_severity
  • file_path
  • source_address
  • source_mac
  • source_process

Troubleshooting

For troubleshooting, refer to the vendor documentation:

http://www.cisco.com/c/en/us/td/docs/wireless/controller/7-5/command/reference/cr75.pdf

https://www.cisco.com/c/en/us/td/docs/wireless/controller/technotes/troubleshooting/trb-guide-wlc-5520-8540.html