![]() |
User Guide for Cisco Secure ACS Windows Server 3.1
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Establishing Cisco Secure ACS System Configuration
![]() |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Table of ContentsEstablishing Cisco Secure ACS System ConfigurationService Control Logging Date Format Control Local Password Management CiscoSecure Database Replication About CiscoSecure Database Replication
RDBMS SynchronizationImportant Implementation Considerations Database Replication Versus Database Backup Database Replication Logging Replication Options Implementing Primary and Secondary Replication Setups on Cisco Secure ACSes Configuring a Secondary Cisco Secure ACS Replicating Immediately Scheduling Replication Disabling CiscoSecure Database Replication Database Replication Event Errors About RDBMS Synchronization
Cisco Secure ACS BackupRDBMS Synchronization Components Cisco Secure ACS Database Recovery Using the accountActions Table Reports and Event (Error) Handling Preparing to Use RDBMS Synchronization Considerations for Using CSV-Based Synchronization Configuring a System Data Source Name for RDBMS Synchronization RDBMS Synchronization Options Performing RDBMS Synchronization Immediately Scheduling RDBMS Synchronization Disabling Scheduled RDBMS Synchronizations About Cisco Secure ACS Backup
Cisco Secure ACS System RestoreBackup File Locations Directory Management Components Backed Up Reports of Cisco Secure ACS Backups Backup Options Performing a Manual Cisco Secure ACS Backup Scheduling Cisco Secure ACS Backups Disabling Scheduled Cisco Secure ACS Backups About Cisco Secure ACS System Restore
Cisco Secure ACS Active Service ManagementBackup File Names and Locations Components Restored Reports of Cisco Secure ACS Restorations Restoring Cisco Secure ACS from a Backup File IP Pools Server About IP Pools Server
IP Pools Address RecoveryAllowing Overlapping IP Pools or Forcing Unique Pool Address Ranges Refreshing the AAA Server IP Pools Table Adding a New IP Pool Editing an IP Pool Definition Resetting an IP Pool Deleting an IP Pool VoIP Accounting Configuration Cisco Secure ACS Certificate Setup Background on Protocols and Certification
Global Authentication SetupInstalling a Cisco Secure ACS Server Certificate Adding a Certificate Authority Certificate Editing the Certificate Trust List Generating a Certificate Signing Request Updating or Replacing a Cisco Secure ACS Certificate Establishing Cisco Secure ACS System ConfigurationThis chapter addresses the features found in the System Configuration section of Cisco Secure Access Control Server (Cisco Secure ACS) for Windows Server version 3.1. It contains the following topics:
Service ControlCisco Secure ACS uses several Windows services. The Service Control page provides basic status information about the services, and enables you to configure the service log files and to stop or restart the services. For more information about Cisco Secure ACS services, see "Cisco Secure ACS Internal Architecture." This section contains detailed procedural information regarding the following activities: You can also configure Cisco Secure ACS service logs. For more information, see Configuring Service Logs. Determining the Status of Cisco Secure ACS ServicesYou can determine whether Cisco Secure ACS services are running or stopped by accessing the Service Control page. To determine the status of Cisco Secure ACS services, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click Service Control. Result: The status of the services appears in the CiscoSecure ACS on hostname table, where hostname is the name of the Cisco Secure ACS. Stopping, Starting, or Restarting ServicesYou can stop, start, or restart Cisco Secure ACS services as needed. This achieves the same result as starting and stopping Cisco Secure ACS services from within Windows Control panel. This procedure stops, starts, or restarts the Cisco Secure ACS services except for CSAdmin, which is responsible for the HTML interface.
To stop, start, or restart Cisco Secure ACS services, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click Service Control. Result: The status of the services appears in the CiscoSecure ACS on hostname table, where hostname is the name of the Cisco Secure ACS. If the services are running, the Restart and Stop buttons appear at the bottom of the page. If the services are stopped, the Start button appears at the bottom of the page. Step 3 Click Stop, Start, or Restart, as applicable. Result: The status of Cisco Secure ACS services changes to the state appropriate to the button you clicked. LoggingYou can configure Cisco Secure ACS to generate logs for administrative and accounting events, depending on the protocols and options you have enabled. For more information, including configuration steps, see "Working with Logging and Reports." Date Format ControlCisco Secure ACS allows for one of two possible date formats in its logs, reports, and administrative interface. You can choose either a month/day/year format or a day/month/year format. Setting the Date Format
To set the date format, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click Date Format Control. Result: Cisco Secure ACS displays the Date Format Selection table. Step 3 Select a date format option. Step 4 Click Submit & Restart. Result: Cisco Secure ACS restarts its services and implements the date format you selected.
Local Password ManagementYou use the Local Password Management page to configure settings that apply to managing passwords stored in the CiscoSecure user database. It contains the following three sections:
The password validation options are listed below:
The remote change password options are listed below:
This feature depends upon having the CiscoSecure Database Replication feature configured properly; however, replication scheduling does not apply to propagation of changed password information. Cisco Secure ACS sends changed password information immediately, regardless of replication scheduling. Changed password information is replicated only to Cisco Secure ACSes that are properly configured to receive replication data from this Cisco Secure ACS. The automatically triggered cascade setting for the CiscoSecure Database Replication feature does not cause Cisco Secure ACSes that receive changed password information to send it to their replication partners. For more information about CiscoSecure Database Replication, see CiscoSecure Database Replication.
The log file management options for the User Password Changes Log are listed below:
Configuring Local Password ManagementTo configure password validation options, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click Local Password Management. Result: The Local Password Management page appears. Step 3 Under Password Validation Options, follow these steps: a. In Password length between X and Y characters, type the minimum valid number of characters for a password in the X box (up to 2 characters). b. In Password length between X and Y characters, type the maximum valid number of characters for a password in the Y box (up to 2 characters). c. If you want to disallow passwords that contain the username, select the Password may not contain the username check box. d. If you want to require that a user password must be different than the previous user password, select the Password is different from the previous value check box. e. If you want to require that passwords must contain both letters and numbers, select the Password must be alphanumeric check box. Step 4 Under Remote Change Password, follow these steps: a. If you want to enable user password changes in Telnet sessions, clear the Disable TELNET Change Password against this ACS and return the following message to the users telnet session check box. b. If you want to disable user password changes in Telnet sessions, select the Disable TELNET Change Password against this ACS and return the following message to the users telnet session check box. c. In the box below the Disable TELNET Change Password against this ACS and return the following message to the users telnet session check box, type a message that users should see when attempting to change a password in a Telnet session and when the Telnet password change feature has been disabled (Step b). d. If you want Cisco Secure ACS to send changed password information immediately after a user has changed a password, select the Upon remote user password change, immediately propagate the change to selected replication partners check box.
Step 5 If you want Cisco Secure ACS to generate a new User Password Changes log file at a regular interval, select one of the following options:
Step 6 If you want Cisco Secure ACS to generate a new User Password Changes log file when the current file reaches a specific size, select the When size is greater than X KB option and type the file size threshold, in kilobytes, in the X box. Step 7 If you want to manage which User Password Changes log files Cisco Secure ACS keeps, follow these steps: a. Select the Manage Directory check box. b. If you want to limit the number of User Password Changes log files Cisco Secure ACS retains, select the Keep only the last X files option and type the number of files you want Cisco Secure ACS to retain in the X box. c. If you want to limit how old User Password Changes log files retained by Cisco Secure ACS can be, select the Delete files older than X days option and type the number of days for which Cisco Secure ACS should retain a User Password Changes log file before deleting it. Step 8 Click Submit. Result: Cisco Secure ACS restarts its services and implements the settings you specified. CiscoSecure Database ReplicationThis section provides information about the CiscoSecure Database Replication feature, including procedures for implementing this feature and configuring the Cisco Secure ACSes involved. This section contains the following topics:
About CiscoSecure Database ReplicationDatabase replication creates mirror systems of Cisco Secure ACSes by duplicating parts of the primary Cisco Secure ACS setup to one or more secondary Cisco Secure ACSes. You can configure your AAA clients to use these secondary Cisco Secure ACSes if the primary Cisco Secure ACS fails or is unreachable. With a secondary Cisco Secure ACS whose CiscoSecure database is a replica of the CiscoSecure database on the primary Cisco Secure ACS, if the primary Cisco Secure ACS goes out of service, incoming requests are authenticated without network downtime, provided that your AAA clients are configured to failover to the secondary Cisco Secure ACS. Database replication allows you to do the following:
The following items cannot be replicated:
With regard to database replication, we make the following distinctions about Cisco Secure ACSes:
A Cisco Secure ACS can be both a primary Cisco Secure ACS and a secondary Cisco Secure ACS, provided that it is not configured to be a secondary Cisco Secure ACS to a Cisco Secure ACS for which it performs as a primary Cisco Secure ACS.
Replication ProcessThis topic describes the process of database replication, including the interaction between a primary Cisco Secure ACS and each of its secondary Cisco Secure ACSes. 1. The database replication process begins when the primary Cisco Secure ACS contacts the secondary Cisco Secure ACS. In this initial connection, the following four events occur: a. The two Cisco Secure ACSes perform mutual authentication based upon the shared secret of the primary Cisco Secure ACS. If authentication fails, replication fails.
b. The secondary Cisco Secure ACS verifies that it is not configured to replicate to the primary Cisco Secure ACS. If it is, replication is aborted. Cisco Secure ACS does not support bidirectional replication, wherein an Cisco Secure ACS can act as both a primary and a secondary Cisco Secure ACS to the same remote Cisco Secure ACS. c. The primary Cisco Secure ACS verifies that the version of Cisco Secure ACS that the secondary Cisco Secure ACS is running is the same as its own version of Cisco Secure ACS. If not, replication fails. d. The primary Cisco Secure ACS compares the list of database components it is configured to replicate with the list of database components the secondary Cisco Secure ACS is configured to replicate. The primary Cisco Secure ACS only replicates those database components that it is configured to send and that the secondary Cisco Secure ACS is configured to receive. If the secondary Cisco Secure ACS is not configured to receive any of the components that the primary Cisco Secure ACS is configured to send, the database replication fails. 2. After the primary Cisco Secure ACS has determined which components to send to the secondary Cisco Secure ACS, the replication process continues on the primary Cisco Secure ACS as follows: a. The primary Cisco Secure ACS stops its authentication and creates a copy of the CiscoSecure database components that it is configured to replicate. During this step, if AAA clients are configured properly, those that usually use the primary Cisco Secure ACS failover to another Cisco Secure ACS. b. The primary Cisco Secure ACS resumes its authentication service. It also compresses and encrypts the copy of its database components for transmission to the secondary Cisco Secure ACS. c. The primary Cisco Secure ACS transmits the compressed, encrypted copy of its database components to the secondary Cisco Secure ACS. This transmission occurs over a TCP connection, using port 2000. The TCP session uses a 128-bit encrypted, Cisco-proprietary protocol. 3. After the preceding events on the primary Cisco Secure ACS, the database replication process continues on the secondary Cisco Secure ACS as follows: a. The secondary Cisco Secure ACS receives the compressed, encrypted copy of the CiscoSecure database components from the primary Cisco Secure ACS. After transmission of the database components is complete, the secondary Cisco Secure ACS uncompresses the database components. b. The secondary Cisco Secure ACS stops its authentication service and replaces its database components with the database components it received from the primary Cisco Secure ACS. During this step, if AAA clients are configured properly, those that usually use the secondary Cisco Secure ACS failover to another Cisco Secure ACS. c. The secondary Cisco Secure ACS resumes its authentication service. Cisco Secure ACS can act as both a primary Cisco Secure ACS and a secondary Cisco Secure ACS. Figure 8-1 shows a cascading replication scenario. Server 1 acts only as a primary Cisco Secure ACS, replicating to servers 2 and 3, which act as secondary Cisco Secure ACSes. After replication from server 1 to server 2 has completed, server 2 acts as a primary Cisco Secure ACS while replicating to servers 4 and 5. Similarly, server 3 acts as a primary Cisco Secure ACS while replicating to servers 6 and 7. If server 2 were configured to replicate to server 1 in addition to receiving replication from server 1, replication to server 2 would fail. Cisco Secure ACS cannot support such a configuration, known as bidirectional replication. To safeguard against this, a secondary Cisco Secure ACS aborts replication when its primary Cisco Secure ACS appears on its Replication list. Figure 8-1 Cascading Database Replication Replication FrequencyThe frequency with which your Cisco Secure ACSes replicate can have important implications for overall AAA performance. With shorter replication frequencies, a secondary Cisco Secure ACS is more up-to-date with the primary Cisco Secure ACS. This allows for a more current secondary Cisco Secure ACS if the primary Cisco Secure ACS fails. There is a cost to having frequent replications. The more frequent the replication, the higher the load on a multi-server Cisco Secure ACS architecture and on your network environment. If you schedule frequent replication, network traffic is much higher. Also, processing load on the replicating systems is increased. Replication consumes system resources and briefly interrupts authentication; thus the more often replication is repeated, the greater the impact on the AAA performance of the Cisco Secure ACS. This issue is more apparent with databases that are large or that frequently change. Database replication is a non-incremental, destructive backup. In other words, it completely replaces the database and configuration on the secondary Cisco Secure ACS every time it runs. Therefore, a large database results in substantial amounts of data being transferred, and the processing overhead can also be large. Important Implementation ConsiderationsYou should consider several important points when you implement the CiscoSecure Database Replication feature:
Database Replication Versus Database BackupDo not confuse database replication with system backup. Database replication does not replace System Backup. While both features protect against partial or complete server loss, each feature addresses the issue in a different way. System Backup archives data into a format that you can later use to restore the configuration if the system fails or the data becomes corrupted. The backup data is stored on the local hard drive and can be copied and removed from the system for long-term storage. You can store several generations of database backup files. CiscoSecure Database Replication enables you to copy various components of the CiscoSecure database to other Cisco Secure ACSes. This can help you plan a failover AAA architecture and can reduce the complexity of your configuration and maintenance tasks. While it is unlikely, it is possible that CiscoSecure Database Replication can propagate a corrupted database to the Cisco Secure ACSes that generate your backup files.
Database Replication LoggingCisco Secure ACS logs all replication eventswhether successful or notin two files: To view the Windows Event Log, use the Windows administration utilities. You can view recent reports in the Reports and Activity section of Cisco Secure ACS. For more information about Cisco Secure ACS reports, see "Working with Logging and Reports." Replication OptionsThe Cisco Secure ACS HTML interface provides three sets of options for configuring CiscoSecure Database Replication: Replication Components OptionsYou can specify both the CiscoSecure database components that a Cisco Secure ACS sends as a primary Cisco Secure ACS and the components that it receives as a secondary Cisco Secure ACS. The Replication Components table on the CiscoSecure Database Replication page presents the options that control which components are replicated; these options are as follows:
If mirroring the entire database with a secondary Cisco Secure ACS might send confidential information, such as the Proxy Distribution Table, you can configure the primary Cisco Secure ACS to send only a specific category of database information. Outbound Replication OptionsIn the Outbound Replication table on the CiscoSecure Database Replication page, you can schedule outbound replication and you can specify the secondary Cisco Secure ACSes for this primary Cisco Secure ACS.
Inbound Replication OptionsYou can specify the primary Cisco Secure ACSes for which a secondary Cisco Secure ACS. This option appears in the Inbound Replication table on the CiscoSecure Database Replication page. The Accept replication from list controls which Cisco Secure ACSes the current Cisco Secure ACS does accept replicated components from. The list contains the following options:
For more information about the AAA Servers table in Network Configuration, see AAA Server Configuration. Implementing Primary and Secondary Replication Setups on Cisco Secure ACSesIf you implement a replication scheme that uses cascading replication, the Cisco Secure ACS configured to replicate only when it has received replicated components from another Cisco Secure ACS acts both as a primary Cisco Secure ACS and as a secondary Cisco Secure ACS. First, it acts as a secondary Cisco Secure ACS while it receives replicated components, and then it acts as a primary Cisco Secure ACS while it replicates components to other Cisco Secure ACS servers. For an illustration of cascade replication, see Figure 8-1. To implement primary and secondary replication setups on Cisco Secure ACSes, follow these steps: Step 1 On each secondary Cisco Secure ACS, follow these steps: For more information about adding entries to the AAA Servers table, see AAA Server Configuration. b. Configure the secondary Cisco Secure ACS to receive replicated components. For instructions, see Configuring a Secondary Cisco Secure ACS. Step 2 On the primary Cisco Secure ACS, follow these steps: a. In the Network Configuration section, add each secondary Cisco Secure ACS to the AAA Servers table. For more information about adding entries to the AAA Servers table, see AAA Server Configuration. b. If you want to replicate according to a schedule, at intervals, or whenever the primary Cisco Secure ACS has received replicated components from another Cisco Secure ACS, see Scheduling Replication. c. If you want to initiate replication immediately, see Replicating Immediately. Configuring a Secondary Cisco Secure ACS
The CiscoSecure Database Replication feature requires that you configure specific Cisco Secure ACSes to act as secondary Cisco Secure ACSes. The components that a secondary Cisco Secure ACS is to receive must be explicitly specified, as must be its primary Cisco Secure ACS. Replication is always initiated by the primary Cisco Secure ACS. For more information about sending replication components, see Replicating Immediately, or Scheduling Replication. Ensure correct configuration of the AAA Servers table in the secondary Cisco Secure ACS. This secondary Cisco Secure ACS must have an entry in its AAA Servers table for each of its primary Cisco Secure ACSes. Also, the AAA Servers table entry for each primary Cisco Secure ACS must have the same shared secret that the primary Cisco Secure ACS has for its own entry in its AAA Servers table. For more information about the AAA Servers table, see AAA Server Configuration. To configure a Cisco Secure ACS to be a secondary Cisco Secure ACS, follow these steps: Step 1 Log in to the HTML interface on the secondary Cisco Secure ACS. Step 2 In the navigation bar, click System Configuration. Step 3 Click CiscoSecure Database Replication. Result: The Database Replication Setup page appears. Step 4 In the Replication Components table, select the Receive check box for each database component to be received from a primary Cisco Secure ACS. For more information about replication components, see Replication Components Options. Step 5 Make sure that no Cisco Secure ACS that the secondary Cisco Secure ACS is to receive replicated components from is included in the Replication list. If so, select the primary Cisco Secure ACS in the Replication list and click the <-- (left arrow) to move it to the AAA Servers list.
Step 6 If the secondary Cisco Secure ACS is to receive replication components from only one primary Cisco Secure ACS, from the Accept replication from list, select the other Cisco Secure ACS name. The primary Cisco Secure ACSes available in the Accept replication from list are determined by the AAA Servers table in the Network Configuration section. For more information about the AAA Servers table, see AAA Server Configuration.
Step 7 If the secondary Cisco Secure ACS is to receive replication components from more than one primary Cisco Secure ACS, from the Accept replication from list, select Any Known CiscoSecure ACS Server. The Any Known CiscoSecure ACS Server option is limited to the Cisco Secure ACSes listed in the AAA Servers table in Network Configuration.
Step 8 Click Submit. Result: Cisco Secure ACS saves the replication configuration, and at the frequency or times you specified, Cisco Secure ACS begins accepting the replicated components from the other Cisco Secure ACSes you specified. Replicating ImmediatelyYou can manually start database replication.
For each secondary Cisco Secure ACS that this Cisco Secure ACS is to send replicated components to, ensure that you have completed the steps in Configuring a Secondary Cisco Secure ACS. Ensure correct configuration of the AAA Servers table in the primary Cisco Secure ACS. This primary Cisco Secure ACS must have an accurately configured entry in its AAA Servers table for each of its secondary Cisco Secure ACSes. For more information about the AAA Servers table, see AAA Server Configuration. To initiate database replication immediately, follow these steps: Step 1 Log in to the HTML interface on the primary Cisco Secure ACS. Step 2 In the navigation bar, click System Configuration. Step 3 Click CiscoSecure Database Replication.
Result: The Database Replication Setup page appears. Step 4 For each CiscoSecure database component you want to replicate to a secondary Cisco Secure ACS, under Replication Components, select the corresponding Send check box. Step 5 For each secondary Cisco Secure ACS that you want the primary Cisco Secure ACS server to replicate its select components to, select the secondary Cisco Secure ACS server from the AAA Servers list, and then click --> (right arrow button).
Step 6 At the bottom of the browser window, click Replicate Now. Result: Cisco Secure ACS saves the replication configuration. Cisco Secure ACS immediately begins sending replicated database components to the secondary Cisco Secure ACSes you specified. Scheduling ReplicationYou can schedule when a primary Cisco Secure ACS sends its replicated database components to a secondary Cisco Secure ACS. For more information about replication scheduling options, see Outbound Replication Options.
For each secondary Cisco Secure ACS of this primary Cisco Secure ACS, ensure that you have completed the steps in Configuring a Secondary Cisco Secure ACS. Ensure correct configuration of the AAA Servers table of this primary Cisco Secure ACS. For each secondary Cisco Secure ACS of this primary Cisco Secure ACS, this Cisco Secure ACS must have an accurately configured entry in its AAA Servers table. For more information about the AAA Servers table, see AAA Server Configuration. To schedule when a primary Cisco Secure ACS replicates to its secondary Cisco Secure ACSes, follow these steps: Step 1 Log in to the HTML interface on the primary Cisco Secure ACS. Step 2 In the navigation bar, click System Configuration. Step 3 Click CiscoSecure Database Replication.
Result: The Database Replication Setup page appears. Step 4 To specify which CiscoSecure database components the primary Cisco Secure ACS should send to its secondary Cisco Secure ACSes, under Replication Components, select the corresponding Send check box for each database component to be sent. For more information about replicated database components, see Replication Components Options. Step 5 To have the primary Cisco Secure ACS send replicated database components to its secondary Cisco Secure ACSes at regular intervals, under Replication Scheduling, select the Every X minutes option and in the X box type the length of the interval at which Cisco Secure ACS should perform replication (up to 7 characters).
Step 6 If you want to schedule times at which the primary Cisco Secure ACS sends its replicated database components to its secondary Cisco Secure ACSes, follow these steps: a. In the Outbound Replication table, select the At specific times option. b. In the day and hour graph, click the times at which you want Cisco Secure ACS to perform replication.
Step 7 If you want to have this Cisco Secure ACS send replicated database components immediately upon receiving replicated database components from another Cisco Secure ACS, select the Automatically triggered cascade option.
Step 8 You must specify the secondary Cisco Secure ACSes that this Cisco Secure ACS should replicate to. To do so, follow these steps:
a. In the Outbound Replication table, from the AAA Servers list, select the name of a secondary Cisco Secure ACS to which you want the primary Cisco Secure ACS to send its selected replicated database components.
Result: The selected secondary Cisco Secure ACS moves to the Replication list. c. Repeat Step a and Step b for each secondary Cisco Secure ACS to which you want the primary Cisco Secure ACS to send its selected replicated database components. Step 9 Click Submit. Result: Cisco Secure ACS saves the replication configuration you created. Disabling CiscoSecure Database ReplicationYou can disable scheduled CiscoSecure database replications without losing the schedule itself. This allows you to cease scheduled replications temporarily and later resume them without having to re-enter the schedule information. To disable CiscoSecure database replication, follow these steps: Step 1 Log in to the HTML interface on the primary Cisco Secure ACS. Step 2 In the navigation bar, click System Configuration. Step 3 Click CiscoSecure Database Replication. Result: The Database Replication Setup page appears. Step 4 In the Replication Components table, clear all check boxes. Step 5 In the Outbound Replication table, select the Manually option. Step 6 Click Submit. Result: Cisco Secure ACS does not permit any replication to or from this Cisco Secure ACS server. Database Replication Event ErrorsThe Database Replication report contains messages indicating errors that occur during replication. For more information about the Database Replication report, see Cisco Secure ACS System Logs. RDBMS SynchronizationThis section provides information about the RDBMS Synchronization feature, including procedures for implementing this feature, within both Cisco Secure ACS and the external data source involved. This section contains the following topics:
About RDBMS SynchronizationThe RDBMS Synchronization feature enables you to update the CiscoSecure user database with information from an ODBC-compliant data source. The ODBC-compliant data source can be the RDBMS database of a third-party application. It can also be an intermediate file or database that a third-party system updates. Regardless of where the file or database resides, Cisco Secure ACS reads the file or database via the ODBC connection. You can also regard RDBMS Synchronization as an APImuch of what you can configure for a user, group, or device through the Cisco Secure ACS HTML interface, you can alternatively maintain through this feature. RDBMS Synchronization supports addition, modification, and deletion for all data items it can access. You can configure synchronization to occur on a regular schedule. You can also perform synchronizations manually, updating the CiscoSecure user database on demand. Synchronization performed by a single Cisco Secure ACS can update the internal databases of other Cisco Secure ACSes, so that you only need configure RDBMS Synchronization on one Cisco Secure ACS. Cisco Secure ACSes listen on TCP port 2000 for synchronization data. RDBMS Synchronization communication between Cisco Secure ACSes is encrypted using 128-bit encrypted, proprietary algorithm. The topics in this section provide an overview of the kinds of configuration that RDBMS Synchronization can automate. You specify the actions in a relational database table or text file named accountActions. For more information about accountActions, see About the accountActions Table. For specific information about all actions that RDBMS Synchronization can perform, see "RDBMS Synchronization Import Definitions." UsersAmong the user-related configuration actions that RDBMS Synchronization can perform are the following:
User GroupsAmong the group-related configuration actions that RDBMS Synchronization can perform are the following:
Network ConfigurationAmong the network device-related configuration actions that RDBMS Synchronization can perform are the following:
Custom RADIUS Vendors and VSAsRDBMS Synchronization enables you to configure custom RADIUS vendors and VSAs. In addition to supporting a set of predefined RADIUS vendors and vendor-specific attributes (VSAs), Cisco Secure ACS supports RADIUS vendors and VSAs that you define. Vendors you add must be IETF-compliant; therefore, all VSAs that you add must be sub-attributes of IETF RADIUS attribute number 26. You can define up to ten custom RADIUS vendors. Cisco Secure ACS allows only one instance of any given vendor, as defined by the unique vendor IETF ID number and by the vendor name.
RDBMS Synchronization ComponentsThe RDBMS Synchronization feature comprises two components: About CSDBSyncThe CSDBSync service uses an ODBC system data source name (DSN) to access the accountActions table. See Figure 8-2. This service looks specifically for a table named "accountActions". Synchronization events fail if CSDBSync cannot access the accountActions table. Figure 8-2 RDBMS Synchronization CSDBSync reads each record from the accountActions table and updates the CiscoSecure user database as specified by the action code in the record. For example, a record could instruct CSDBSync to add a user or change a user password. After CSDBSync processes each record, it deletes the record from the table. CSDBSync both reads and writes (deletes records) in the accountActions table. This requires that the database user account that you configure the system DSN to use must have both read and write privileges. For more information about CSDBSync or other Windows services used by Cisco Secure ACS, see "Cisco Secure ACS Internal Architecture." About the accountActions TableThe accountActions table contains a set of rows that define actions CSDBSync is to perform in the CiscoSecure user database. Each row in the accountActions table holds user, user group, or AAA client information. Each row also contains an action field and several other fields. These fields provide CSDBSync with the information it needs to update the CiscoSecure user database. For full details of the accountActions table format and available actions, see "RDBMS Synchronization Import Definitions." The database containing the accountActions table must support a multi-threaded ODBC driver. This is required to prevent problems in the event that Cisco Secure ACS and the third-party system attempt to access the accountActions table simultaneously. Cisco Secure ACS includes files to help you create your accountActions table for several common formats. You can find these files on the Cisco Secure ACS in the following location, assuming a default installation of Cisco Secure ACS: The Databases directory contains the following subdirectories:
The The The The Cisco Secure ACS Database Recovery Using the accountActions TableBecause the RDBMS Synchronization feature deletes each record in the accountActions table after processing the record, the accountActions table can be considered a transaction queue. The RDBMS Synchronization feature does not maintain a transaction log/audit trail. If a log is required, the external system that adds records to the accountActions table must create it. Unless the external system can recreate the entire transaction history in the accountActions table, we recommend that you construct a transaction log file for recovery purposes. To do this, create a second table that is stored in a safe location and backed up regularly. In that second table, mirror all the additions and updates to records in the accountActions table. If the database is large, it is not practical to replay all transaction logs to synchronize the CiscoSecure user database with the third-party system. Instead, create regular backups of the CiscoSecure user database and replay the transaction logs from the time of most recent backup to bring the CiscoSecure user database back in synchronization with the third-party system. For information on creating backup files, see Cisco Secure ACS Backup. Replaying transaction logs that slightly predate the checkpoint does not damage the CiscoSecure user database, although some transactions might be invalid and reported as errors. As long as the entire transaction log is replayed, the CiscoSecure user database is consistent with the database of the external RDBMS application. Reports and Event (Error) HandlingThe CSDBSync service provides event and error logging. For more information about the RDBMS Synchronization log, see Cisco Secure ACS System Logs. For more information about the CSDBSync service log, see Service Logs. During manual synchronizations, Cisco Secure ACS provides visual alerts to notify you of problems that occurred during synchronization. Preparing to Use RDBMS SynchronizationSynchronizing the CiscoSecure user database using data from the accountActions table requires that you complete several steps external to Cisco Secure ACS before you configure the RDBMS Synchronization feature within Cisco Secure ACS. If you are planning to use a CSV file as your accountActions table, also see Considerations for Using CSV-Based Synchronization. To prepare to use RDBMS Synchronization, follow these steps: Step 1 Determine where you want to create the accountActions table and in what format. For more information about the accountActions table, see About the accountActions Table. For details on the format and content of the accountActions table, see "RDBMS Synchronization Import Definitions." Step 2 Create your accountActions table. Step 3 Configure your third-party system to generate records and update the accountActions table with them. This will most likely involve creating stored procedures that write to the accountActions table at a triggered event; however, the mechanism for maintaining your accountActions table is unique to your implementation. If the third-party system you are using to update the accountActions table is a commercial product, for assistance, refer to the documentation supplied by your third-party system vendor. For information about the format and content of the accountActions table, see "RDBMS Synchronization Import Definitions." Step 4 Validate your third-party system to ensure that it updates the accountActions table properly. Rows generated in the accountActions table must be valid. For details on the format and content of the accountActions table, see "RDBMS Synchronization Import Definitions."
Step 5 Set up a system DSN on the Cisco Secure ACS. For steps, see Configuring a System Data Source Name for RDBMS Synchronization. Step 6 Schedule RDBMS synchronization in Cisco Secure ACS. For steps, see Scheduling RDBMS Synchronization. Step 7 Configure your third-party system to begin updating the accountActions table with information to be imported into the CiscoSecure user database. Step 8 Confirm that RDBMS synchronization is operating properly by monitoring the RDBMS Synchronization report in the Reports and Activity section. For more information about the RDBMS Synchronization log, see Cisco Secure ACS System Logs. Also, monitor the CSDBSync service log. For more information about the CSDBSync service log, see Service Logs. Considerations for Using CSV-Based SynchronizationThe behavior of the Microsoft ODBC driver for text files creates additional considerations if you are planning to use a CSV-based accountActions table. The Microsoft ODBC driver for text files always operates in a read-only mode. It cannot delete records from a CSV accountActions table. Because of this, synchronization events initiated or scheduled in the HTML interface never release the CSV file, so the updates to the accountActions table from your third-party system fail. The solution is to initiate synchronization events from a script, such as a DOS batch file. In the script, RDBMS synchronization is initiated with the CSDBSync -run command. Assuming a default installation, CSDBSync.exe is installed at: You can write a script that uses the CSDBsync command. You can schedule times when the script is run by using the Windows at command. For information about the at command, please refer to your Microsoft Windows documentation. Also, due to limitations of the Microsoft ODBC text file driver, using the CSV format requires a change to the accountactions CSV file shipped with Cisco Secure ACS and to Cisco Secure ACS configuration. For more information, see Preparing for CSV-Based Synchronization. Preparing for CSV-Based SynchronizationIf you want to use a CSV file for your accountActions table, some additional configuration is necessary. This is because the Microsoft ODBC CSV driver cannot access the accountActions table unless the file has a .csv file extension. To prepare for RDBMS synchronization using a CSV file, follow these steps: Step 1 Rename the accountactions CSV file installed on your Cisco Secure ACS server to accountactions.csv.Assuming a default installation of Cisco Secure ACS, the accountactions file is at the following location: Where x.x refers to the version of your Cisco Secure ACS. Step 2 Edit the Windows Registry: Step 3 At a DOS prompt, follow these steps: Result: The Microsoft ODBC CSV driver can now access the accountActions CSV file properly. Configuring a System Data Source Name for RDBMS Synchronization On the Cisco Secure ACS, a system DSN must exist for Cisco Secure ACS to access the accountActions table. If you plan to use the For more information about the To create a system DSN for use with RDBMS synchronization, follow these steps: Step 1 In Windows Control Panel, double-click the ODBC Data Sources icon. Step 2 In the ODBC Data Source Administrator window, click the System DSN tab. Step 3 Click Add. Step 4 Select the driver you need to use with your new DSN, and then click Finish. Result: A dialog box displays fields requiring information specific to the ODBC driver you selected. Step 5 In the Data Source Name box, type a descriptive name for the DSN. Step 6 Complete the other fields required by the ODBC driver you selected. These fields may include information such as the IP address of the server on which the ODBC-compliant database runs. Step 7 Click OK. Result: The name you assigned to the DSN appears in the System Data Sources list. Step 8 Close the ODBC window and Windows Control Panel. Result: The system DSN to be used by Cisco Secure ACS to access your accountActions table is created on your Cisco Secure ACS. RDBMS Synchronization OptionsThe RDBMS Synchronization Setup page, available from System Configuration, provides control of the following items:
RDBMS Setup OptionsThe RDBMS Synchronization feature provides the following RDBMS setup options:
Synchronization Scheduling OptionsThe RDBMS Synchronization feature provides the following scheduling options:
Synchronization Partners OptionsThe RDBMS Synchronization feature provides the following synchronization partners options:
For more information about the AAA Servers table in Network Configuration, see AAA Server Configuration. Performing RDBMS Synchronization ImmediatelyYou can manually start an RDBMS synchronization event. To perform manual RDBMS synchronization, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click RDBMS Synchronization.
Result: The RDBMS Synchronization Setup page appears. Step 3 To specify options in the RDBMS Setup table, follow these steps: a. From the Data Source list, select the system DSN you configured to communicate with the database that contains your accountActions table. For more information about configuring a system DSN for use with RDBMS Synchronization, see Configuring a System Data Source Name for RDBMS Synchronization. b. In the Username box, type the username for a database user account that has read/write access to the accountActions table. c. In the Password box, type the password for the username specified in the Step b. Result: Cisco Secure ACS has the information necessary to access the accountActions table.
Step 4 For each Cisco Secure ACS that you want this Cisco Secure ACS to update with data from the accountActions table, select the Cisco Secure ACS in the AAA Servers list, and then click > (right arrow button). Result: The selected Cisco Secure ACS appears in the Synchronize list. Step 5 To remove Cisco Secure ACSes from the Synchronize list, select the Cisco Secure ACS in the Synchronize list, and then click < (left arrow button). Result: The selected Cisco Secure ACS appears in the AAA Servers list. Step 6 At the bottom of the browser window, click Synchronize Now. Result: Cisco Secure ACS immediately begins a synchronization event. To check the status of the synchronization, view the RDBMS Synchronization report in Reports and Activity. Scheduling RDBMS SynchronizationYou can schedule when a Cisco Secure ACS performs RDBMS synchronization. To schedule when a Cisco Secure ACS performs RDBMS synchronization, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click RDBMS Synchronization.
Result: The RDBMS Synchronization Setup page appears. Step 3 To specify options in the RDBMS Setup table, follow these steps: a. From the Data Source list, select the system DSN you configured to communicate with the database that contains your accountActions table. For more information about configuring a system DSN for use with RDBMS Synchronization, see Configuring a System Data Source Name for RDBMS Synchronization. b. In the Username box, type the username for a database user account that has read/write access to the accountActions table. c. In the Password box, type the password for the username specified in the Step b. Step 4 To have this Cisco Secure ACS perform RDBMS synchronization at regular intervals, under Synchronization Scheduling, select the Every X minutes option and in the X box type the length of the interval at which Cisco Secure ACS should perform synchronization (up to 7 characters). Step 5 To schedule times at which this Cisco Secure ACS performs RDBMS synchronization, follow these steps: a. Under Synchronization Scheduling, select the At specific times option. b. In the day and hour graph, click the times at which you want Cisco Secure ACS to perform replication.
Step 6 For each Cisco Secure ACS you want to synchronize with data from the accountActions table, follow these steps: a. In the Synchronization Partners table, from the AAA Servers list, select the name of a Cisco Secure ACS that you want this Cisco Secure ACS to update with data from the accountActions table.
Result: The selected Cisco Secure ACS moves to the Synchronize list.
Step 7 Click Submit. Result: Cisco Secure ACS saves the RDBMS synchronization schedule you created. Disabling Scheduled RDBMS SynchronizationsYou can disable scheduled RDBMS synchronization events without losing the schedule itself. This allows you to end scheduled synchronizations and resume them later without having to re-create the schedule. To disable scheduled RDBMS synchronizations, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click RDBMS Synchronization. Result: The RDBMS Synchronization Setup page appears. Step 3 Under Synchronization Scheduling, select the Manually option. Step 4 Click Submit. Result: Cisco Secure ACS does not perform scheduled RDBMS synchronizations. Cisco Secure ACS BackupThis section provides information about the Cisco Secure ACS Backup feature, including procedures for implementing this feature. This section contains the following topics: About Cisco Secure ACS BackupThe ACS Backup process backs up your Cisco Secure ACS system information to a file on the local hard drive. You can manually back up the Cisco Secure ACS system. You can also establish automated backups that occur at regular intervals or at selected days of the week and times. Maintaining backup files can minimize downtime if system information becomes corrupt or is misconfigured. We recommend copying the files to the hard drive on another system in case the hardware fails on the primary system. For information about using a backup file to restore Cisco Secure ACS, see Cisco Secure ACS System Restore. Backup File LocationsThe default directory for backup files is the following: drive:\path\CSAuth\System Backups where drive is the local drive where you installed Cisco Secure ACS and path is the path from the root of drive to the Cisco Secure ACS directory. For example, if you installed Cisco Secure ACS version 3.0 in the default location, the default backup location would be The filename given to a backup is determined by Cisco Secure ACS. For more information about filenames assigned to backup files generated by Cisco Secure ACS, see Backup File Names and Locations. Directory ManagementYou can configure the number of backup files to keep and the number of days after which backup files are deleted. The more complex your configuration and the more often you back up the system, the more diligent we recommend you be about clearing out old databases from the Cisco Secure ACS hard drive. Components Backed UpThe ACS System Backup utility backs up the Cisco Secure ACS user database and information from the Windows Registry that is relevant to Cisco Secure ACS. The user database backup includes all user information, such as username, password, and other authentication information, including server certificates and the certificate trust list. The Windows Registry information includes any system information that is stored in the Windows Registry, such as NDG information, AAA client configuration, and administrator accounts. Reports of Cisco Secure ACS BackupsWhen a system backup takes place, whether it was manually generated or scheduled, the event is logged in the Administration Audit report and the ACS Backup and Restore report. You can view recent reports in the Reports and Activity section of Cisco Secure ACS. For more information about Cisco Secure ACS reports, see "Working with Logging and Reports." Backup OptionsThe ACS System Backup Setup page contains the following configuration options:
Performing a Manual Cisco Secure ACS BackupYou can backup Cisco Secure ACS whenever you want, without scheduling the backup. To perform an immediate backup of Cisco Secure ACS, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Backup. Result: The ACS System Backup Setup page appears. Step 3 In the Directory box under Backup Location, type the drive and path to the directory on a local hard drive where you want the backup file to be written. Step 4 Click Backup Now. Result: Cisco Secure ACS immediately begins a backup. Scheduling Cisco Secure ACS BackupsYou can schedule Cisco Secure ACS backups to occur at regular intervals or on selected days of the week and times. To schedule the times at which Cisco Secure ACS performs a backup, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Backup. Result: The ACS System Backup Setup page appears. Step 3 To schedule backups at regular intervals, under ACS Backup Scheduling, select the Every X minutes option and in the X box type the length of the interval at which Cisco Secure ACS should perform backups.
Step 4 To schedule backups at specific times, follow these steps: a. Under ACS Backup Scheduling, select the At specific times option. b. In the day and hour graph, click the times at which you want Cisco Secure ACS to perform a backup.
Step 5 To change the location where Cisco Secure ACS writes backup files, type the drive letter and path in the Directory box. Step 6 To manage which backup files Cisco Secure ACS keeps, follow these steps: a. Select the Manage Directory check box. b. To limit the number of backup files Cisco Secure ACS retains, select the Keep only the last X files option and type in the X box the number of files you want Cisco Secure ACS to retain. c. To limit how old backup files retained by Cisco Secure ACS can be, select the Delete files older than X days option and type the number of days for which Cisco Secure ACS should retain a backup file before deleting it. Step 7 Click Submit. Result: Cisco Secure ACS implements the backup schedule you configured. Disabling Scheduled Cisco Secure ACS BackupsYou can disable scheduled Cisco Secure ACS backups without losing the schedule itself. This allows you to end scheduled backups and resume them later without having to re-create the schedule. To disable a scheduled backup, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Backup. Result: The ACS System Backup Setup page appears. Step 3 Under ACS Backup Scheduling, select the Manual option. Step 4 Click Submit. Result: Cisco Secure ACS does not continue any scheduled backups. You can still perform manual backups as needed. Cisco Secure ACS System RestoreThis section provides information about the Cisco Secure ACS System Restore feature, including procedures for restoring your Cisco Secure ACS from a backup file. This section contains the following topics: About Cisco Secure ACS System RestoreThe ACS System Restore feature enables you to restore your system configuration from backup files generated by the ACS Backup feature. This feature helps minimize downtime if Cisco Secure ACS system information becomes corrupted or is misconfigured. The ACS System Restore feature only works with backup files generated by a Cisco Secure ACS running an identical Cisco Secure ACS version and patch level. Backup File Names and LocationsThe ACS System Restore feature restores the Cisco Secure ACS user database and Cisco Secure ACS Windows Registry information from a file that was created by the ACS Backup feature. Cisco Secure ACS writes backup files only on the local hard drive. You can restore from any backup file you select. For example, you can restore from the latest backup file, or if you suspect that the latest backup was incorrect, you can select an earlier backup file to restore from. The backup directory is selected when you schedule backups or perform a manual backup. The default directory for backup files is the following: drive:\path\CSAuth\System Backups where drive is the local drive where you installed Cisco Secure ACS and path is the path from the root of drive to the Cisco Secure ACS directory. For example, if you installed Cisco Secure ACS version 3.0 in the default location, the default backup location would be: Cisco Secure ACS creates backup files using the date and time format: For example, if Cisco Secure ACS started a backup on October 13, 1999, 11:41:35 a.m., Cisco Secure ACS would generate a backup file named: If you are not sure of the location of the latest backup file, check your scheduled backup configuration on the ACS Backup page. Components RestoredYou can select the components to restore: the user and group databases, the system configuration, or both. Reports of Cisco Secure ACS RestorationsWhen a Cisco Secure ACS system restoration takes place, the event is logged in the Administration Audit report and the ACS Backup and Restore report. You can view recent reports in the Reports and Activity section of Cisco Secure ACS. For more information about Cisco Secure ACS reports, see "Working with Logging and Reports." Restoring Cisco Secure ACS from a Backup FileYou can perform a system restoration of Cisco Secure ACS whenever needed.
To restore Cisco Secure ACS from a backup file generated by the Cisco Secure ACS Backup feature, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Restore. Result: The ACS System Restore Setup page appears. The Directory box displays the drive and path to the backup directory most recently configured in the Directory box on the ACS Backup page. Beneath the Directory box, Cisco Secure ACS displays the backup files in the current backup directory. If no backup files exist, Step 3 To change the backup directory, type the new drive and path to the backup directory in the Directory box, and then click OK. Result: Cisco Secure ACS displays the backup files, if any, in the backup directory you specified. Step 4 In the list below the Directory box, select the backup file you want to use to restore Cisco Secure ACS. Step 5 To restore user and group database information, select the User and Group Database check box. Step 6 To restore system configuration information, select the CiscoSecure ACS System Configuration check box. Step 7 Click Restore Now. Result: Cisco Secure ACS displays a confirmation dialog box indicating that performing the restoration will restart Cisco Secure ACS services and log out all administrators. Step 8 To continue with the restoration, click OK. Result: Cisco Secure ACS restores the system components specified using the backup file you selected. The restoration should require several minutes to complete, depending on which components you selected to restore and the size of your database. When the restoration is complete, you can log in again to Cisco Secure ACS. Cisco Secure ACS Active Service ManagementACS Active Service Management is an application-specific service monitoring tool that is tightly integrated with ACS. The ACS Active Service Management comprises two features: System MonitoringCisco Secure ACS system monitoring enables you to determine how often Cisco Secure ACS tests its authentication and accounting processes, and to determine what automated actions it takes should tests detect a failure of these processes. Cisco Secure ACS accomplishes system monitoring with the CSMon service. For more information about the CSMon service, see CSMon. System Monitoring OptionsYou have the following options for configuring system monitoring: When this option is enabled, at the interval defined, Cisco Secure ACS tests authentication and accounting. If the test fails, after four unsuccessful re-tries Cisco Secure ACS performs the action identified in the If no successful authentications are recorded list and logs the event.
where drive is the local drive where you installed Cisco Secure ACS and path is the path from the root of drive to the Cisco Secure ACS directory.
Setting Up System MonitoringTo setup Cisco Secure ACS System Monitoring, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Service Management. Result: The ACS Active Service Management Setup page appears. Step 3 To have Cisco Secure ACS test the login process, follow these steps: a. Select the Test login process every X minutes check box. b. Type in the X box the number of minutes (up to 3 characters) that should pass between each login process test. c. From the If no successful authentications are recorded list, select the action Cisco Secure ACS should take when the login test fails five successive times. Step 4 To have Cisco Secure ACS generate a Windows event when a user attempts to log in to your network using a disabled account, select the Generate event when an attempt is made to log in to a disabled account check box. Step 5 If you want to set up event logging, see Setting Up Event Logging. Step 6 If you are done setting up Cisco Secure ACS Service Management, click Submit. Result: Cisco Secure ACS implements the service management settings you made. Event LoggingThe Event Logging feature enables you to configure whether Cisco Secure ACS logs events to the Windows event log and whether Cisco Secure ACS generates an e-mail when an event occurs. Cisco Secure ACS uses the System Monitoring feature to detect the events to be logged. For more information about system monitoring, see System Monitoring Options. Setting Up Event LoggingTo view the Windows event log, choose Start > Programs > Administrative Tools > Event Viewer. For more information about the Windows event log or Event Viewer, refer to your Microsoft Windows documentation. To setup Cisco Secure ACS event logging, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Service Management. Result: The ACS Active Service Management Setup page appears. Step 3 To have Cisco Secure ACS send all events to the Windows event log, select Log all events to the Windows Event log. Step 4 To have Cisco Secure ACS send an e-mail when an event occurs, follow these steps: a. Select the Email notification of event check box. b. In the To box, type the e-mail address (up to 200 characters) to which Cisco Secure ACS should send event notification e-mail. c. In the SMTP Mail Server box, type the hostname (up to 200 characters) of the sending e-mail server. Step 5 If you want to set up system monitoring, see Setting Up System Monitoring. Step 6 If you are done setting up Cisco Secure ACS Service Management, click Submit. Result: Cisco Secure ACS implements the service management settings you made. IP Pools ServerThis section provides information about the IP Pools feature, including procedures for creating and maintaining IP pools. This section contains the following topics: About IP Pools ServerIf you are using VPNs you may have to overlap IP address assignments; that is, it may be advantageous for a PPTP tunnel client within a given tunnel to use the same IP address as that used by another PPTP tunnel client in a different tunnel. The IP Pools Server feature enables you to assign the same IP address to multiple users, provided that the users are being tunnelled to different home gateways for onward routing beyond the boundaries of your own network. This means you can conserve your IP address space without having to resort to using illegal addresses. When you enable this feature, Cisco Secure ACS dynamically issues IP addresses from the IP pools you have defined by number or name. You can configure up to 999 IP pools, for approximately 255,000 users. If you are using IP pooling and proxy, all accounting packets are proxied so that the Cisco Secure ACS that is assigning the IP addresses can confirm whether an IP address is already in use. To use IP pools, the AAA client must have network authorization (in IOS, aaa authorization network) and accounting (in IOS, aaa accounting) enabled.
For information on assigning a group or user to an IP pool, see Setting IP Address Assignment Method for a User Group, or Assigning a User to a Client IP Address. Allowing Overlapping IP Pools or Forcing Unique Pool Address RangesCisco Secure ACS provides automated detection of overlapping pools.
You can determine whether overlapping IP pools are allowed by checking which button appears below the AAA Server IP Pools table:
To allow overlapping IP pools or to force unique pool address ranges, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Server.
Result: The AAA Server IP Pools table lists any IP pools you have configured, their address ranges, and the percentage of pooled addresses in use. Step 3 If you want to allow overlapping IP pool address ranges, follow these steps: Result: Cisco Secure ACS allows overlapping IP pool address ranges. Cisco Secure ACS already allows overlapping IP pool address ranges. Step 4 If you want to deny overlapping IP pool address ranges, follow these steps: Cisco Secure ACS already does not permit overlapping IP pool address ranges. Result: Cisco Secure ACS does not permit overlapping IP pool address ranges. Refreshing the AAA Server IP Pools TableYou can refresh the AAA Server IP Pools table. This allows you to get the latest usage statistics for your IP pools. To refresh the AAA Server IP Pools table, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Server. Result: The AAA Server IP Pools table lists any IP pools you have configured, their address ranges, and the percentage of pooled addresses in use. Step 3 Click Refresh. Result: Cisco Secure ACS updates the percentages of pooled addresses in use. Adding a New IP PoolYou can define up to 999 IP address pools. To add an IP pool, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Server. Result: The AAA Server IP Pools table lists any IP pools you have already configured, their address ranges, and the percentage of pooled addresses in use. Step 3 Click Add Entry. Result: The New Pool table appears. Step 4 In the Name box, type the name (up to 31 characters) you want to assign to the new IP pool. Step 5 In the Start Address box, type the lowest IP address (up to 15 characters) of the range of addresses for the new pool.
Step 6 In the End Address box, type the highest IP address (up to 15 characters) of the range of addresses for the new pool. Step 7 Click Submit. Result: The new IP pool appears in the AAA Server IP Pools table. Editing an IP Pool DefinitionTo edit an IP pool definition, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Server. Result: The AAA Server IP Pools table lists any IP pools you have configured, their address ranges, and the percentage of pooled addresses in use. Step 3 Click the name of the IP pool you need to edit. Result: The name pool table appears, where name is the name of the IP pool you selected. The In Use field displays how many IP addresses in this pool are allocated to a user. The Available field displays how many IP addresses are unallocated to users. Step 4 To change the name of the pool, in the Name box, type the name (up to 31 characters) to which you want to change the IP pool. Step 5 To change the starting address of the pool range of IP addresses, in the Start Address box, type the lowest IP address (up to 15 characters) of the new range of addresses for the pool.
Step 6 To change the ending address of the pool range of IP addresses, in the End Address box, type the highest IP address (up to 15 characters) of the new range of addresses for the pool. Step 7 Click Submit. Result: The edited IP pool appears in the AAA Server IP Pools table. Resetting an IP PoolThe Reset function recovers IP addresses within an IP pool when there are "dangling" connections. A dangling connection occurs when a user disconnects and Cisco Secure ACS does not receive an accounting stop packet from the applicable AAA client. If the Failed Attempts log in Reports and Activity shows a large number of "Failed to Allocate IP Address For User" messages, consider using the Reset function to reclaim all allocated addresses in this IP pool.
To reset an IP pool and reclaim all its IP addresses, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Server. Result: The AAA Server IP Pools table lists any IP pools you have configured, their address ranges, and the percentage of pooled addresses in use. Step 3 Click the name of the IP pool you need to reset. Result: The name pool table appears, where name is the name of the IP pool you selected. The In Use field displays how many IP addresses in this pool are assigned to a user. The Available field displays how many IP addresses are not assigned to users. Step 4 Click Reset. Result: Cisco Secure ACS displays a dialog box indicating the possibility of assigning users addresses that are already in use. Step 5 To continue resetting the IP pool, click OK. Result: The IP pool is reset. All its IP addresses are reclaimed. In the In Use column of the AAA Server IP Pools table, zero percent of the IP pool addresses are assigned to users. Deleting an IP Pool
To delete an IP pool, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Server. Result: The AAA Server IP Pools table lists any IP pools you have configured, their address ranges, and the percentage of pooled addresses in use. Step 3 Click the name of the IP pool you need to delete. Result: The name pool table appears, where name is the name of the IP pool you selected. The In Use column displays how many IP addresses in this pool are assigned to a user. The Available column displays how many IP addresses are not assigned to users. Step 4 Click Delete. Result: Cisco Secure ACS displays a dialog box to confirm that you want to delete the IP pool. Step 5 To delete the IP pool, click OK. Result: The IP pool is deleted. The AAA Server IP Pools table does not list the deleted IP pool. IP Pools Address RecoveryThe IP Pools Address Recovery feature enables you to recover assigned IP addresses that have not been used for a specified period of time. You must configure an accounting network on the AAA client for Cisco Secure ACS to reclaim the IP addresses correctly. Enabling IP Pool Address RecoveryTo enable IP pool address recovery, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click IP Pools Address Recovery.
Result: The IP Address Recovery page appears. Step 3 Select the Release address if allocated for longer than X hours check box and in the X box type the number of hours (up to 4 characters) after which Cisco Secure ACS should recover assigned, unused IP addresses. Step 4 Click Submit. Result: Cisco Secure ACS implements the IP pools address recovery settings you made. VoIP Accounting ConfigurationThe VoIP Accounting Configuration feature enables you to specify which accounting logs receive VoIP accounting data. There are three options for VoIP accounting:
Configuring VoIP Accounting
To configure VoIP accounting, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click VoIP Accounting Configuration.
Result: The VoIP Accounting Configuration page appears. The Voice-over-IP (VoIP) Accounting Configuration table displays the options for VoIP accounting. Step 3 Select the VoIP accounting option you want. Step 4 Click Submit. Result: Cisco Secure ACS implements the VoIP accounting configuration you specified. Cisco Secure ACS Certificate SetupThis section contains the following topics: Background on Protocols and CertificationCisco Secure ACS uses EAP-TLS and PEAP authentication protocols in combination with digital certification to ensure the protection and validity of authentication information. Digital certification, EAP-TLS, and PEAP are described in the topics that follow. Digital CertificatesThe ACS Certificate Setup section is used to install digital certificates to support EAP-TLS and PEAP authentication, as well as to support HTTPS protocol for secure access to the Cisco Secure ACS HTML interface. Cisco Secure ACS employs the X.509 v3 digital certificate standard. Certificate files must be in either Base64-encoded X.509 format or DER-encoded binary X.509 format. Also, Cisco Secure ACS supports manual certificate enrollment. Digital certificates are useful because they do not require the sharing of secrets nor stored database credentials, can be scaled and trusted over large deployments, and can serve as a method of authentication that is stronger and more secure than shared secret systems. Mutual trust requires that Cisco Secure ACS have an installed certificate that can be verified by end-user clients. About the EAP-TLS ProtocolEAP and TLS are both IETF RFC standards. The EAP protocol, an improvement over the point-to-point protocol (PPP), extends the network by providing new methods for carrying initial authentication information, specifically, EAPOL (the encapsulation of EAP over LANs as established by IEEE 802.1X).TLS provides a way to use certificates for both user authentication and for dynamic ephemeral session key generation. For more detailed information on EAP, TLS, and EAP-TLS, refer to the following IETF RFCs: PPP Extensible Authentication Protocol (EAP) RFC 2284, The TLS Protocol RFC 2246 and PPP EAP TLS Authentication Protocol RFC 2716. A user who is authenticated using EAP-TLS can then be mapped to user or group authorization information kept in the CiscoSecure user database, or in a Windows 2000 or generic LDAP Directory Server. Also, to accomplish secure Cisco Aironet connectivity, EAP-TLS generates a dynamic, per-user, per-connection, unique session key. EAP-TLS requires support from both the end client and the AAA client. An example of an EAP-TLS client includes the Windows XP operating system; EAP-TLS compliant AAA clients include Cisco 802.1x-enabled switch platforms (such as the Catalyst 6000 product line), and Cisco Aironet Wireless solutions. To support EAP-TLS, Cisco Secure ACS must operate with an X.509 v3 digital certificate. TLS authentications require two elements of trust. The first element of trust is when the TLS negotiation establishes end-user trust by validating, through RSA signature verifications, that the user possesses a keypair signed by a certificate. This verifies that the end user is the legitimate keyholder for a given digital certificate and the corresponding user identification contained in the certificate. However, trusting that a user possesses a certificate only provides a username/keypair binding. The second element of trust is to use a third-party signature (usually from a CA) that verifies the information in a certificate. This third-party binding is similar to the real world equivalent of the seal on a passport. You trust the passport because you trust the preparation and identity checking that the particular country's passport office made when creating that passport. You trust digital certificates by installing the root certificate CA signature. If Cisco Secure ACS receives traffic from a wireless AP that has the wrong shared secret, the error message logged in to the failed attempts log reads "EAP request has invalid signature." Three conditions that might cause this to occur are the following: After EAP-TLS authentication successfully concludes, Cisco Secure ACS must verify that the claimed identity (presented in the EAP Identity response) corresponds to the certificate presented by the user. Cisco Secure ACS can accomplish this verification in two ways:
When you set up EAP-TLS, you can select the criterion (one or both) that Cisco Secure ACS uses. For more information, see Configuring Authentication Options. EAP-TLS LimitationsThe Cisco Secure ACS implementation of EAP-TLS has the following limitations:
About the PEAP ProtocolThe PEAP (Protected EAP) protocol is a client-server security architecture. PEAP provides stronger security, greater extensibility, and support for one-time token authentication. PEAP has been posted as an IETF Internet Draft by RSA, Cisco, and Microsoft and is available at http://www.ietf.org/internet-drafts/draft-josefsson-pppext-eap-tls-eap-02.txt. PEAP operates with two phrases. The first phaseserver authenticationcomprises a handshake and the establishment of and SSL tunnel. User authentication occurs in the second phase using a new EAP type that is protected by the SSL tunnel previously established. PEAP uses TLS to authenticate the network infrastructure through the TLS Handshake protocol, to protect user credentials in transit by means of the TLS Record Protocol, and to generate cryptographic keying material using the TLS-defined pseudo-random function (PRF) functionality. PEAP uses the same encapsulation as EAP-TLS; however, whereas EAP-TLS ends after the TLS Handshake Protocol is complete, PEAP continues, encapsulating another EAP negotiation and authentication conversation within the TLS Record Protocol. This encapsulation ensures the cryptographic protection of the second EAP conversation. The authentication type negotiated during the second conversation may be any valid (for example, "Generic Token Card (GTC)") EAP type. After the second EAP conversation is complete, the EAP-Success (or EAP-Failure, as the case may be) message is returned to the end-user client in the clear. If authentication is successful, cryptographic keys are derived using the TLS PRF. Session keys never transit the network. As compared to LEAP, PEAP is a major step forward in data security. After phase 1 of PEAP is established, all data is encrypted; this includes all username information that, with LEAP, is sent in cleartext. User identity is only sent through the secure (SSL) tunnel. The initial identity, which is sent in the clear, is the MAC address with the word "PEAP_" as a prefix. Further, by avoiding the requirement for MSCHAP usernames and passwords that is found in LEAP, PEAP can support a wider range of user databases.For more information regarding what protocols are compatible with the different databases, see Authentication Protocol-Database Compatibility. PEAP LimitationsThe Cisco Secure ACS implementation of PEAP has the following limitations:
Installing a Cisco Secure ACS Server CertificatePerform this procedure to install (that is, enroll) a server certificate for your Cisco Secure ACS. You can perform certificate enrollment to support EAP-TLS and PEAP authentication, as well as to support HTTPS protocol for GUI access to Cisco Secure ACS. You must have a server certificate for your Cisco Secure ACS before you can install it. With Cisco Secure ACS, certificate files must be in Base64-encoded X.509. If you do not already have a server certificate in storage, you can use the procedure in Generating a Certificate Signing Request, or any other means, to obtain a certificate for installation. If you want to use a server certificate from local machine storage, we recommend that you read Extensible Authentication Protocol Transport Layer Security Deployment Guide for Wireless LAN Networks, available on the Cisco Secure ACS CD and at http://www.cisco.com/warp/public/cc/pd/sqsw/sq/ To install an existing certificate for use on Cisco Secure ACS, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Certificate Setup. Step 3 Click Install ACS Certificate. Result: Cisco Secure ACS displays the Install ACS Certificate page. Step 4 You must specify whether Cisco Secure ACS reads the certificate from a specified file or uses a certificate already in storage on the local machine. Do one of the following:
Step 5 If you generated the request using Cisco Secure ACS, in the Private key file box, type the full directory path and name of the file that contains the private key.
Step 6 In the Private key password box, type the private key password.
Step 7 Click Submit. Result: To show that the certificate setup is complete, Cisco Secure ACS displays the Installed Certificate Information table, which contains the following certificate information: Adding a Certificate Authority CertificateUse this procedure to add new certificate authority (CA) certificates to Cisco Secure ACS's local certificate storage.
When a user's certificate is from an unknown CA (that is, one that is different from the CA that certifies the Cisco Secure ACS), you must specifically configure Cisco Secure ACS to trust that CA or authentication fails. Until you perform this procedure to explicitly extend trust by adding another CA, Cisco Secure ACS only recognizes certificates from the CA that issued its own certificate. Configuring Cisco Secure ACS to trust a specific CA is a two-step process that comprises both this procedure of adding a CA's certificate and the procedure in Editing the Certificate Trust List, where you signify that the particular CA is to be trusted. (Cisco Secure ACS comes preconfigured with a list of popular CAs, none of which are enabled until you explicitly signify trustworthiness.) To add a certificate authority's certificate to your local storage, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Certificate Setup. Step 3 Click ACS Certification Authority Setup. Result: Cisco Secure ACS displays the CA Operations table on the Certification Authorities Setup page. Step 4 In the CA certificate file box, type the full path and filename for the certificate you want to use. Step 5 Click Submit. Result: The new CA certificate is added to local certificate storage. And, if it is not already there, the name of the CA that issued the certificate is placed on the CTL.
Editing the Certificate Trust ListCisco Secure ACS uses the CTL to verify the client certificates. For a CA to be trusted by Cisco Secure ACS, its certificate must be installed, and the Cisco Secure ACS administrator must explicitly configure the CA as trusted by editing the CTL.
How you edit your CTL determines the type of trust model you have. Many use a restricted trust model wherein very few, privately controlled CAs are trusted. This model provides the highest level of security but restricts adaptability and scalability. The alternative, an open trust model, allows for more CAs or public CAs. This open trust model trades off increased security for greater adaptability and scalability. We recommend that you fully understand the implications of your trust model before editing the CTL in Cisco Secure ACS. Use this procedure to configure CAs on your CTL as trusted or not trusted. Before a CA can be configured as trusted on the CTL, you must have added the CA to the local machine certificate storage; for more information, see Adding a Certificate Authority Certificate. If a user's certificate is from a CA that you have not specifically configured Cisco Secure ACS to trust, authentication fails. To edit the CTL, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click Cisco Secure ACS Certificate Setup. Step 3 Click Edit Certificate Trust List. Result: The Edit the Certificate Trust List (CTL) table appears.
Step 4 To configure a CA on your CTL as trusted, select the corresponding check box.
Step 5 Click Submit. Result: Cisco Secure ACS configures the specified CA (or CAs) as trusted or not trusted in accordance with selecting or deselecting check boxes. Generating a Certificate Signing RequestYou can use Cisco Secure ACS to generate a certificate signing request (CSR). After you generate a CSR, you can submit it to a certificate authority (CA) to obtain your certificate. You perform this procedure to generate the CSR for future use with a certificate enrollment tool.
To generate a certificate signing request, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Certificate Setup. Step 3 Click Generate Certificate Signing Request. Result: Cisco Secure ACS displays the Generate new request table on the Generate Certificate Signing Request page. Step 4 In the Certificate subject box, type cn= followed by the name that you would like to use as subject name in this ACS certificate, for example, Step 5 In the Private key file box, type the full directory path and name of the file in which the private key is saved, for example, Step 6 In the Private key password box, type the private key password (that you have invented). Step 7 In the Retype private key password box, retype the private key password. Step 8 From the Key length list, select the length of the key to be used.
Step 9 From the Digest to sign with list, select the digest (or hashing algorithm).
Step 10 Click Submit. Result: Cisco Secure ACS displays a CSR in the display area, on the right, under a banner that reads:
Updating or Replacing a Cisco Secure ACS CertificateUse this procedure to update or replace an existing Cisco Secure ACS certificate that is out-of-date or out-of-order.
To install a new ACS certificate, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click ACS Certificate Setup. Result: Cisco Secure ACS displays the Installed Certificate Information table on the ACS Certificate Setup page.
Step 3 Click Enroll New Certificate. Result: A confirmation dialog box appears. Step 4 To confirm that you intend to enroll a new certificate, click OK. Result: The existing Cisco Secure ACS certificate is removed. Step 5 You can now install the replacement certificate in the same manner as an original certificate. For detailed steps, see Installing a Cisco Secure ACS Server Certificate. Global Authentication SetupUse the Global Authentication Setup page to specify the settings for all EAP and MS-CHAP authentication requests. Configuring Authentication OptionsUse this procedure to select and configure how Cisco Secure ACS handles options for authentication. In particular, use this procedure to specify and configure the varieties of EAP that you allow, and to specify whether you allow either MS-CHAP Version 1 or MS-CHAP Version 2, or both. For more information on the EAP-TLS Protocol, see About the EAP-TLS Protocol; for more information on the PEAP protocol, see About the PEAP Protocol. For details regarding how various password protocols are supported by the various databases, see Authentication Protocol-Database Compatibility. To configure authentication options, follow these steps: Step 1 In the navigation bar, click System Configuration. Step 2 Click Global Authentication Setup. Result: Cisco Secure ACS displays the Global Authentication Setup page. Step 3 If you want to allow PEAP, follow these steps: a. In the EAP Configuration table, select the Allow PEAP check box. b. In the PEAP client initial display message: box, type the message you want displayed during PEAP authentication. The message has a limit of 60 characters.
c. In the PEAP session timeout (minutes) box, type the maximum PEAP session length you want to allow users, in minutes.
Step 4 If you want to allow EAP-TLS, follow these steps: a. In the EAP Configuration table, select the Allow EAP-TLS check box. b. Select the appropriate radio button to specify whether EAP-TLS should require Certificate name comparison, Certificate binary comparison, or Either comparison type.
Step 5 If you want to allow EAP-MD5, in the EAP Configuration table select the Allow EAP-MD5 check box. Step 6 To enable MS-CHAP authentication, in the MS-CHAP Configuration table, select the check box(es) that correspond to each MS-CHAP version you want to use:
Step 7 Click Submit + Restart. Result: Cisco Secure ACS restarts its services and implements the authentication configuration options you selected.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|