- Read Me First
- Configuring the Cisco IOS XE DHCP Server
- Configuring the DHCP Server On-Demand Address Pool Manager
- Configuring the Cisco IOS XE DHCP Relay Agent
- DHCP Relay Server ID Override and Link Selection Option 82 Suboptions
- DHCP Server RADIUS Proxy
- Configuring the Cisco IOS XE DHCP Client
- Configuring DHCP Services for Accounting and Security
- ISSU and SSO--DHCP High Availability Features
- DHCPv6 Relay and Server - MPLS VPN Support
- IPv6 Access Services: DHCPv6 Relay Agent
- IPv6 Access Services: Stateless DHCPv6
- IPv6 Access Services: DHCPv6 Prefix Delegation
- DHCP for IPv6 Broadband
- DHCPv6 Server Stateless Autoconfiguration
- DHCP Server MIB
- Finding Feature Information
- Prerequisites for Configuring DHCP Services for Accounting and Security
- Information About DHCP Services for Accounting and Security
- How to Configure DHCP Services for Accounting and Security
Configuring DHCP Services for Accounting and Security
Cisco IOS XE software supports several capabilities that enhance DHCP security, reliability, and accounting in Public Wireless LANs (PWLANs). This functionality can also be used in other network implementations. This module describes the concepts and tasks needed to configure DHCP services for accounting and security.
- Finding Feature Information
- Prerequisites for Configuring DHCP Services for Accounting and Security
- Information About DHCP Services for Accounting and Security
- How to Configure DHCP Services for Accounting and Security
- Configuration Examples for DHCP Services for Accounting and Security
- Additional References
- Technical Assistance
- Feature Information for DHCP Services for Accounting and Security
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Prerequisites for Configuring DHCP Services for Accounting and Security
Before you configure DHCP services for accounting and security, you should understand the concepts documented in the “DHCP Overview” module.
Information About DHCP Services for Accounting and Security
- DHCP Operation in Public Wireless LANs
- Security Vulnerabilities in Public Wireless LANs
- DHCP Services for Security and Accounting Overview
- DHCP Lease Limits
DHCP Operation in Public Wireless LANs
The configuration of DHCP in a public wireless LAN (PWLAN) simplifies the configuration of wireless clients and reduces the overhead necessary to maintain the network. DHCP clients are leased IP addresses by the DHCP server and then authenticated by the Service Selection Gateway (SSG), which allows the clients to access network services. The DHCP server and client exchange DHCP messages for IP address assignments. When a DHCP server assigns an IP address to a client, a DHCP binding is created. The IP address is leased to the client until the client explicitly releases the IP address and disconnects from the network. If the client disconnects without releasing the address, the server terminates the lease after the lease time is over. In either case, the DHCP server removes the binding and the IP address is returned to the pool.
Security Vulnerabilities in Public Wireless LANs
As more people start using PWLANs, security becomes an important concern. Most implementations of PWLANs rely on DHCP for users to obtain an IP address while in a hot spot (such as a coffee shop, airport terminal, hotel, and so on) and use this IP address provided by the DHCP server throughout their session.
IP spoofing is a common technique used by hackers to spoof IP addresses. For example, customer A obtains an IP address from DHCP and has already been authenticated to use the PWLAN, but a hacker spoofs the IP address of customer A and uses this IP address to send and receive traffic. Customer A will still be billed for the service even though he or she is not using the service.
Address Resolution Protocol (ARP) table entries are dynamic by design. Request and reply ARP packets are sent and received by all the networking devices in a network. In a DHCP network, the DHCP server stores the leased IP address to the MAC address or the client-identifier of the client in the DHCP binding. But as ARP entries are learned dynamically, an unauthorized client can spoof the IP address given by the DHCP server and start using that IP address. The MAC address of this unauthorized client will replace the MAC address of the authorized client in the ARP table allowing the unauthorized client to freely use the spoofed IP address.
DHCP Services for Security and Accounting Overview
DHCP security and accounting features have been designed and implemented to address the security concerns in PWLANs but also can be used in other network implementations.
DHCP accounting provides authentication, authorization, and accounting (AAA) and Remote Authentication Dial-In User Service (RADIUS) support for DHCP. The AAA and RADIUS support improves security by sending secure START and STOP accounting messages. The configuration of DHCP accounting adds a layer of security that allows DHCP lease assignment and termination to be triggered for the appropriate RADIUS START and STOP accounting records so that the session state is properly maintained by upstream devices, such as an SSG. This additional security can help to prevent unauthorized clients or hackers from gaining illegal entry to the network by spoofing authorized DHCP leases.
The DHCP Secured IP Address Assignment feature prevents IP spoofing by synchronizing the database of the DHCP server with the ARP table to avoid address hijacking. This secure ARP functionality adds an entry to the ARP table for a client when an address is allocated that can be deleted by the DHCP server only when a binding expires.
The third feature is ARP autologoff, which adds finer control for probing when authorized users log out. The arp probe interval command specifies when to start a probe (the timeout), how frequent a peer is probed (the interval), and the maximum number of retries (the count).
DHCP Lease Limits
You can control the number of subscribers globally or on a per-interface basis by configuring a DHCP lease limit. This functionality allows an Internet service provider (ISP) to limit the number of leases available to clients per household or connection.
How to Configure DHCP Services for Accounting and Security
- Configuring AAA and RADIUS for DHCP Accounting
- Configuring DHCP Accounting
- Verifying DHCP Accounting
- Securing ARP Table Entries to DHCP Leases
- Configuring a DHCP Lease Limit to Control the Number of Subscribers on an Interface
Configuring AAA and RADIUS for DHCP Accounting
Perform this task to configure AAA and RADIUS for DHCP accounting.
RADIUS provides the accounting capability for the transmission of secure START and STOP messages. AAA and RADIUS are enabled prior to the configuration of DHCP accounting but can also be enabled to secure an insecure DHCP network. The configuration steps in this section are required for configuring DHCP accounting in a new or existing network.
DHCP accounting introduces the attributes shown in the table below. These attributes are processed directly by the RADIUS server when DHCP accounting is enabled. These attributes can be monitored in the output of the debug radius command. The output will show the status of the DHCP leases and specific configuration details about the client. The accounting keyword can be used with the debug radius command to filter the output and display only DHCP accounting messages.
Attribute |
Description |
---|---|
Calling-Station-ID |
The output from this attribute displays the MAC address of the client. |
Framed-IP-Address |
The output from this attribute displays the IP address that is leased to the client. |
Acct-Terminate-Cause |
The output from this attribute displays the message “session-timeout” if a client does not explicitly disconnect. |
1.
enable
2.
configure
terminal
3.
aaa
new-model
4.
aaa
group
server
radius
group-name
5.
server
ip-address
auth-port
port-number
acct-port
port-number
6.
exit
7.
aaa
accounting
{system |
network |
exec |
connection
|
commands
level}
{default |
list-name}
{start-stop
|
stop-only |
none}
[broadcast]
group
group-name
8.
aaa session-id
{common |
unique}
9.
ip radius
source-interface
type
number [vrf
vrf-name]
10.
radius-server host
{hostname |
ip-address} [auth-port
port-number] [acct-port
port-number]
11.
radius-server attribute
31 send nas-port-detail mac-only
12.
radius-server retransmit
number-of-retries
DETAILED STEPS
Troubleshooting Tips
To monitor and troubleshoot the configuration of RADIUS accounting, use the following command:
Command |
Purpose |
---|---|
Device# debug radius accounting |
The debug radius command is used to display RADIUS events on the console of the device. These events provide information about RADIUS processes. DHCP accounting information can be filtered with the accounting keyword. START and STOP accounting message information will also be displayed. |
Configuring DHCP Accounting
Perform this task to configure DHCP accounting.
DHCP accounting is enabled with the accounting command. This command configures DHCP to operate with AAA and RADIUS to enable secure START and STOP accounting messages. This configuration adds a layer of security that allows DHCP lease assignment and termination to be triggered for the appropriate RADIUS START and STOP accounting records so that the session state is properly maintained by upstream devices, such as the SSG.
DHCP accounting is configured on a per-client or per-lease basis. Separate DHCP accounting processes can be configured on a per-pool basis.
You must configure an SSG for client authentication. AAA and RADIUS must be enabled before DHCP accounting will operate.
Note | The following restrictions apply to DHCP accounting:
|
1.
enable
2.
configure
terminal
3.
ip
dhcp
pool
pool-name
4.
accounting
method-list-name
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable
Example: Device> enable |
Enables privileged EXEC mode. |
Step 2 |
configure
terminal
Example: Device# configure terminal |
Enters global configuration mode. |
Step 3 |
ip
dhcp
pool
pool-name
Example: Device(config)# ip dhcp pool WIRELESS-POOL |
Configures a DHCP address pool and enters DHCP pool configuration mode. |
Step 4 |
accounting
method-list-name
Example: Device(dhcp-config)# accounting RADIUS-GROUP1 |
Enables DHCP accounting if the specified server group is configured to run RADIUS accounting.
|
Verifying DHCP Accounting
Perform this task to verify the DHCP accounting configuration.
The debug radius, debug ip dhcp server events, debug aaa accounting, debug aaa id commands do not need to be issued together or in the same session as there are differences in the information that is provided. These commands, however, can be used to display DHCP accounting start and stop events, AAA accounting messages, and information about AAA and DHCP hosts and clients. See the "RADIUS Accounting Attributes" section of this module for a list of AAA attributes that have been introduced by DHCP accounting. The show running-config | begin dhcp command can be used to display the local DHCP configuration including the configuration of DHCP accounting.
1.
enable
2.
debug
radius
accounting
3.
debug
ip
dhcp
server
events
4.
debug
aaa
accounting
5.
debug
aaa
id
6.
show
running-config
|
begin
dhcp
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable
Example: Device> enable |
Enables higher privilege levels, such as privileged EXEC mode. |
Step 2 |
debug
radius
accounting
Example: Device# debug radius accounting |
Displays RADIUS events on the console of the device. |
Step 3 |
debug
ip
dhcp
server
events
Example: Device# debug ip dhcp server events |
Displays DHCP IP address assignments, DHCP lease expirations, and DHCP database changes. |
Step 4 |
debug
aaa
accounting
Example: Device# debug aaa accounting |
Displays AAA accounting events. |
Step 5 |
debug
aaa
id
Example: Device# debug aaa id |
Displays AAA events as they relate to unique AAA session IDs. |
Step 6 |
show
running-config
|
begin
dhcp
Example: Device# show running-config | begin dhcp |
The show running-config command is used to display the local configuration of the device. The sample output is filtered with the begin keyword to start displaying output at the DHCP section of the running configuration. |
Securing ARP Table Entries to DHCP Leases
Perform this task to secure ARP table entries to DHCP leases in the DHCP database.
When the update arp command is used, ARP table entries and their corresponding DHCP leases are secured automatically for all new leases and DHCP bindings. However, existing active leases are not secured. These leases are still insecure until they are renewed. When the lease is renewed, it is treated as a new lease and will be secured automatically. If this command is disabled on the DHCP server, all existing secured ARP table entries will automatically change to dynamic ARP entries.
1.
enable
2.
configure
terminal
3.
ip
dhcp
pool
pool
-name
4.
update
arp
5.
renew
deny
unknown
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable
Example: Device> enable |
Enables privileged EXEC mode. |
Step 2 |
configure
terminal
Example: Device# configure terminal |
Enters global configuration mode. |
Step 3 |
ip
dhcp
pool
pool
-name
Example: Device(config)# ip dhcp pool WIRELESS-POOL |
Configures a DHCP address pool and enters DHCP pool configuration mode. |
Step 4 |
update
arp
Example: Device(dhcp-config)# update arp |
Secures insecure ARP table entries to the corresponding DHCP leases.
|
Step 5 |
renew
deny
unknown
Example: Device(dhcp-config)# renew deny unknown |
(Optional) Configures the renewal policy for unknown clients.
|
Troubleshooting Tips
Use the debug ip dhcp server class command to display the class matching results.
Configuring a DHCP Lease Limit to Control the Number of Subscribers on an Interface
Perform this task to limit the number of DHCP leases allowed on an interface.
This feature allows an ISP to limit the number of leases available to clients per household or connection on an interface.
If this feature is enabled on the Cisco IOS XE DHCP server directly connected to clients through unnumbered interfaces, the server allocates addresses and increments the number of leases per subinterface. If a new client tries to obtain an IP address, the server will not offer an IP address if the number of leases on the subinterface has already reached the configured lease limit.
Note | This feature is not supported on numbered interfaces. The lease limit can be applied only to ATM with RBE unnumbered interfaces or serial unnumbered interfaces. |
1.
enable
2.
configure
terminal
3.
ip
dhcp
limit
lease
log
4.
interface
type
number
5.
ip
dhcp
limit
lease
lease-limit
6.
end
7.
show
ip
dhcp
limit
lease
[type
number]
8.
show
ip
dhcp
server
statistics
[type
number]
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable
Example: Device> enable |
Enables privileged EXEC mode. |
Step 2 |
configure
terminal
Example: Device# configure terminal |
Enters global configuration mode. |
Step 3 |
ip
dhcp
limit
lease
log
Example: Device(config)# ip dhcp limit lease log |
(Optional) Enables DHCP lease violation logging when a DHCP lease limit threshold is exceeded.
|
Step 4 |
interface
type
number
Example: Device(config)# interface Serial0/0/0 |
Enters interface configuration mode. |
Step 5 |
ip
dhcp
limit
lease
lease-limit
Example: Device(config-if)# ip dhcp limit lease 6 |
Limits the number of leases offered to DHCP clients per interface.
|
Step 6 |
end
Example: Device(config-if)# end |
Exits the configuration mode and returns to privileged EXEC mode. |
Step 7 |
show
ip
dhcp
limit
lease
[type
number]
Example: Device# show ip dhcp limit lease Serial0/0/0 |
(Optional) Displays the number of times the lease limit threshold has been violated.
|
Step 8 |
show
ip
dhcp
server
statistics
[type
number]
Example: Device# show ip dhcp server statistics Serial 0/0/0 |
(Optional) Displays DHCP server statistics. |
Troubleshooting Tips
You can use the debug ip dhcp server packet and debug ip server events commands to troubleshoot the DHCP lease limit.
Configuration Examples for DHCP Services for Accounting and Security
- Example: Configuring AAA and RADIUS for DHCP Accounting
- Example: Configuring DHCP Accounting
- Example: Verifying DHCP Accounting
- Example: Configuring a DHCP Lease Limit
Example: Configuring AAA and RADIUS for DHCP Accounting
The following example shows how to configure AAA and RADIUS for DHCP accounting:
aaa new-model aaa group server radius RGROUP-1 server 10.1.1.1 auth-port 1645 acct-port 1646 exit aaa accounting network RADIUS-GROUP1 start-stop group RGROUP-1 aaa session-id common ip radius source-interface GigabitEthernet0/0/0 radius-server host 10.1.1.1 auth-port 1645 acct-port 1646 radius-server attribute 31 send nas-port-detail mac-only radius-server retransmit 3 exit
Example: Configuring DHCP Accounting
DHCP accounting is configured on a per-client or per-lease basis. Separate DHCP accounting processes can be configured on a per-pool basis. The following example shows how to configure DHCP accounting START and STOP messages to be sent if RADIUS-GROUP1 is configured as a start-stop group.
ip dhcp pool WIRELESS-POOL accounting RADIUS-GROUP1 exit
Example: Verifying DHCP Accounting
DHCP accounting is enabled after both RADIUS and AAA for DHCP are configured. DHCP START and STOP accounting generation information can be monitored with the debug radius accounting and debug ip dhcp server events commands. See the "RADIUS Accounting Attributes" section of this module for a list of AAA attributes that have been introduced by DHCP accounting.
The following is sample output from the debug radius accounting command. The output shows the DHCP lease session ID, the MAC address, and the IP address of the client interface.
00:00:53: RADIUS: Pick NAS IP for uid=2 tableid=0 cfg_addr=10.0.18.3 best_addr=0.0.0.0 00:00:53: RADIUS(00000002): sending 00:00:53: RADIUS(00000002): Send to unknown id 21645/1 10.1.1.1 :1646, Accounting-Request, len 76 00:00:53: RADIUS: authenticator C6 FE EA B2 1F 9A 85 A2 - 9A 5B 09 B5 36 B5 B9 27 00:00:53: RADIUS: Acct-Session-Id [44] 10 "00000002" 00:00:53: RADIUS: Framed-IP-Address [8] 6 10.0.0.10 00:00:53: RADIUS: Calling-Station-Id [31] 16 "00000c59df76" 00:00:53: RADIUS: Acct-Status-Type [40] 6 Start [1] 00:00:53: RADIUS: Service-Type [6] 6 Framed [2] 00:00:53: RADIUS: NAS-IP-Address [4] 6 10.0.18.3 00:00:53: RADIUS: Acct-Delay-Time [41] 6 0
The following is sample output from the debug ip dhcp server events command. The output was generated on a DHCP server and shows an exchange of DHCP messages between the client and server to negotiate a DHCP lease. The acknowledgment that confirms to the DHCP server that the client has accepted the assigned IP address triggers the accounting START message. It is shown in the last line of the following output:
00:45:50:DHCPD:DHCPDISCOVER received from client 0063.6973.636f.2d30.3030.312e.3432.6339.2e65.6337.352d.4574.31 on interface GigabitEthernet0/0/0. 00:45:52:DHCPD:assigned IP address 10.10.10.16 to client 0063.6973.636f.2d30.3030.312e.3432.6339.2e65.6337.352d.4574.31. 00:45:52:DHCPD:Sending DHCPOFFER to client 0063.6973.636f.2d30.3030.312e.3432.6339.2e65.6337.352d.4574.31(10.10.10.16) 00:45:52:DHCPD:broadcasting BOOTREPLY to client 0001.42c9.ec75. 00:45:52:DHCPD:DHCPREQUEST received from client 0063.6973.636f.2d30.3030.312e.3432.6339.2e65.6337.352d.4574.31. 00:45:52:DHCPD:Sending DHCPACK to client 0063.6973.636f.2d30.3030.312e.3432.6339.2e65.6337.352d.4574.31 (10.10.10.16). 00:45:52:DHCPD:broadcasting BOOTREPLY to client 0001.42c9.ec75. 00:45:52:DHCPD:triggered Acct Start for 0001.42c9.ec75 (10.10.10.16).
The following is sample output from the debug ip dhcp server events command. The output was generated on a DHCP server and shows the receipt of an explicit release message from the DHCP client. The DHCP server triggers an accounting STOP message and then returns the IP address to the DHCP pool. Information about the accounting STOP message is shown in the third line of the following output:
00:46:26:DHCPD:DHCPRELEASE message received from client 0063.6973.636f.2d30.3030.312e.3432.6339.2e65.6337.352d.4574.31 (10.10.10.16) 00:46:26:DHCPD:triggered Acct Stop for (10.10.10.16). 00:46:26:DHCPD:returned 10.10.10.16 to address pool WIRELESS-POOL.
Example: Configuring a DHCP Lease Limit
In the following example, 5 DHCP clients are allowed to receive IP addresses. If a sixth client tries to obtain an IP address, the DHCPDISCOVER messages will not be forwarded to the DHCP server and a trap will be sent to the SNMP manager.
ip dhcp limit lease log ! ip dhcp pool pool1 network 10.1.1.0 255.255.255.0 ! interface loopback0 ip address 10.1.1.1 255.255.255.0 ! interface serial 0/0.2 point-to-point ip dhcp limit lease 5 ip unnumbered loopback0 exit snmp-server enable traps dhcp interface
Additional References
The following sections provide references related to configuring DHCP services for accounting and security.
Related Documents
Related Topic |
Document Title |
---|---|
ARP commands: complete command syntax, command modes, defaults, usage guidelines, and examples |
Cisco IOS IP Addressing Services Command Reference |
DHCP commands: complete command syntax, command modes, defaults, usage guidelines, and examples |
Cisco IOS IP Addressing Services Command Reference |
DHCP conceptual information |
“DHCP Overview” module |
DHCP server configuration |
“Configuring the Cisco IOS XE DHCP Server” module |
DHCP ODAP configuration |
“Configuring the DHCP Server On-Demand Address Pool Manager” module |
DHCP client configuration |
“Configuring the Cisco IOS XE DHCP Client” module |
DHCP relay agent configuration |
“Configuring the Cisco IOS XE DHCP Relay Agent” module |
AAA and RADIUS configuration tasks |
Cisco IOS Security Configuration Guide |
AAA and RADIUS commands: complete command syntax, command mode, defaults, usage guidelines, and examples |
Cisco IOS Security Command Reference |
MIBs
MIBs |
MIBs Link |
---|---|
No new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature. |
To locate and download MIBs for selected platforms, Cisco IOS XE software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
Technical Assistance
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
Technical Assistance
Description |
Link |
---|---|
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies. To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds. Access to most tools on the Cisco Support website requires a Cisco.com user ID and password. |
Feature Information for DHCP Services for Accounting and Security
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Feature Name |
Releases |
Feature Configuration Information |
---|---|---|
DHCP Per Interface Lease Limit and Statistics |
Cisco IOS XE Release 2.1 |
This feature limits the number of DHCP leases offered to DHCP clients on an interface. DHCP server statistics reporting was enhanced to display interface-level statistics. The following commands were introduced or modified by this feature: ip dhcp limit lease, ip dhcp limit lease log, clear ip dhcp limit lease, show ip dhcp limit lease, and show ip dhcp server statistics. |
DHCP Accounting |
Cisco IOS XE Release 2.1 Cisco IOS XE Release 3.9S |
DHCP accounting introduces AAA and RADIUS support for DHCP configuration. The following command was introduced by this feature: accounting. |
DHCP Secured IP Address Assignment |
Cisco IOS XE Release 2.3 Cisco IOS XE Release 3.9S |
DHCP secure IP address assignment provides the capability to secure ARP table entries to DHCP leases in the DHCP database. This feature secures and synchronizes the MAC address of the client to the DHCP binding, preventing unauthorized clients or hackers from spoofing the DHCP server and taking over a DHCP lease of an authorized client. The following command was introduced by this feature: update arp. The following command was modified by this feature: show ip dhcp server statistics. |
ARP Auto-logoff |
Cisco IOS XE Release 3.9S |
The ARP Auto-logoff feature enhances DHCP authorized ARP by providing finer control and probing of authorized clients to detect a logoff. The following command was introduced by this feature: arp probe interval. |