public class SnmpV3Packet : SnmpPacket

Public Class SnmpV3Packet _
	Inherits SnmpPacket

public ref class SnmpV3Packet : public SnmpPacket

Available packet classes are:

• SnmpV1Packet
• SnmpV1TrapPacket
• SnmpV2Packet
• SnmpV3Packet

This class is provided to simplify encoding and decoding of packets and to provide consistent interface for users who wish to handle transport part of protocol on their own without using the UdpTarget class. SnmpPacket and derived classes have been developed to implement SNMP version 1, 2 and 3 packet support. For SNMP version 1 and 2 packet, SnmpV1Packet and SnmpV2Packet classes provide sufficient support for encoding and decoding data to/from BER buffers to satisfy requirements of most applications. SNMP version 3 on the other hand requires a lot more information to be passed to the encoder method and returned by the decode method. While using SnmpV3Packet class for full packet handling is possible, transport specific class UdpTarget uses SecureAgentParameters class to store protocol version 3 specific information that carries over from request to request when used on the same SNMP agent and therefore simplifies both initial definition of agents configuration (mostly security) as well as removes the need for repeated initialization of the packet class for subsequent requests. If you decide not to use transport helper class(es) like UdpTarget, BER encoding and decoding and packets is easily done with SnmpPacket derived classes. Example, SNMP version 1 packet encoding:

CopyC#

SnmpV1Packet packetv1 = new SnmpV1Packet();
packetv1.SnmpCommunity.Set("public");
packetv1.Pdu.Set(mypdu);
byte[] berpacket = packetv1.encode();

Example, SNMP version 3 noAuthNoPriv encoding:

CopyC#

SnmpV3Packet packetv3 = new SnmpV3Packet();
packetv3.noAuthNoPriv("myusername");
packetv3.SetEngineTime(engineTime, engineBoots); // See SNMPv3 discovery process for details
packetv3.SetEngineId(engineId); // See SNMPv3 discovery process for details
packetv3.IsReportable = true;
packetv3.Pdu.Set(mypdu);
byte[] berpacket = packetv3.encode();

Example, SNMP version 3 authNoPriv using MD5 authentication packet encoding:

CopyC#

SnmpV3Packet packetv3 = new SnmpV3Packet();
packetv3.authNoPriv("myusername", "myAuthenticationPassword", AuthenticationDigests.MD5);
packetv3.SetEngineTime(engineTime, engineBoots); // See SNMPv3 discovery process for details
packetv3.SetEngineId(engineId); // See SNMPv3 discovery process for details
packetv3.IsReportable = true;
packetv3.Pdu.Set(mypdu);
byte[] berpacket = packetv3.encode();

Example, SNMP version 3 authPriv using MD5 authentication and DES encryption packet encoding:

CopyC#

SnmpV3Packet packetv3 = new SnmpV3Packet();
packetv3.authPriv("myusername", "myAuthenticationPassword", AuthenticationDigests.MD5,
       "myPrivacyPassword", PrivacyProtocols.DES);
packetv3.SetEngineTime(engineTime, engineBoots); // See SNMPv3 discovery process for details
packetv3.SetEngineId(engineId); // See SNMPv3 discovery process for details
packetv3.IsReportable = true;
packetv3.Pdu.Set(mypdu);
byte[] berpacket = packetv3.encode();

When decoding SNMP version 3 packets, SnmpV3Packet class needs to be initialized with the same values security values as a request does. This includes, authoritative engine id, engine boots and engine time, if authentication is used, authentication digest and password and for encryption, password and privacy protocol used. Without these parameters packet class will not be able to verify the incoming packet and responses will be discarded even if they are valid.

System..::.Object
  SnmpSharpNet..::.SnmpPacket
    SnmpSharpNet..::.SnmpV3Packet