snmp_mib_archive/CISCO-LWAPP-LOCAL-AUTH-MIB.my
Heston Snodgrass 89bf4b016e initial commit
2016-12-15 15:03:18 -07:00

572 lines
20 KiB
Plaintext

-- *******************************************************************
-- CISCO-LWAPP-LOCAL-AUTH-MIB.my
-- March 2007, Devesh Pujari, Srinath Candadai
--
-- Copyright (c) 2007 by Cisco Systems, Inc.
-- All rights reserved.
-- *******************************************************************
CISCO-LWAPP-LOCAL-AUTH-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Unsigned32,
Integer32
FROM SNMPv2-SMI
MODULE-COMPLIANCE,
OBJECT-GROUP
FROM SNMPv2-CONF
DisplayString,
RowStatus,
TruthValue
FROM SNMPv2-TC
ciscoMgmt
FROM CISCO-SMI
cLWlanIndex
FROM CISCO-LWAPP-WLAN-MIB;
-- ********************************************************************
-- * MODULE IDENTITY
-- ********************************************************************
ciscoLwappLocalAuthMIB MODULE-IDENTITY
LAST-UPDATED "200703150000Z"
ORGANIZATION "Cisco Systems Inc."
CONTACT-INFO
"Cisco Systems,
Customer Service
Postal: 170 West Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
Email: cs-wnbu-snmp@cisco.com"
DESCRIPTION
"This MIB is intended to be implemented on all those
devices operating as Central controllers, that
terminate the Light Weight Access Point Protocol
tunnel from Cisco Light-weight LWAPP Access Points.
Information provided by this MIB is used to manage
Local authentication information on the controller.
The relationship between CC and the LWAPP APs
can be depicted as follows:
+......+ +......+ +......+
+ + + + + +
+ CC + + CC + + CC +
+ + + + + +
+......+ +......+ +......+
.. . .
.. . .
. . . .
. . . .
. . . .
. . . .
+......+ +......+ +......+ +......+
+ + + + + + + +
+ AP + + AP + + AP + + AP +
+ + + + + + + +
+......+ +......+ +......+ +......+
. . .
. . . .
. . . .
. . . .
. . . .
+......+ +......+ +......+ +......+
+ + + + + + + +
+ MN + + MN + + MN + + MN +
+ + + + + + + +
+......+ +......+ +......+ +......+
The LWAPP tunnel exists between the controller and
the APs. The MNs communicate with the APs through
the protocol defined by the 802.11 standard.
LWAPP APs, upon bootup, discover and join one of the
controllers and the controller pushes the configuration,
that includes the WLAN parameters, to the LWAPP APs.
The APs then encapsulate all the 802.11 frames from
wireless clients inside LWAPP frames and forward
the LWAPP frames to the controller.
GLOSSARY
Access Point ( AP )
An entity that contains an 802.11 medium access
control ( MAC ) and physical layer ( PHY ) interface
and provides access to the distribution services via
the wireless medium for associated clients.
LWAPP APs encapsulate all the 802.11 frames in
LWAPP frames and sends them to the controller to which
it is logically connected.
Gratuitous Probe Response (GPR)
The Gratuitous Probe Response feature aids in conserving
battery power of WLAN-enabled cell phones by providing
a high rate packet on the order of tens of milliseconds
such that these kind of phones can wake up and wait at
predefined intervals, to reduce battery power. The
GPR packet is transmitted from the AP at a predefined
time interval.
Light Weight Access Point Protocol ( LWAPP )
This is a generic protocol that defines the
communication between the Access Points and the
Central Controller.
Mobile Node ( MN )
A roaming 802.11 wireless device in a wireless
network associated with an access point. Mobile Node
and client are used interchangeably.
Extensible Authentication Protocol ( EAP )
EAP is a universal authentication protocol used in
wireless and PPP networks. It is defined by RFC 3748.
EAP-Flexible Authentication ( EAP-FAST )
This protocol is used via secure tunneling for 802.1X EAP.
Transport Layer Security ( TLS )
This is a cryptographic protocol which provides secure
communication over the network.
Lightweight Directory Access Protocol ( LDAP )
LDAP is a protocol used for obtaining directory services
and runs over TCP/IP.
REFERENCE
[1] Wireless LAN Medium Access Control ( MAC ) and
Physical Layer ( PHY ) Specifications
[2] Draft-obara-capwap-lwapp-00.txt, IETF Light
Weight Access Point Protocol"
REVISION "200703150000Z"
DESCRIPTION
"Initial version of this MIB module."
::= { ciscoMgmt 619 }
ciscoLwappLocalAuthMIBNotifs OBJECT IDENTIFIER
::= { ciscoLwappLocalAuthMIB 0 }
ciscoLwappLocalAuthMIBObjects OBJECT IDENTIFIER
::= { ciscoLwappLocalAuthMIB 1 }
ciscoLwappLocalAuthMIBConform OBJECT IDENTIFIER
::= { ciscoLwappLocalAuthMIB 2 }
cllaConfig OBJECT IDENTIFIER
::= { ciscoLwappLocalAuthMIBObjects 1 }
-- ********************************************************************
-- Global Local Auth configs
-- ********************************************************************
cllaLocalAuth OBJECT IDENTIFIER
::= { cllaConfig 1 }
cllaActiveTimeout OBJECT-TYPE
SYNTAX Unsigned32 (1..3600 )
UNITS "seconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The timeout period for the Local EAP to remain
active, in seconds."
DEFVAL { 300 }
::= { cllaLocalAuth 1 }
-- ********************************************************************
-- EAP Profile
-- ********************************************************************
cllaEapProfileTable OBJECT-TYPE
SYNTAX SEQUENCE OF CllaEapProfileEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table represents the local EAP authentication
information on the controller.
Rows are added or deleted by explicit
management actions initiated by the user from a
network management station through the
cllaEapProfileRowStatus object."
::= { cllaConfig 2 }
cllaEapProfileEntry OBJECT-TYPE
SYNTAX CllaEapProfileEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in cllaEapProfileTable. Each
entry in this table represents the local EAP
authentication information, identified by
the cllEapProfileName."
INDEX { cllaEapProfileName }
::= { cllaEapProfileTable 1 }
CllaEapProfileEntry ::= SEQUENCE {
cllaEapProfileName DisplayString,
cllaEapProfileMethods BITS,
cllaEapProfileCertIssuer INTEGER ,
cllaEapProfileCaCertificationCheck TruthValue,
cllaEapProfileCnCertificationIdVerify TruthValue,
cllaEapProfileDateValidityEnabled TruthValue,
cllaEapProfileLocalCertificateRequired TruthValue,
cllaEapProfileClientCertificateRequired TruthValue,
cllaEapProfileRowStatus RowStatus
}
cllaEapProfileName OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..63))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object represent the profile name used to identify
the Local EAP information."
::= { cllaEapProfileEntry 1 }
cllaEapProfileMethods OBJECT-TYPE
SYNTAX BITS {
none(0),
leap(1),
eapFast(2),
tls(3)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object represents the method type for this
entry.
none - No method is in use
leap - LEAP is used as one of the methods
eap-fast - EAP-FAST is used as one of the methods
tls - TLS is being used as one of the methods."
::= { cllaEapProfileEntry 2 }
cllaEapProfileCertIssuer OBJECT-TYPE
SYNTAX INTEGER {
cisco(1),
vendor(2)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object represents the name of the certificate issuer
cisco - Cisco is the certificate issuer.
vendor - The issuer is an outside vendor."
DEFVAL { cisco }
::= { cllaEapProfileEntry 3 }
cllaEapProfileCaCertificationCheck OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This parameter indicates whether to check peer certificate
against installed CA certificates."
DEFVAL { true }
::= { cllaEapProfileEntry 4 }
cllaEapProfileCnCertificationIdVerify OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This parameter indicates whether to verify certificate
CN against peer identity and user database."
DEFVAL { false }
::= { cllaEapProfileEntry 5 }
cllaEapProfileDateValidityEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This parameter indicates whether to verify certificate
date is valid and is within validity period."
DEFVAL { true }
::= { cllaEapProfileEntry 6 }
cllaEapProfileLocalCertificateRequired OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This is applicable when cllaEapProfileMethods is
EAP-FAST parameter. This parameter indicates
whether local certificate is required."
DEFVAL { false }
::= { cllaEapProfileEntry 7 }
cllaEapProfileClientCertificateRequired OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This is applicable when cllaEapProfileMethods is
EAP-FAST parameter. This parameter indicates
whether client certificate is required."
DEFVAL { false }
::= { cllaEapProfileEntry 8 }
cllaEapProfileRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Used to add or delete an entry in this table."
::= { cllaEapProfileEntry 9 }
-- ********************************************************************
-- WLAN Profile table
-- ********************************************************************
cllaWlanProfileTable OBJECT-TYPE
SYNTAX SEQUENCE OF CllaWlanProfileEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table represents the information about configuring
the EAP profiles for a WLAN. The creation of a new row
occurs when a WLAN entry is added through an explicit
network management action to the cLWlanConfigTable in
CISCO-LWAPP-WLAN-MIB.
Similarly, deletion of a row in cLWlanConfigTable
through user action, causes the deletion of corresponding
row in this table."
::= { cllaConfig 3 }
cllaWlanProfileEntry OBJECT-TYPE
SYNTAX CllaWlanProfileEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry in this table provides information about
the Local EAP profile configured for this WLAN."
INDEX { cLWlanIndex }
::= { cllaWlanProfileTable 1 }
CllaWlanProfileEntry ::= SEQUENCE {
cllaWlanProfileName DisplayString,
cllaWlanProfileState TruthValue
}
cllaWlanProfileName OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..63))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The profile name configured for this WLAN."
::= { cllaWlanProfileEntry 1 }
cllaWlanProfileState OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object indicates whether Local Authentication
is enabled or disables for this WLAN."
::= { cllaWlanProfileEntry 2 }
-- ********************************************************************
-- User Credential Priority Table
-- ********************************************************************
cllaUserPriorityTable OBJECT-TYPE
SYNTAX SEQUENCE OF CllaUserPriorityEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains entries for 802.11 user credential
methods configured in the controller. At startup,
all the entries in this table are set up by the central
controller. A management application can later change
the priority order using the cllaUserPriorityNumber."
::= { cllaConfig 4 }
cllaUserPriorityEntry OBJECT-TYPE
SYNTAX CllaUserPriorityEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in cllaUserPriorityTable. There is an
entry in this table for each 802.11 user authentication
available at the agent, as identified by a value of
cllaUserCredential."
INDEX { cllaUserCredential }
::= { cllaUserPriorityTable 1 }
CllaUserPriorityEntry ::= SEQUENCE {
cllaUserCredential INTEGER ,
cllaUserPriorityNumber Integer32
}
cllaUserCredential OBJECT-TYPE
SYNTAX INTEGER {
local(1),
ldap(2)
}
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object represents the user crediantial information.
local - indicates that local credential is used
for authentication
ldap - indicates that LDAP credential is used
for authentication."
::= { cllaUserPriorityEntry 1 }
cllaUserPriorityNumber OBJECT-TYPE
SYNTAX Integer32 (0..2 )
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object represents the order in which the user credentials
are validated by the controller. At start up,
the agent assigns the value of this object. Later this can
be changed by the management station.
This object reflects the priority in which the user credential
information is applied. A lower value indicates an higher
priority. For example, an entry set to value '1' has a higher
priority over an entry set to value '2'.
The zero value indicates that the priority is not set.
No two instances of this object will have the same priority."
::= { cllaUserPriorityEntry 2 }
-- ********************************************************************
-- Local-auth eap-fast method parameters
-- ********************************************************************
cllaEapParams OBJECT IDENTIFIER
::= { cllaConfig 5 }
cllaEapMethodPacTtl OBJECT-TYPE
SYNTAX Unsigned32 (1..1000 )
UNITS "days"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This is EAP Fast parameter. This parameter represents
time to live for the protected access credentials."
DEFVAL { 10 }
::= { cllaEapParams 1 }
cllaEapAnonymousProvEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This is EAP Fast parameter. This parameter represents
whether anonymous provisioning is enabled. A value of
'true' indicates the controller will accept anonymous
requests. A value of 'false' indicates that the controller
will reject anonymous requests."
DEFVAL { true }
::= { cllaEapParams 2 }
cllaEapAuthorityId OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..128))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This is EAP Fast parameter. This parameter configures
the authority ID. The maximum length per platform is
specified by the cllaEapAuthorityIdLength object."
::= { cllaEapParams 3 }
cllaEapAuthorityInfo OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This is EAP Fast parameter. This parameter configures
the authority information."
::= { cllaEapParams 4 }
cllaEapServerKey OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (1..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This is EAP Fast parameter. This parameter configures
the server key ID."
::= { cllaEapParams 5 }
cllaEapAuthorityIdLength OBJECT-TYPE
SYNTAX Unsigned32 (0..128 )
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object represents the length of the cllaEapAuthorityId
object, supported by this agent implementation."
DEFVAL { 32 }
::= { cllaEapParams 6 }
-- ********************************************************************
-- * Units of conformance
-- ********************************************************************
ciscoLwappLocalAuthMIBCompliances OBJECT IDENTIFIER
::= { ciscoLwappLocalAuthMIBConform 1 }
ciscoLwappLocalAuthMIBGroups OBJECT IDENTIFIER
::= { ciscoLwappLocalAuthMIBConform 2 }
ciscoLwappLocalAuthMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for the SNMP entities that
implement the ciscoLwappLocalAuthMIB module."
MODULE -- this module
MANDATORY-GROUPS { ciscoLwappLocalAuthMIBConfigGroup }
::= { ciscoLwappLocalAuthMIBCompliances 1 }
ciscoLwappLocalAuthMIBConfigGroup OBJECT-GROUP
OBJECTS {
cllaActiveTimeout,
cllaEapProfileMethods,
cllaEapProfileCertIssuer,
cllaEapProfileCaCertificationCheck,
cllaEapProfileCnCertificationIdVerify,
cllaEapProfileDateValidityEnabled,
cllaEapProfileLocalCertificateRequired,
cllaEapProfileClientCertificateRequired,
cllaEapProfileRowStatus,
cllaWlanProfileName,
cllaWlanProfileState,
cllaUserPriorityNumber,
cllaEapMethodPacTtl,
cllaEapAnonymousProvEnabled,
cllaEapAuthorityId,
cllaEapAuthorityInfo,
cllaEapServerKey,
cllaEapAuthorityIdLength
}
STATUS current
DESCRIPTION
"This collection of objects specifies the required
configuration parameters for local authentication."
::= { ciscoLwappLocalAuthMIBGroups 1 }
END