Table Of Contents
Management Tab Overview
Understanding the Activate Button
Event Management
Search for an Event Description or CVE Names
View a List of All Currently Supported CVEs
Using Event Groups
Filtering by Event Groups or Severity
Edit a Group of Events
Add an Event Group
IP Management
Search for an Address, Network, Variable, or Host
Filter IP Management List
Edit an IP Group
Add an IP Group
Add a Network, IP Range, or Variable
Add a Host to a Local Controller
Edit Host Information on a Local Controller
Service Management
Search for a Service
Add a Group of Services
Edit a Group of Services
Add a Service
Edit a Service
Delete a Service
User Management
Basic User Management
Global and Local Controller User Management Functions
User Credentials
Adding a New User
Adding a Service Provider (Cell phone/Pager)
Searching for a User
Editing or Removing a User
Creating a User Group
Adding or Removing a User from a Custom User Group
Filtering by Groups
Promoting Global User Roles on Local Controller
Management Tab Overview
Use the management features in the Local Controller to assign: event, addressing, service, and user information. This information is used in rules, queries, and to determine false positives.
This chapter contains the following topics:
•
Understanding the Activate Button
•
Event Management
•
Using Event Groups
•
IP Management
•
Service Management
•
User Management
Understanding the Activate Button
In general, you need to activate changes in the Management tabs if the changes are part of a rule. If a change is made that requires activation, the color of the Activate button turns from gray to red. If you plan to make a series of changes, it may be more efficient to perform all of the changes and then click Activate. Activate instructs the MARS Appliance to pick up changes and apply them to the running system.
To activate a set of management additions or changes, follow these steps:
Step 1
Make one or more changes.
Step 2
When changes (or additions) are complete, activate them by clicking Activate.
Figure 6-1 Clicking the Activate Button
The MARS Appliance picks up the changes and applies them to the running system
Event Management
To open the Event Management sub-tab, click the Management > Event Management tabs.
On the Event Management page, you can search for and filter events and event groups, and work with groups of events.
Search for an Event Description or CVE Names
You can search for partial matches of event descriptions or Common Vulnerabilities and Exposures (CVE) names.
Step 1
Enter the text that you want to search for in the Search field.
Step 2
Click Search .
View a List of All Currently Supported CVEs
You can generate a list of all Common Vulnerabilities and Exposures (CVEs) currently supported.
Step 1
Enter CVE into the Search field.
Step 2
Click Search.
Using Event Groups
Using and creating event groups is one of the most powerful ways to employ rules. You can take any of the events presented here, group them, and then use them with rules to concentrate your searches for attacks.
Filtering by Event Groups or Severity
From the appropriate list, select the group or severity.
Edit a Group of Events
Note
You cannot edit system-defined groups.
Step 1
Select the group in the Select Group list.
Step 2
Click Edit Group.
Step 3
Click each group in the Chosen and Available fields to select it. Click it again to deselect it.
Step 4
Click Add or Remove to move highlighted items as needed.
Step 5
Click Submit.
Add an Event Group
Step 1
Click Add.
Step 2
In the Name field, enter a name for the group.
Step 3
In the Available field, click each group that you want to add to select it. Click it again to deselect it.
Step 4
Click Add.
Step 5
Click Submit.
IP Management
The IP Management page, accessed by clicking Management > IP Management, enables the definition of network assets that you use as building blocks for inspection rules, drop rules, reports and queries, topology discovery schedules, and in defining reporting devices and mitigation devices. You can define assets as networks, IP ranges, or hosts. You can also defined named variables for use within inspection rules.
The vulnerability assessment information that you define for a host—specifically the operating system type and patch level and the known services that run on the host—assists MARS in determining false positives.
Tip
You can filter the list of objects displayed by the View list box. This selection allows you to filter to hosts, networks, IP ranges, or variables.
Note
A Global Controller pushes any global IP Management Groups to the active Local Controllers that it manages.
This section contains the following topics:
•
Search for an Address, Network, Variable, or Host
•
Filter IP Management List
•
Edit an IP Group
•
Add an IP Group
•
Add a Network, IP Range, or Variable
•
Add a Host to a Local Controller
•
Edit Host Information on a Local Controller
Search for an Address, Network, Variable, or Host
Step 1
Select Management > IP Management
Step 2
Enter the text that you want to search for in the Search field.
Step 3
Click Search.
Filter IP Management List
The IP Management tab includes the filter options for view and group that you can use to display a shorter, filtered list.
Perform either of the following filter steps, as desired:
Step 1
From the View dropdown list, select a view. Choices include the following:
•
Variable
•
Network
•
IP Range
•
Host
•
All
Step 2
From the Select Group dropdown list, select a group.
Edit an IP Group
Step 1
Select Management > IP Management.
The IP Management page appears.
Step 2
Select the group in the Select Group list.
Step 3
Click Edit Group.
Step 4
Click each group in the Chosen and Available fields to select it. Click it again to deselect it.
Step 5
Click Add or Remove to move highlighted items as needed.
Step 6
Click Submit.
Add an IP Group
Step 1
Select Management > IP Management.
The IP Management page appears.
Step 2
Click Add Group.
Step 3
In the Name field, enter a name for the group.
Step 4
In the Available field, click a group to select it. To deselect an item, click it again.
Step 5
Click Add to move the selected Event Type Groups into the Chosen field.
Step 6
Click Submit.
Add a Network, IP Range, or Variable
Step 1
Select Management > IP Management.
The IP Management page appears.
Figure 6-2 Add a Network, IP Range, or Variable
Step 2
Click Add.
Step 3
In the Type list select network, IP range, or variable.
Step 4
For each type, enter the appropriate information.
•
Network—name, network IP, network mask
•
IP range—name and range
•
Variable—variable name
Step 5
Click Submit.
Add a Host to a Local Controller
Within MARS, a host is manually or automatically defined as the result of one of the following options:
•
A reporting device or mitigation device defined under the Admin > Security and Monitoring Devices tab.
•
A host managed by a reporting device defined under the Admin > Security and Monitoring Devices tab, such as a host running Cisco Security Agent and discovered by MARS when processing the logs provided by the CSA Management Console.
•
An asset that you want to identify for the purpose of actively interacting with that host from the MARS system, such as third-party syslog sever to which you want to forward syslog messages using alerts.
•
A host that is discovered by the system as part of topology discovery. For example, when processing the ARP cache table on a Cisco Catalyst Switch.
•
A host involved in a session that, at one time or another, was considered suspicious, such as a potential target of an attack. In this case, MARS will have performed a Nessus and nmap port sweep of the host to identify whether it was likely it had been breached.
Due to these various options, you can have a large number of hosts defined on the IP Management page in the web interface. If you do not have a vulnerability assessment package that is compatible with MARS, you should consider providing as much information as possible about these hosts. For information on configuring the QualysGuard API Server for vulnerability assessment, see the chapter Qualys QualysGuard Devices in the Device Configuration Guide for Cisco Security MARS, Release 6.x.
Note
If you are attempting to add a host and you are detecting a conflict with a previously defined host, seeDelete a Device, page 3-14 for additional troubleshooting information.
To manually add a host, follow these steps:
Step 1
Select Management > IP Management.
The IP Management page appears.
Step 2
Click Add.
Step 3
In the Type list select host.
Figure 6-3 General Information for a Host
Step 4
In the Device Name field, enter the host's name.
Step 5
In the Access IP field, identify the address used to pull log events from this host, or is used to connect to when performing dynamic vulnerability assessments while investigating detected attacks.
Step 6
If the host is running a variety of Windows, Solaris, or Linux, select the corresponding value in the Operating System field. Otherwise, verify that Generic is selected.
Step 7
If your are running NetBIOS on your network, in the NetBIOS Name field enter the name associated with this host.
NetBIOS provides name registration and resolution services. MARS uses this setting to provide attack path analysis and address resolution.
Step 8
Under Enter Interface Information, enter the values for the interface Name, IP Address, and Network Mask.
Step 9
Add additional IP addresses and masks to the interface, as necessary, by clicking Add IP/ Network Mask.
Step 10
If you have a dual-homed host, you can add additional interfaces by clicking Add Interface.
Edit Host Information on a Local Controller
Step 1
Select Management > IP Management.
Step 2
From the View dropdown list, select Host.
Step 3
Check the box to the left of the host that you want to edit.
Step 4
Click Edit.
Step 5
Make changes, as necessary, to the following fields:
•
Device Name
•
Access IP
•
Operating System
•
NetBIOS Name
Step 6
To enter or edit interface information for the selected host, you have the following choices:
a.
To add another interface, click Add Interface . Then, on the new line that appears, specify the Name, IP Address, and Network Mask.
b.
To remove an interface or IP, check the box to the left of an interface and click Remove Interface/IP.
c.
To add an IP or Network Mask to an interface, click Add IP/Network Mask. Then specify the IP Address, and Network Mask.
Step 7
Click Done when you are finished editing.
Step 8
After you have made all the changes desired for this administrative session, click Activate.
Tip
If you are adding or editing several devices, it is better for the system that you click Activate for several changes rather than for each individual change.
Service Management
To open the Service Management sub-tab, click the Management > Service Management tabs.
Service is a combination of source port, destination port, and protocol. The Service Management page displays services and their descriptions, ports, and protocols. On the Service Management page, you can work with the services on your networks.
This section contains the following topics:
•
Search for a Service
•
Add a Group of Services
•
Edit a Group of Services
•
Add a Service
•
Edit a Service
•
Delete a Service
Search for a Service
Step 1
Click the Management > Service Management tabs.
Step 2
Enter the text that you want to search for in the Search field.
Step 3
Click Search.
Tip
To filter by service groups, select the group you want from the Select Group list.
Add a Group of Services
Step 1
Click the Management > Service Management tabs.
Step 2
Click Add Group.
Step 3
In the Name field, enter a name for the group.
The Service Group page appears, with available services listed in the box on the right.
Step 4
Check the box next to the services to select them (you can click them again to de-select them).
Step 5
Click <<Add.
The services are listed in the box on the left.
Step 6
Click Submit.
The new group is established and available in the Select Group list.
Edit a Group of Services
Note
You cannot edit system-defined groups.
To edit the services included in a group of services, follow these steps:
Step 1
Click the Management > Service Management tabs.
Step 2
Select the group in the Select Group list.
Step 3
Click Edit Group.
Step 4
To add an item to the group, check the box next to the service to select it, then click <<Add.
Tip
Clicking again deselects the item.
The service(s) are listed in the box on the left.
Step 5
To remove a service from the group, click on a service (or services) to select it, then click Remove>>.
The services are relisted in the box on the right.
Step 6
When finished editing the list click Submit.
Add a Service
Step 1
Click the Management > Service Management tabs.
Step 2
Click Add.
The Define Service page appears.
Step 3
Enter the service's details, including:
•
Name
•
Description (your own description)
•
Protocol (select from list)
•
Source Port (entered either as a value or as a range with high and low values specified)
•
Destination Port Port (entered either as a Value or as a Range with high and low values specified)
Step 4
Click Submit.
The service is added.
Edit a Service
Step 1
Click the Management > Service Management tabs.
Step 2
Select the checkbox to the left of the service you want to edit.
Step 3
Click Edit.
Step 4
Make changes as required and then click Submit.
Delete a Service
Step 1
Click the Management > Service Management tabs.
Step 2
Select the checkbox to the left of the service you want to delete.
Step 3
Click Delete.
Step 4
On the confirmation page, click Yes.
User Management
MARS supports local authentication of MARS users; user credentials are stored the MARS Appliance in SHA-1 cryptographic hash format. Each MARS Appliance only has one Administrative account that is named pnadmin. This is the only account with privileges to access the command line interface via SSH or direct console connection.
This section contains the following topics:
•
Basic User Management
•
Global and Local Controller User Management Functions
•
User Credentials
•
Adding a New User
•
Adding a Service Provider (Cell phone/Pager)
•
Searching for a User
•
Editing or Removing a User
•
Creating a User Group
•
Adding or Removing a User from a Custom User Group
•
Filtering by Groups
•
Promoting Global User Roles on Local Controller
Basic User Management
The User Management page enables you to manage other users and administrators of the MARS system, including the roles and groups to which those users belong. On this page, you can define new user accounts, enabling their access to specific features of the web interface. You can also define user-specific notification settings for the user, such as a valid e-mail address or pager number. Some system-wide settings—including pager and cell phone service provider settings—are also accessible exclusively through this page. To access the User Management page, click either Management > User Management or Admin > User Management.
In MARS, four separate user roles exist that can be assigned to any user who needs to access the web interface:
•
Admin—This user role has full read/write privileges. Users in this role can define new users with any desired role. Users in the role can change the password settings of the accounts in any user role.
•
Security Analyst—This user role has full read privileges but is restricted to write for reports privileges. Users in this role can only define new users (and change passwords of users) with the Notifications Only role.
•
Operator—This user role has read only privileges. Users in this role cannot define new users or change passwords, even of their own user account. However, users in this role can resubmit reports.
•
Notifications Only—This user role has no permissions to access to the MARS web interface; use this role to identify users who will receive notifications, such as e-mail, SMS, or pager notifications.
No limit exists on the number of user accounts that can be defined in MARS.
While roles are system defined, you can define, edit, and delete user groups. For more information, see Creating a User Group and Adding or Removing a User from a Custom User Group.
Global and Local Controller User Management Functions
Users created on the Global Controller are propagated down to the Local Controller with one notable exception: the user "pnadmin" is always local to the Global Controller or Local Controller on which it is first created.
When you create users with the same login name or the same first name/last name combination on both the Global Controller and a Local Controller, both appear in the list of users on the Local Controller: once as a local user, once as global.
Global users are maintained only on the Global Controller; local users are maintained only on individual Local Controllers. Users created on Local Controllers are not propagated up to the Global Controller. If you want a user of a Local Controller to have access to the Global Controller or any of its information, you must also create that user at the Global Controller level.
User Credentials
Good security practices dictate strong passwords for use with the MARS Appliances. When defining user names and password, keep the following guidelines in mind:
Login names and passwords:
•
Can be alphanumeric characters
•
Can contain special characters (!, @, #, etc.)
•
Cannot contain single or double quotes (`or ")
•
Are case sensitive
Login names can have up to 20 characters. Passwords can have up to 64 characters.
Adding a New User
Defining a new user involves specifying the username, password, role, contact information,and notification information.
To add a new user, follow these steps:
Step 1
From the Management > User Management tab, click Add. The User Configuration page appears, as shown in Figure 6-4.
Figure 6-4 User Configuration Page
Step 2
From the Role list, select one of the following values for the user.
•
Admin—has full use of Local Controller.
•
Notification Only—for a non-user of the appliance, use this to send alerts to people who are not admins, security analysts, or operators.
•
Operator—has read-only privileges.
•
Security Analyst—has full use of Local Controller, except cannot access the Admin tab.
Step 3
Create or change the user's password if necessary.
Step 4
Enter the user's credentials and personal information. The information can include the following:
•
First name
•
Last name
•
Organization name
•
Email address
•
PGP Key (on Global Controller only)
•
Short Message Service (SMS) number—for example, 8885551212@servprov.com
•
Work telephone number
•
Home telephone number
•
FAX number
•
Pager number— may also be a mobile telephone number, for example, 5552345678
Step 5
If you are creating a notification by pager, go to the next section, Adding a Service Provider (Cell phone/Pager), otherwise click Submit to complete the procedure for adding a user.
Adding a Service Provider (Cell phone/Pager)
When configuring a notification by pager, add a service provider (cell phone or pager company) by performing the following procedure:
Step 1
From the Service Provider field, select New Provider from the list. Additional fields appear, as shown in Figure 6-5.
The drop-down list is populated as you add new service providers.
Figure 6-5 Select a New Provider and Provide Contact Details
Step 2
Specify values for the following fields:
•
Provider Name—The name of the service provider.
•
Provider Phone No—The service provider's telephone number. This is the number the service provider uses for accepting alpha-numeric messages using the IXO/TAP protocol. The format is like a regular phone number, such as: 18001234567. The format of 1-800-1234567 is also acceptable. If dialing "9" is required to access a number outside your private branch exchange, type a "9," before the full telephone number (for example, 9,1-800-1234567).
•
Provider Baudrate—The baud rate specified by the provider. This is the baud rate the service provider requires for the specified phone number. Common values are 1200, 2400, 4800, and 9600.
Consult your service provider's website for more information on their baud rates, if necessary.
Step 3
Click Submit to close the User Configuration page and return to the User Management tab.
Searching for a User
Step 1
Enter the text that you want to search for in the Search field.
Step 2
Click Search.
Editing or Removing a User
Step 1
From the Management > User Management tab, check the box next to the user's name.
Step 2
Do one of the following:
•
Click Delete to delete the user.
•
Click Edit to change the user's configuration information. The User Configuration page appears. Edit the User Configuration page, as necessary.
Step 3
Click Submit.
Creating a User Group
Step 1
Click Add Group.
Step 2
In the Name field, enter a name for the group.
Step 3
To add to the group, check the users from the list on the right hand side. Click Add.
The checked names move to the lefthand side of the dialog box.
Step 4
To remove users from the group, select the users from the left hand side with Ctrl+click . Click Remove.
The selected names move to the righthand side of the dialog box.
Step 5
Click Submit.
Adding or Removing a User from a Custom User Group
Note
Admin, Operator, Notification, and Security Analyst are system groups and cannot be edited. The user is automatically added to the User Group that corresponds to their role.
To add or remove a user from a custom User Group, follow these steps:
Step 1
Select the User Group from the Select Group field.
The members of the group are displayed.
Step 2
Click Edit Group.
The User Group dialog box appears.
Step 3
To add to the group, check the users from the list on the right hand side. Click Add.
The checked names move to the lefthand side of the dialog box.
Step 4
To remove users from the group, select the users from the left hand side with Ctrl+click . Click Remove.
The selected names move to the righthand side of the dialog box.
Step 5
Click Submit.
You are returned to the User Management tab.
Filtering by Groups
From the Select Group list, select a group. Only the members of the selected group are displayed.
Promoting Global User Roles on Local Controller
A global "Admin" user can log into the Local Controller and promote a global "System Analyst" or "Operator" user to a higher role. For example, a global "Operator" can be promoted to become an "Admin" or "System Analyst" on the Local Controller. However, his/her role as an "operator" on the Global Controller remains the same as the changes remain on the local controller and do not get pushed up to the Global Controller. Once these users get promoted to a higher role, they cannot be demoted afterward.
Global "Notification" users cannot be promoted given that these users have no login password information.