- Table of Contents
-
- 09-Security Command Reference
- 00-Preface
- 01-AAA commands
- 02-Password control commands
- 03-Keychain commands
- 04-Public key management commands
- 05-PKI commands
- 06-IPsec commands
- 07-SSH commands
- 08-SSL commands
- 09-Object group commands
- 10-Attack detection and prevention commands
- 11-TCP attack prevention commands
- 12-IP source guard commands
- 13-ARP attack protection commands
- 14-ND attack defense commands
- 15-uRPF commands
- 16-SAVA commands
- 17-Crypto engine commands
- 18-FIPS commands
- 19-MACsec commands
- 20-SAVI commands
Title | Size | Download |
---|---|---|
12-IP source guard commands | 101.29 KB |
Contents
display ipv6 source binding pd
ip source binding (interface view)
ip source binding (system view)
ipv6 source binding (interface view)
ipv6 source binding (system view)
ipv6 verify source max-entries
IP source guard commands
display ip source binding
Use display ip source binding to display IPv4SG bindings.
Syntax
In standalone mode:
display ip source binding [ static | [ vpn-instance vpn-instance-name ] [ arp-snooping-vlan | arp-snooping-vsi | dhcp-relay | dhcp-server | dhcp-snooping ] ] [ ip-address ip-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ slot slot-number ]
In IRF mode:
display ip source binding [ static | [ vpn-instance vpn-instance-name ] [ arp-snooping-vlan | arp-snooping-vsi | dhcp-relay | dhcp-server | dhcp-snooping ] ] [ ip-address ip-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
static: Displays static IPv4SG bindings.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To display dynamic IPv4SG bindings for the public network, do not specify a VPN instance.
arp-snooping-vlan: Specifies IPv4SG bindings generated based on ARP snooping for VLANs.
arp-snooping-vsi: Specifies IPv4SG bindings generated based on ARP snooping for VSIs.
dhcp-relay: Specifies IPv4SG bindings generated based on DHCP relay agent.
dhcp-server: Specifies IPv4SG bindings generated based on DHCP server.
dhcp-snooping: Specifies IPv4SG bindings generated based on DHCP snooping.
ip-address ip-address: Specifies an IPv4 address.
mac-address mac-address: Specifies a MAC address in H-H-H format.
vlan vlan-id: Specifies a VLAN ID in the range of 1 to 4094.
interface interface-type interface-number: Specifies an interface by its type and number.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv4SG bindings for the active MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv4SG bindings for the global active MPU. (In IRF mode.)
Examples
# Display all IPSG bindings on the public network.
<Sysname> display ip source binding
Total entries found: 5
IP Address MAC Address Interface VLAN Type
10.1.0.5 040a-0000-4000 FGE1/0/1 1 DHCP snooping
10.1.0.6 040a-0000-3000 FGE1/0/1 1 DHCP snooping
10.1.0.7 040a-0000-2000 FGE1/0/1 1 DHCP snooping
10.1.0.8 040a-0000-1000 FGE1/0/2 N/A DHCP relay
10.1.0.9 040a-0000-2000 FGE1/0/2 N/A Static
Table 1 Command output
Field |
Description |
Total entries found |
Total number of IPv4SG bindings. |
IP Address |
IPv4 address in the IPv4SG binding. If no IP address is bound in the binding, this field displays N/A. |
MAC Address |
MAC address in the IPv4SG binding. If no MAC address is bound in the binding, this field displays N/A. |
Interface |
Interface of the binding. This field displays N/A for a global IPv4SG binding. |
VLAN |
VLAN information in the IPv4SG binding. If the binding contains no VLAN information, this field displays N/A. |
Type |
IPSG binding type: · Static—Manually configured by using the ip source binding command. Static bindings are for packet filtering in IPSG or used by other modules to provide security services. · ARP snooping vlan—Dynamically generated based on ARP snooping for the VLAN. The binding is for packet filtering in IPSG. · ARP snooping vsi—Dynamically generated based on ARP snooping for the VSI. The binding is for packet filtering in IPSG. · DHCP relay—Dynamically generated based on DHCP relay agent. The binding is for packet filtering in IPSG. · DHCP server—Dynamically generated based on DHCP server. The binding is used by other modules to provide security services. · DHCP snooping—Dynamically generated based on DHCP snooping. The binding is for packet filtering in IPSG. |
Related commands
ip source binding
ip verify source
display ipv6 source binding
Use display ipv6 source binding to display IPv6SG address bindings.
Syntax
In standalone mode:
display ipv6 source binding [ static | [ vpn-instance vpn-instance-name ] [ dhcpv6-relay | dhcpv6-server | dhcpv6-snooping | nd-snooping-vsi ] ] [ ip-address ipv6-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ slot slot-number ]
In IRF mode:
display ipv6 source binding [ static | [ vpn-instance vpn-instance-name ] [ dhcpv6-relay | dhcpv6-server | dhcpv6-snooping | nd-snooping-vsi ] ] [ ip-address ipv6-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
static: Displays static IPv6SG address bindings.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To display dynamic IPv6SG address bindings for the public network, do not specify a VPN instance.
dhcpv6-relay: Specifies IPv6SG bindings generated based on DHCPv6 relay agent.
dhcpv6-server: Specifies IPv6SG bindings generated based on DHCPv6 server.
dhcpv6-snooping: Specifies IPv6SG bindings generated based on DHCPv6 snooping.
nd-snooping-vsi: Specifies IPv6SG bindings generated based on ND snooping for VSIs.
ip-address ipv6-address: Specifies an IPv6 address.
mac-address mac-address: Specifies a MAC address in H-H-H format.
vlan vlan-id: Specifies a VLAN ID in the range of 1 to 4094.
interface interface-type interface-number: Specifies an interface by its type and number.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6SG address bindings for the active MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6SG address bindings for the global active MPU. (In IRF mode.)
Examples
# Display all IPv6SG address bindings on the public network.
<Sysname> display ipv6 source binding
Total entries found: 2
IPv6 Address MAC Address Interface VLAN Type
2012:1222:2012:1222: 000f-2202-0435 FGE1/0/1 1 DHCPv6 snooping
2012:1222:2012:1222
2012:1222:2012:1222: 000f-2202-0436 FGE1/0/1 N/A Static
2012:1222:2012:1223
Table 2 Command output
Field |
Description |
Total entries found |
Total number of IPv6SG address bindings. |
IPv6 Address |
IPv6 address in the IPv6SG address binding. If no IPv6 address is bound in the binding, this field displays N/A. |
MAC Address |
MAC address in the IPv6SG address binding. If no MAC address is bound in the binding, this field displays N/A. |
Interface |
Interface of the IPv6SG address binding. This field displays N/A for a global IPv6SG binding. |
VLAN |
VLAN information in the IPv6SG address binding. If the binding contains no VLAN information, this field displays N/A. |
Type |
Type of the IPv6SG address binding: · Static—Manually configured by using the ipv6 source binding command. Static bindings are for packet filtering in IPv6SG or used by other modules to provide security services. · DHCPv6 relay—Dynamically generated based on DHCPv6 relay agent. The binding is for packet filtering in IPv6SG. · DHCPv6 sever—Dynamically generated based on DHCPv6 server. The binding is reported to the controller for the controller to understand the information about online and offline users. The binding is not for packet filtering. · DHCPv6 snooping—Dynamically generated based on DHCPv6 snooping. The binding is for packet filtering in IPv6SG. · ND snooping vsi—Dynamically generated based on ND snooping for the VSI. The binding is for packet filtering in IPv6SG. |
Related commands
ipv6 source binding
ipv6 verify source
display ipv6 source binding pd
Use display ipv6 source binding pd to display IPv6SG prefix bindings.
Syntax
In standalone mode:
display ipv6 source binding pd [ vpn-instance vpn-instance-name ] [ prefix prefix/prefix-length ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ slot slot-number ]
In IRF mode:
display ipv6 source binding pd [ vpn-instance vpn-instance-name ] [ prefix prefix/prefix-length ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ chassis chassis-number slot slot-number ]
Views
Any views
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To display IPv6SG prefix bindings for the public network, do not specify a VPN instance.
prefix prefix/prefix-length: Specifies an IPv6 prefix. The value range for the prefix-length argument is 1 to 128. If you do not specify an IPv6 prefix, this command displays all IPv6SG prefix bindings.
mac-address mac-address: Specifies a MAC address in H-H-H format. If you do not specify a MAC address, this command displays IPv6SG prefix bindings for all MAC addresses.
vlan vlan-id: Specifies a VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays IPv6SG prefix bindings for all VLANs.
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays IPv6SG prefix bindings for all interfaces.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6SG prefix bindings for the active MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6SG prefix bindings for the global active MPU. (In IRF mode.)
Usage guidelines
IPv6SG prefix bindings are dynamically obtained from the DHCPv6 snooping module.
Examples
# Display all IPv6SG prefix bindings.
<Sysname> display ipv6 source binding pd
Total entries found: 3
IPv6 prefix MAC address Interface VLAN Type
2012:1111::/64 000f-2202-0435 FGE1/0/1 1 DHCPv6 snooping
2012:2222::/64 000f-2202-0436 FGE2/0/1 2 DHCPv6 snooping
2012:3333::/64 000f-2202-0437 N/A 3 ND RA
Table 3 Command output
Field |
Description |
Total entries found |
Total number of IPv6SG prefix bindings. |
IPv6 prefix |
IPv6 prefix and prefix length in the IPv6SG prefix binding. |
MAC address |
MAC address in the IPv6SG prefix binding. This field displays N/A if the MAC address is invalid. |
Interface |
Interface to which the IPv6SG prefix binding belongs. This field displays N/A for a global IPv6SG prefix binding or an IPv6SG prefix binding generated based on an ND RA prefix entry. |
VLAN |
VLAN information in the IPv6SG prefix binding. This field displays N/A if the IPv6SG prefix binding does not contain the VLAN information. |
Type |
Type of the IPv6SG prefix binding: · DHCPv6 snooping—The binding is generated based on a DHCPv6 snooping entry. · ND RA—The binding is generated based on an ND RA prefix entry. |
Related commands
ipv6 source binding
ipv6 verify source
ip source binding (interface view)
Use ip source binding to configure a static IPv4SG binding on an interface.
Use undo ip source binding to delete the static IPv4SG bindings configured on an interface.
Syntax
ip source binding { ip-address ip-address | ip-address ip-address mac-address mac-address | mac-address mac-address } [ vlan vlan-id ]
undo ip source binding { all | ip-address ip-address | ip-address ip-address mac-address mac-address | mac-address mac-address } [ vlan vlan-id ]
Default
No static IPv4SG bindings exist on an interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 3 Ethernet subinterface view
VLAN interface view
Predefined user roles
network-admin
mdc-admin
Parameters
all: Removes all static IPv4SG bindings on the interface.
ip-address ip-address: Specifies an IPv4 address for the static binding. The IPv4 address must be a class A, B, or C address, and cannot be 127.x.x.x or 0.0.0.0.
mac-address mac-address: Specifies a MAC address for the static binding. The MAC address must be in H-H-H format, and cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.
vlan vlan-id: Specifies a VLAN ID for the static binding. The value range is 1 to 4094. This option is supported only in Layer 2 Ethernet interface view.
Usage guidelines
Static IPv4SG bindings on an interface implement the following functions:
· Filter incoming IPv4 packets on the interface.
· Check user validity by cooperating with the ARP attack detection feature.
You cannot configure static IPv4SG bindings on a service loopback interface.
Examples
# Configure a static IPv4SG binding on FortyGigE 1/0/1.
<Sysname> system-view
[Sysname] interface fortygige 1/0/1
[Sysname-FortyGigE1/0/1] ip source binding ip-address 192.168.0.1 mac-address 0001-0001-0001
Related commands
display ip source binding
ip source binding (system view)
ip source binding (system view)
Use ip source binding to configure a global static IPv4SG binding.
Use undo ip source binding to delete one or all global static IPv4SG bindings.
Syntax
ip source binding ip-address ip-address mac-address mac-address
undo ip source binding { all | ip-address ip-address mac-address mac-address }
Default
No global static IPv4SG bindings exist.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
ip-address ip-address: Specifies the IPv4 address for the static binding. The IPv4 address must be a class A, B, or C address, and cannot be 127.x.x.x or 0.0.0.0.
mac-address mac-address: Specifies the MAC address for the static binding. The MAC address is in the format H-H-H but cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.
all: Removes all global static IPv4SG bindings.
Usage guidelines
A global static IPv4SG binding takes effect on all interfaces.
Examples
# Configure a global static IPv4SG binding.
<Sysname> system-view
[Sysname] ip source binding ip-address 192.168.0.1 mac-address 0001-0001-0001
Related commands
display ip source binding
ip source binding (interface view)
ip verify source
Use ip verify source to enable IPv4SG on an interface.
Use undo ip verify source to disable IPv4SG on an interface.
Syntax
ip verify source { ip-address | ip-address mac-address | mac-address }
undo ip verify source
Default
The IPv4SG feature is disabled on an interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 3 Ethernet subinterface view
VLAN interface view
Predefined user roles
network-admin
mdc-admin
Parameters
ip-address: Filters incoming packets by source IPv4 addresses.
ip-address mac-address: Filters incoming packets by source IPv4 addresses and source MAC addresses.
mac-address: Filters incoming packets by source MAC addresses.
Usage guidelines
After you enable IPv4SG on an interface, this feature uses static and dynamic IPv4SG bindings to match incoming packets on the interface. Packets that match an IPv4SG binding are forwarded and packets that do not match any IPv4SG binding are discarded.
The matching criterion specified by this command applies only to dynamic IPSG. Static IPv4SG uses static bindings configured by using the ip source binding command.
You cannot enable dynamic IPv4SG on a service loopback interface.
Examples
# Enable IPv4SG on Layer 2 Ethernet interface FortyGigE 1/0/1 and verify the source IPv4 address and MAC address for dynamic IPSG.
<Sysname> system-view
[Sysname] interface fortygige 1/0/1
[Sysname-FortyGigE1/0/1] ip verify source ip-address mac-address
# Enable IPv4SG on VLAN-interface 100 and verify the source IPv4 address and MAC address for dynamic IPSG.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ip verify source ip-address mac-address
# Enable IPv4SG on Layer 3 Ethernet interface FortyGigE 1/0/2 and verify the source IPv4 address and MAC address for dynamic IPSG.
<Sysname> system-view
[Sysname] interface fortygige 1/0/2
[Sysname-FortyGigE1/0/2] ip verify source ip-address mac-address
# Enable IPv4SG on Layer 3 Ethernet interface FortyGigE 1/0/2 and verify the source MAC address for dynamic IPSG.
<Sysname> system-view
[Sysname] interface fortygige 1/0/2
[Sysname-FortyGigE1/0/2] ip verify source mac-address
Related commands
display ip source binding
ipv6 source binding (interface view)
Use ipv6 source binding to configure a static IPv6SG binding.
Use undo ipv6 source binding to delete the static IPv6SG bindings configured on an interface.
Syntax
ipv6 source binding { ip-address ipv6-address | ip-address ipv6-address mac-address mac-address | mac-address mac-address } [ vlan vlan-id ]
undo ipv6 source binding { all | ip-address ipv6-address | ip-address ipv6-address mac-address mac-address | mac-address mac-address } [ vlan vlan-id ]
Default
No static IPv6SG bindings exist on an interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 3 Ethernet subinterface view
VLAN interface view
Predefined user roles
network-admin
mdc-admin
Parameters
all: Removes all the static IPv6SG bindings on the interface.
ip-address ipv6-address: Specifies an IPv6 address for the static binding. The IPv6 address cannot be an all-zero address, a multicast address, or a loopback address.
mac-address mac-address: Specifies a MAC address for the static binding. The MAC address must be in H-H-H format, and cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.
vlan vlan-id: Specifies a VLAN ID for the static binding. The value range is 1 to 4094. This option is supported only in Layer 2 Ethernet interface view.
Usage guidelines
Static IPv6SG bindings on an interface filter incoming IPv6 packets.
You cannot configure static IPv6SG bindings on a service loopback interface.
Examples
# Configure a static IPv6SG binding on FortyGigE 1/0/1.
<Sysname> system-view
[Sysname] interface fortygige 1/0/1
[Sysname-FortyGigE1/0/1] ipv6 source binding ip-address 2001::1 mac-address 0002-0002-0002
Related commands
display ipv6 source binding
display ipv6 source binding pd
ipv6 source binding (system view)
ipv6 source binding (system view)
Use ipv6 source binding to configure a global static IPv6SG binding.
Use undo ipv6 source binding to delete one or all global static IPv6SG bindings.
Syntax
ipv6 source binding ip-address ipv6-address mac-address mac-address
undo ipv6 source binding { all | ip-address ipv6-address mac-address mac-address }
Default
No global static IPv6SG bindings exist.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
ipv6-address ipv6-address: Specifies the IPv6 address for the static binding. The IPv6 address cannot be an all-zero address, a multicast address, or a loopback address.
mac-address mac-address: Specifies the MAC address for the static binding. The MAC address must be in H-H-H format, and cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.
all: Removes all global static IPv6SG bindings.
Usage guidelines
A global static IPv6SG binding takes effect on all interfaces.
Examples
# Configure a global static IPv6SG binding.
<Sysname> system-view
[Sysname] ipv6 source binding ipv6-address 2001::1 mac-address 0002-0002-0002
Related commands
display ipv6 source binding
display ipv6 source binding pd
ipv6 source binding (interface view)
ipv6 verify source
Use ipv6 verify source to enable IPv6SG on an interface.
Use undo ipv6 verify source to disable IPv6SG on an interface.
Syntax
ipv6 verify source { ip-address | ip-address mac-address | mac-address }
undo ipv6 verify source
Default
The IPv6SG feature is disabled on an interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 3 Ethernet subinterface view
VLAN interface view
Predefined user roles
network-admin
mdc-admin
Parameters
ip-address: Filters incoming packets by source IPv6 addresses.
ip-address mac-address: Filters incoming packets by source IPv6 addresses and source MAC addresses.
mac-address: Filters incoming packets by source MAC addresses.
Usage guidelines
After you enable IPv6SG on an interface, this feature uses static and dynamic IPv6SG bindings to match incoming packets on the interface. Packets that match an IPv6SG binding are forwarded and packets that do not match any IPv6SG binding are discarded.
The matching criterion specified by this command applies only to dynamic IPv6SG. Static IPv6SG uses static bindings configured by using the ipv6 source binding command.
You cannot enable dynamic IPv6SG on a service loopback interface.
Examples
# Enable IPv6SG on Layer 2 Ethernet interface FortyGigE 1/0/1 and verify the source IPv6 address and MAC address for dynamic IPv6SG.
<Sysname> system-view
[Sysname] interface fortygige 1/0/1
[Sysname-FortyGigE1/0/1] ipv6 verify source ip-address mac-address
Related commands
display ipv6 source binding
display ipv6 source binding pd
ipv6 verify source max-entries
Use ipv6 verify source max-entries to set the maximum number of IPv6SG bindings on an interface.
Use undo ipv6 verify source max-entries to restore the default.
Syntax
ipv6 verify source max-entries number
undo ipv6 verify source max-entries
Default
The maximum number of IPv6SG bindings is not limited on an interface.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
number: Specifies the maximum number of IPv6SG bindings, in the range of 0 to 4294967294.
Usage guidelines
This command limits the total number of static and dynamic IPv6SG bindings on an interface.
If the maximum number of IPv6SG bindings is reached on an interface, no more IPv6SG bindings can be added on the interface.
If you set the maximum number of IPv6SG bindings to be smaller than the number of existing IPv6SG bindings, the configuration can be successful. The existing IPv6SG bindings are not affected. The interface does not learn IPv6SG bindings until the number of existing IPv6SG bindings is smaller than the maximum number.
The number of effective IPv6SG bindings on an interface is limited by hardware resources.
Examples
# Set the maximum number of IPv6SG bindings to 200 on FortyGigE 1/0/1.
<Sysname> system-view
[Sysname] interface fortygige 1/0/1
[Sysname-FortyGigE1/0/1] ipv6 verify source max-entries 200
Related commands
ipv6 source binding (interface view)