All MIBs › H3C-PORT-SECURITY-MIB
Organization: Huawei-3COM Technologies Co.,Ltd.
Last Updated: 2004-11-24
Category: Technology: Switching/L2, Vendor: H3C/HH3C
Description: H3C MIB for port security management limiting MAC addresses per port to prevent unauthorized network access.
Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.
What Is H3C-PORT-SECURITY-MIB?
H3C-PORT-SECURITY-MIB is a Huawei-3COM Technologies proprietary MIB (extending IEEE8021-PAE-MIB) managing port security and 802.1X-based RALM (Remote Access LAN Module) authentication. Its objects cover a global port-security control and VLAN-membership list, RALM default session time/holdoff time/reauthenticate flag, auth mode/username/password/domain/offline time/server-timeout, a MAC-control setting, a port table (mode, need-to-know mode, intrusion action, current/stored/max address counts), and a secure-address table (MAC, VLAN ID, status). As a configuration/security MIB it lets an administrator confirm port-security mode and intrusion-action policy and audit learned secure MAC addresses on an H3C switch. It is deployed on H3C (3Com-Huawei) switches. Engineers can download the H3C-PORT-SECURITY-MIB file directly to load it into their MIB browser.
IPNetwork Monitor allows you to monitor SNMP objects defined in H3C-PORT-SECURITY-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.
Supported Devices
- H3C (3Com-Huawei) switches
Monitoring Examples
An administrator checks h3cSecureIntrusionAction and h3cSecureAddressTable to confirm port-security enforcement and learned MAC addresses on an H3C switch.
What Can Be Monitored
- port-security mode, intrusion action, and secure-address table
This MIB depends on
Related MIBs
Imported Objects
From HUAWEI-3COM-OID-MIB
| h3cPortSecurity | OBJECT-IDENTITY |
From IEEE8021-PAE-MIB
| dot1xAuthSessionAuthenticMethod | OBJECT-TYPE |
| dot1xAuthSessionTerminateCause | OBJECT-TYPE |
| dot1xAuthSessionUserName | OBJECT-TYPE |
| dot1xPaePortNumber | OBJECT-TYPE |
From RFC1213-MIB
| ifAdminStatus | |
| ifIndex |
From SNMPv2-SMI
| Integer32 | |
| IpAddress | |
| MODULE-IDENTITY | |
| NOTIFICATION-TYPE | |
| OBJECT-TYPE |
From SNMPv2-TC
| DisplayString | |
| MacAddress | |
| RowStatus | |
| TruthValue |
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| h3cPortSecurityMIB | 1.3.6.1.4.1.2011.10.2.26.1 | The MIB module is used for managing port security. | ||
| h3cPortSecurityLeaf | 1.3.6.1.4.1.2011.10.2.26.1.1 | |||
| INT h3cSecurePortSecurityControl | 1.3.6.1.4.1.2011.10.2.26.1.1.1 | INTEGER | read-write | This attribute controls the system wide operation of network access control. The configured port security options only become operational when this attribute is set to enabled. |
| STR h3cSecurePortVlanMembershipList | 1.3.6.1.4.1.2011.10.2.26.1.1.2 | DisplayString | accessible-for-notify | This is a dummy MIB object referenced by the h3csecureLogon and h3csecureLogoff traps. This object contains a comma separated list of the VLAN identifiers (0-4095) assigned to a port. A tagged VLAN has a 'T' suffix after the VLAN number and an untagged VLAN may have an optional 'U' suffix. |
| h3cSecureRalmObjects | 1.3.6.1.4.1.2011.10.2.26.1.1.4 | |||
| INT h3cSecureRalmDefaultSessionTime | 1.3.6.1.4.1.2011.10.2.26.1.1.4.1 | INTEGER | read-write | Specifies the default session lifetime in seconds before a forwarding MAC address is re-authenticated. The default time is 1800 seconds. |
| INT h3cSecureRalmHoldoffTime | 1.3.6.1.4.1.2011.10.2.26.1.1.4.2 | INTEGER | read-write | Specifies the time in seconds before a blocked (denied) MAC address can be re-authenticated. The default time is 60 seconds. |
| MAC h3cSecureRalmReauthenticate | 1.3.6.1.4.1.2011.10.2.26.1.1.4.3 | MacAddress | read-write | Writing a MAC address to this object causes an immediate RALM re-authentication of this address (can be on any port). If the MAC address not currently known to RALM, it silently ignores the write. |
| INT h3cSecureRalmAuthMode | 1.3.6.1.4.1.2011.10.2.26.1.1.4.4 | INTEGER | read-write | This controls how MAC addresses are authenticated. papUsernameAsMacAddress(1) Authentication uses the RADIUS server by sending a PAP request with Username and Password both equal to the MAC address being authenticated. This is the default. papUsernameFixed(2) Authentication uses the RADIUS server by sending a PAP request with Username and Password coming from the h3cSecureRalmAuthUsername and h3cSecureRalmAuthPassword MIB objects. In this mode the RADIUS server would normally take into account the request's calling-station-id attribute, which is the MAC address of the host being authenticated. |
| STR h3cSecureRalmAuthUsername | 1.3.6.1.4.1.2011.10.2.26.1.1.4.5 | DisplayString | read-write | This is the username used for authentication requests where h3cSecureRalmAuthMode is papUsernameFixed. Default shall be 'mac'. |
| STR h3cSecureRalmAuthPassword | 1.3.6.1.4.1.2011.10.2.26.1.1.4.6 | DisplayString | read-write | This is the password used for authentication requests where h3cSecureRalmAuthMode is papUsernameFixed. Default shall be a null string. |
| STR h3cSecureRalmAuthDomain | 1.3.6.1.4.1.2011.10.2.26.1.1.4.7 | DisplayString | read-write | MAC-authentication users may be configured in a specific domain, which excludes 802.1x and other authentication users. This specifies the domain of all MAC-authentication users. |
| INT h3cSecureRalmAuthOfflineTime | 1.3.6.1.4.1.2011.10.2.26.1.1.4.8 | INTEGER | read-write | Switch isn't informed when online user is offline, so switch should be able to detect offline and inform radius server to stop accounting when there is no traffic of the user. This attribute configures the timer interval of offline-detect. The default time is 300 seconds. |
| INT h3cSecureRalmAuthServerTimeoutTime | 1.3.6.1.4.1.2011.10.2.26.1.1.4.9 | INTEGER | read-write | When switch sends request packets (include connecting request and offline request, etc) to radius server and there is no response, switch will terminate the authentication process. This attribute configures the timer interval of server-timeout. The default time is 100 seconds. |
| INT h3cSecureMacControl | 1.3.6.1.4.1.2011.10.2.26.1.1.4.10 | INTEGER | read-write | This attribute controls the system wide operation of mac-authentication. The system-wide mac-authentication options become non-operational when this attribute is set to disabled. This is required for h3cSecurePortSecurityControl to be enabled. |
| h3cPortSecurityTables | 1.3.6.1.4.1.2011.10.2.26.1.2 | |||
| h3cSecurePortTable | 1.3.6.1.4.1.2011.10.2.26.1.2.1 | not-accessible | This table defines the security status of each secure port. Each port can have a number of authorised MAC addresses, and these are stored in the h3cSecureAddressTable. | |
| h3cSecurePortEntry | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1 | not-accessible | There is a row in this table for each secure port, and allows repeater ports to be configured for security on a per port basis. It is indexed using the object ifIndex in RFC1213-MIB. | |
| INT h3cSecurePortMode | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1.1 | INTEGER | read-write | Determines the learning and security modes of the port. See h3cSecureNeedToKnowMode and h3cSecureIntrusionAction to configure Need To Know and Intrusion Action on each port. (When in a learning mode, h3cSecureNumberAddresses determines the maximum number of addresses that can be learned on the port. This is set by the user.) noRestrictions(1) All of the security features are disabled. continuousLearning(2) Addresses are learned continually. If more addresses are learned than are permitted on the port, then one of the older entries will be aged out. Need To Know and Intrusion Action depends on h3cSecureNeedToKnowMode and h3cSecureIntrusionAction respectively. autoLearn(3) All addresses for this port are deleted, and then addresses are learned up to the number permitted. h3cSecurePortMode is then set to secure. Need To Know and Intrusion Action depends on h3cSecureNeedToKnowMode and h3cSecureIntrusionAction respectively. secure(4) Learning is disabled. Need To Know and Intrusion Action depends on h3cSecureNeedToKnowMode and h3cSecureIntrusionAction respectively. userLogin(5) Access to the port is denied until the port client is authorised (by 802.1X or other authentication mechanism). Once authorised, traffic will be accepted from any MAC address. The Need To Know and Intrusion Action are ignored. userLoginSecure(6) Access to the port is denied until the port client is authorised (by 802.1X or other authentication mechanism). When the client is authorised, the MAC address is added to the Secure Address Table. The h3cSecureMaximumAddresses is set to one automatically when this mode is entered. Any existing MAC addresses in the Secure Address Table are deleted. Need To Know and Intrusion Action depends on h3cSecureNeedToKnowMode and h3cSecureIntrusionAction respectively. Learning is disabled. userLoginWithOUI(7) This mode is similar to the userLoginSecure mode except that a second MAC address may be placed in the Secure Address Table. This second address is authorised based on the MAC address OUI value. If a new device with an authorised OUI value is discovered, the previous entry is deleted. Traffic from the OUI authorised device will be accepted even if the user has not been authenticated. Need To Know and Intrusion Action depends on h3cSecureNeedToKnowMode and h3cSecureIntrusionAction respectively. macAddressWithRadius(8) This selects the RADIUS Authenticated Login using MAC-address (RALM) security mode on the port. This feature controls network access of a host based on authenticating its MAC address. Once authorised, the host is allowed access to the network. If unauthorised, the port can be configured to deny access to this MAC address or to allow some access depending upon the port VLAN and QoS configuration. Where access is allowed, the MAC address is added to the Secure Address Table. macAddressOrUserLoginSecure(9) This selects both the macAddressWithRadius and userLoginSecure modes together such that either or both are allowed to authorised access. Where both authorised access, userLoginSecure takes precedence. macAddressElseUserLoginSecure(10) This selects both the macAddressWithRadius and userLoginSecure modes together such that the MAC address is first authenticated and only if this fails does the userLoginSecure then attempt user authentication. userLoginSecureExt(11) Access to the port is denied until the port client is authorised (by 802.1X or other authentication mechanism). When the client is authorised, the MAC address is added to the Secure Address Table. The h3cSecureNumberAddresses is restricted by the value of h3cSecureMaximumAddresses automatically when this mode is entered. Any existing MAC addresses in the Secure Address Table are deleted. Need To Know and Intrusion Action depends on h3cSecureNeedToKnowMode and h3cSecureIntrusionAction respectively. Learning is disabled. macAddressOrUserLoginSecureExt(12) This selects both the macAddressWithRadius and userLoginSecureExt modes together such that either or both are allowed to authorised access. Where both authorised access, userLoginSecure takes precedence. macAddressElseUserLoginSecureExt(13) This selects both the macAddressWithRadius and userLoginSecureExt modes together such that the MAC address is first authenticated and only if this fails does the userLoginSecure then attempt user authentication. macAddressAndUserLoginSecure(14) This selects both the macAddressWithRadius and userLoginSecure modes together such that the MAC address is first authenticated and only if this succeeds does the userLoginSecure then attempt user authentication. macAddressAndUserLoginSecureExt(15) This selects both the macAddressWithRadius and userLoginSecureExt modes together such that the MAC address is first authenticated and only if this succeeds does the userLoginSecure then attempt user authentication. |
| INT h3cSecureNeedToKnowMode | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1.2 | INTEGER | read-write | Attribute to determine which frames are to be forwarded to this port intact. 1 - Need To Know is not available. 2 - All frames. 3 - Frames addressed to the authorised devices only. 4 - Frames addressed to the authorised devices, plus all broadcast frames. 5 - Frames addressed to the authorised devices, plus all broadcast and multicast frames. 6 - As 3 and cannot be changed. 7 - As 4 and cannot be changed. 8 - As 5 and cannot be changed. If this object returns 1,6,7 or 8, it means that the Need To Know configuration cannot be changed, and any attempt to write to this object will cause an error. |
| INT h3cSecureIntrusionAction | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1.3 | INTEGER | read-write | Attribute to determine the action if an unauthorised device transmits on this port. |
| I32 h3cSecureNumberAddresses | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1.4 | Integer32 | read-write | The maximum number of addresses that the port can learn or store. Reducing this number may cause some addresses to be deleted. This value is set by the user and cannot be automatically changed by the agent. The maximum number will not include and limit the number of static mac addresses that configured by manager. The following relationship must be preserved. h3cSecureNumberAddressesStored <= h3cSecureNumberAddresses <= h3cSecureMaximumAddresses |
| I32 h3cSecureNumberAddressesStored | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1.5 | Integer32 | read-only | The number of addresses that are currently in the AddressTable for this port. If this object has the same value as h3cSecureNumberAddresses, then no more addresses can be authorised on this port. The number will not include and limit the number of static mac addresses that configured by manager. Those objects are bound by the relationship: h3cSecureNumberAddressesStored <= h3cSecureNumberAddresses <= h3cSecureMaximumAddresses |
| I32 h3cSecureMaximumAddresses | 1.3.6.1.4.1.2011.10.2.26.1.2.1.1.6 | Integer32 | read-only | This indicates the maximum value that h3cSecureNumberAddresses can be set to. It is dependent on the resources available so may change, eg. if resources are shared between ports, then this value can both increase and decrease. This object must be read before setting h3cSecureNumberAddresses. Those objects are bound by the relationship: h3cSecureNumberAddressesStored <= h3cSecureNumberAddresses <= h3cSecureMaximumAddresses |
| h3cSecureAddressTable | 1.3.6.1.4.1.2011.10.2.26.1.2.2 | not-accessible | This table stores the MAC addresses assigned to each port. This table can be written to by the agent as well as the management station. | |
| h3cSecureAddressEntry | 1.3.6.1.4.1.2011.10.2.26.1.2.2.1 | not-accessible | This table allows multiple addresses to be assigned to each secure port. It is indexed using the objects ifIndex, h3cSecureAddrMAC and h3cSecureVlanID. | |
| MAC h3cSecureAddrMAC | 1.3.6.1.4.1.2011.10.2.26.1.2.2.1.1 | MacAddress | accessible-for-notify | The MAC address of a station assigned to this port. This is the second index into the h3cSecureAddressTable. |
| I32 h3cSecureAddrVlanID | 1.3.6.1.4.1.2011.10.2.26.1.2.2.1.2 | Integer32 | read-create | The Vlan ID associate with the port and the MAC address. This is the third index into the h3cSecureAddressTable. |
| INT h3cSecureAddrMACStatus | 1.3.6.1.4.1.2011.10.2.26.1.2.2.1.3 | INTEGER | read-create | The state of the mac address assigned to this port. addressBlackhole (1) the mac address is a blackhole address, Each packet whose source address is equal to this address will be dropped by the agent. addressUserConfig (2) the mac address configed by user with this state are preserved across power cycles and resets. addressDot1xAuth (3) the mac address is authorized by 802.1x authenticator, User can not configure this mac address. This value is used for GET and GETNEXT operation. addressRALM (4) the mac address is authorized by RALM authenticator, User can not configure this mac address. This value is used for GET and GETNEXT operation. |
| ROW h3cSecureAddrRowStatus | 1.3.6.1.4.1.2011.10.2.26.1.2.2.1.4 | RowStatus | read-create | This manages the creation and deletion or rows, and shows the current status of the indexed MAC address. This object has the following values. active(1) The indexed MAC address is authorised on this port. notInService(2) Not Supported. notReady(3) Not Supported. createAndGo(4) Assign a new MAC address to the port and authorise immediately. createAndWait(5) Not Supported. destroy(6) Delete this entry. When creating a new entry, index a new row and use createAndGo(4). When reading this object, only active(1) will be returned. |
| h3cSecureOUITable | 1.3.6.1.4.1.2011.10.2.26.1.2.3 | not-accessible | This table stores the OUI values for OUI based authentication. | |
| h3cSecureOUIEntry | 1.3.6.1.4.1.2011.10.2.26.1.2.3.1 | not-accessible | This is a row in the h3cSecureOUITable. | |
| INT h3cSecureOUIIndex | 1.3.6.1.4.1.2011.10.2.26.1.2.3.1.1 | INTEGER | not-accessible | The index number. This is the first index into the h3cSecureOUITable. |
| OCT h3cSecureOUI | 1.3.6.1.4.1.2011.10.2.26.1.2.3.1.2 | OCTET STRING | read-create | The OUI value for an authorised device. |
| ROW h3cSecureOUIRowStatus | 1.3.6.1.4.1.2011.10.2.26.1.2.3.1.3 | RowStatus | read-create | This manages the creation and deletion of rows, and shows the current status of the entry. active(1) The indexed OUI value is authorised. notInService(2) Not Supported. notReady(3) Not Supported. createAndGo(4) Assign a new OUI to the unit and authorise immediately. createAndWait(5) Not Supported. destroy(6) Delete this entry. When creating a new entry, index a new row and use createAndGo(4) . When reading this object, only active(1) will be returned. |
| h3cSecureBindingTable | 1.3.6.1.4.1.2011.10.2.26.1.2.4 | not-accessible | This table stores the elements of binding rules include the MAC addresses, the IP address and the port. Only the frame exactly matching the binding rules can be forwarded. This table can be written to by the agent as well as the management station. | |
| h3cSecureBindingEntry | 1.3.6.1.4.1.2011.10.2.26.1.2.4.1 | not-accessible | This table allows multiple binding rules. It is indexed using the object h3cSecureBindingIndex. | |
| I32 h3cSecureBindingIndex | 1.3.6.1.4.1.2011.10.2.26.1.2.4.1.1 | Integer32 | not-accessible | The index number. This is the first index into the h3cSecureBindingTable. |
| I32 h3cSecureBindingPort | 1.3.6.1.4.1.2011.10.2.26.1.2.4.1.2 | Integer32 | read-create | The port number of the port bound with the IP address and the MAC address. |
| MAC h3cSecureBindingAddrMAC | 1.3.6.1.4.1.2011.10.2.26.1.2.4.1.3 | MacAddress | read-create | The MAC address bound with the port and the IP address. |
| IP h3cSecureBindingAddrIp | 1.3.6.1.4.1.2011.10.2.26.1.2.4.1.4 | IpAddress | read-create | The IP address bound with the port and the MAC address. |
| ROW h3cSecureBindingRowStatus | 1.3.6.1.4.1.2011.10.2.26.1.2.4.1.5 | RowStatus | read-create | This manages the creation and deletion or rows, and shows status of the entry. This object has the following values. active(1) The indexed MAC address is authorised on this port. notInService(2) Not Supported. notReady(3) Not Supported. createAndGo(4) Assign a new MAC address to the port and authorise immediately. createAndWait(5) Not Supported. destroy(6) Delete this entry. When creating a new entry, index a new row and use createAndGo(4). When reading this object, only active(1) will be returned. |
| h3cSecureAssignTable | 1.3.6.1.4.1.2011.10.2.26.1.2.5 | not-accessible | Table of port assignment management information about authorised user. | |
| h3cSecureAssignEntry | 1.3.6.1.4.1.2011.10.2.26.1.2.5.1 | not-accessible | An entry (conceptual row) representing information about port assignment about authorised user. | |
| T/F h3cSecureAssignEnable | 1.3.6.1.4.1.2011.10.2.26.1.2.5.1.1 | TruthValue | read-write | The user-based port configuration control. Setting this attribute TRUE causes the port to be configured with any configuration parameters supplied by the authentication server. Setting this attribute to FALSE causes any configuration parameters supplied by the authentication server to be ignored. |
| OCT h3cSecureVlanAssignment | 1.3.6.1.4.1.2011.10.2.26.1.2.5.1.2 | OCTET STRING | read-only | The VLAN membership assigned to the port for the authorised user. This contains the actual value received from the authentication server. This object will contain a null value if there is no user authorised to access the port or if the authorised user was not assigned a VLAN membership. |
| h3cPortSecurityNotifications | 1.3.6.1.4.1.2011.10.2.26.1.3 | |||
| NTF h3cSecureAddressLearned | 1.3.6.1.4.1.2011.10.2.26.1.3.1 | This trap is sent when a new station has been learned. The port on which the address was received is the first object, and the MAC address of the learned station is in the second object. | ||
| NTF h3cSecureViolation | 1.3.6.1.4.1.2011.10.2.26.1.3.2 | This trap is sent whenever a security violation has occurred. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. ifAdminStatus indicates if the port has been disabled because of the violation. The implementation may not send violation traps from the same port at intervals of less than 5 seconds. | ||
| NTF h3cSecureLoginFailure | 1.3.6.1.4.1.2011.10.2.26.1.3.3 | This trap is sent whenever a user network access authentication has failed. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. The dot1xAuthSessionUserName is the identity supplied during the user authentication. | ||
| NTF h3cSecureLogon | 1.3.6.1.4.1.2011.10.2.26.1.3.4 | This trap is sent when a new session is started for an authorised port user. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. The dot1xAuthSessionUserName is the identity supplied during the user authentication. The dot1xAuthSessionAuthenticMethod indicates how the user was authorised. The h3cSecurePortVlanMembershipList object identifies the VLAN membership assigned to the port on session activation. | ||
| NTF h3cSecureLogoff | 1.3.6.1.4.1.2011.10.2.26.1.3.5 | This trap is sent when a user session is terminated. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. The dot1xAuthSessionUserName is the identity supplied during the user authentication. The dot1xAuthSessionTerminateCause indicates the reason why the session was terminated. The h3cSecurePortVlanMembershipList object identifies the VLAN membership assigned to the port on session termination. | ||
| NTF h3cSecureRalmLoginFailure | 1.3.6.1.4.1.2011.10.2.26.1.3.6 | This trap is sent whenever a user network access authentication has failed. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. The authentication mode indicates how the user was authorised. The h3cSecureRalmAuthUsername is the identity supplied during the user authentication. | ||
| NTF h3cSecureRalmLogon | 1.3.6.1.4.1.2011.10.2.26.1.3.7 | This trap is sent when a new session is started for an authorised port user. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. The authentication mode indicates how the user was authorised. The h3cSecureRalmAuthUsername is the identity supplied during the user authentication. The h3cSecurePortVlanMembershipList object identifies the VLAN membership assigned to the port on session activation. | ||
| NTF h3cSecureRalmLogoff | 1.3.6.1.4.1.2011.10.2.26.1.3.8 | This trap is sent when a new session is started for an authorised port user. The port on which the violation occured is the first object, and the MAC address of the offending station is in the second object. The authentication mode indicates how the user was authorised. The h3cSecureRalmAuthUsername is the identity supplied during the user authentication. The h3cSecurePortVlanMembershipList object identifies the VLAN membership assigned to the port on session activation. |
RFC description
Implements port security and network access control for Huawei 3Com switches with authentication and MAC binding.
Start monitoring H3C switch (port security/802.1X RALM authentication) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.