snmpkey(1p) [debian man page]

SNMPKEY(1p)						User Contributed Perl Documentation					       SNMPKEY(1p)

NAME

       snmpkey - Create SNMPv3 security keys for the Net::SNMP module

USAGE

       The "snmpkey" utility generates security keys based on a password and an authoritativeEngineID passed on the command line.  This key can
       then be used by the Net::SNMP module instead of the plain text password when creating SNMPv3 objects.

	  snmpkey <authProto> <password> <authEngineID> [<privProto> [<password>]]

DESCRIPTION

       The User-based Security Model used by SNMPv3 defines an algorithm which "localizes" a plain text password to a specific
       authoritativeEngineID using a one-way hash.  This resulting key is used by the SNMP application instead of the plain text password for
       security reasons.

       The Net::SNMP module allows the user to either provide a plain text password or a localized key to the object constructor when configuring
       authentication or privacy.  The "snmpkey" utility can be used to generate the key to be used by the -authkey or -privkey named arguments
       when they are passed to the Net::SNMP "session()" constructor.

REQUIRED ARGUMENTS

       The "snmpkey" utility requires at least three command line arguments.  The first argument defines which hash algorithm to use when creating
       the authKey.  Either HMAC-MD5-96 or HMAC-SHA-96 can be specified with the string 'md5' or 'sha' respectively.  This choice must match the
       algorithm passed to the -authprotocol argument when creating the Net::SNMP object.  The second argument is the plain text password that is
       to be localized to create the authKey.  The third required argument is the authoritativeEngineID of the remote SNMP engine associated with
       the Net::SNMP argument -hostname.  The authoritativeEngineID is to be entered as a hexadecimal string 10 to 64 characters (5 to 32 octets)
       long and can be prefixed with an optional "0x".

       The last two arguments are optional and can be used to determine how the privKey will be generated.  By default, the fourth argument
       assumes a value of 'des' corresponding to the default privacy protocol defined in the User-based Security Model.  The Net::SNMP module
       supports CBC-3DES-EDE and CFB128-AES-128 as alternatives to the default protocol CBC-DES.  These protocols can be chosen by specifying the
       string '3des' or 'aes' respectively.  This choice must match the protocol passed to the -privprotocol argument when creating the Net::SNMP
       object.	The last argument can be used to specify the plain text password that is to be localized to create the privKey.  If this argument
       is not specified, the authKey password is used.

AUTHOR

       David M. Town <dtown@cpan.org>

LICENSE AND COPYRIGHT

       Copyright (c) 2001-2009 David M. Town.  All rights reserved.

       This program is free software; you may redistribute it and/or modify it under the same terms as the Perl 5 programming language system
       itself.

SEE ALSO

       Net::SNMP

perl v5.12.4							    2011-08-24							       SNMPKEY(1p)

Check Out this Related Man Page

Info::Layer3::NetSNMP(3pm)				User Contributed Perl Documentation				Info::Layer3::NetSNMP(3pm)

NAME

       SNMP::Info::Layer3::NetSNMP - SNMP Interface to L3 Net-SNMP Devices

AUTHORS

       Bradley Baetz and Bill Fenner

SYNOPSIS

	# Let SNMP::Info determine the correct subclass for you.
	my $netsnmp = new SNMP::Info(
				 AutoSpecify => 1,
				 Debug	     => 1,
				 DestHost    => 'myrouter',
				 Community   => 'public',
				 Version     => 2
			       )
	   or die "Can't connect to DestHost.
";

	my $class      = $netsnmp->class();
	print "SNMP::Info determined this device to fall under subclass : $class
";

DESCRIPTION

       Subclass for Generic Net-SNMP devices

   Inherited Classes
       SNMP::Info::Layer3

   Required MIBs
       UCD-SNMP-MIB
       NET-SNMP-TC
       HOST-RESOURCES-MIB
       Inherited Classes' MIBs
	   See SNMP::Info::Layer3 for its own MIB requirements.

GLOBALS

       These are methods that return scalar value from SNMP

       $netsnmp->vendor()
	   Returns 'Net-SNMP'.

       $netsnmp->os()
	   Returns the OS extracted from "sysDescr".

       $netsnmp->os_ver()
	   Returns the software version extracted from "sysDescr", along with the Net-SNMP version.

       $netsnmp->uptime()
	   Returns the system uptime instead of the agent uptime.  NOTE: discontinuity timers and other Time Stamp based objects are based on
	   agent uptime, so use orig_uptime().

       $netsnmp->serial()
	   Returns ''.

   Globals imported from SNMP::Info::Layer3
       See documentation in SNMP::Info::Layer3 for details.

TABLE ENTRIES

       These are methods that return tables of information in the form of a reference to a hash.

   Overrides
       $netsnmp->i_ignore()
	   Returns reference to hash.  Increments value of IID if port is to be ignored.

	   Ignores loopback

   Table Methods imported from SNMP::Info::Layer3
       See documentation in SNMP::Info::Layer3 for details.

NOTES

       In order to cause SNMP::Info to classify your device into this class, it may be necessary to put a configuration line into your snmpd.conf
       similar to

	 sysobjectid .1.3.6.1.4.1.8072.3.2.N

       where N is the object ID for your OS from the "NET-SNMP-TC" MIB (or 255 if not listed).	Some Net-SNMP installations default to an
       incorrect return value for "system.sysObjectId".

       In order to recognize a Net-SNMP device as Layer3, it may be necessary to put a configuration line similar to

	 sysservices 76

       in your snmpd.conf.

perl v5.12.4							    2011-09-28						Info::Layer3::NetSNMP(3pm)

Linux and UNIX Man Pages

snmpkey(1p) [debian man page]

Check Out this Related Man Page