snmpkey man page on SuSE

Man page or keyword search:  
man Server   14857 pages
apropos Keyword Search (all sections)
Output format
SuSE logo
[printable version]

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

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

SYNOPSIS
       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.

       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>

COPYRIGHT
       Copyright (c) 2001-2005 David M. Town.  All rights reserved.  This
       program is free software; you may redistribute it and/or modify it
       under the same terms as Perl itself.

SEE ALSO
       Net::SNMP

perl v5.10.0			  2009-02-21			    SNMPKEY(1)
[top]

List of man pages available for SuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net