SNMPTCPMgr Class
Properties Methods Events Configuration Settings Errors
The SNMPTCPMgr class is used to implement TCP-based SNMP Management Applications.
Syntax
ipworkssnmp.snmptcpmgr()
Remarks
The SNMPTCPMgr class implements a TCP-based standard SNMP Manager as specified in the SNMP RFCs. The class supports SNMP v1, v2c, and v3.
The class provides both encoding/decoding and transport capabilities, making the task of developing a custom SNMP manager as simple as setting a few key properties and handling a few events. SNMP data, such as for instance SNMP object id-s (OID-s) are exchanged as text strings, thus further simplifying the task of handling them.
The class is activated/deactivated by setting the Active property. This property enables or disables sending and receiving.
Messages are received through events such as Response, Trap, or InformRequest. SNMP Traps are received through the Trap event.
Messages are sent to other agents or managers by using class's methods such as SendGetRequest, SendGetNextRequest, SendGetBulkRequest, SendSetRequest, and SendInformRequest.
SNMP OIDs, types, and values are provided in the Objects collection of SNMP objects for both sent and received packets.
SNMPv3 USM security is enabled by setting properties such as User, AuthenticationPassword, and EncryptionPassword and calling the Discover method to bind to a particular agent (RemoteEngineId). Upon successful discovery, received packets are checked for integrity (authentication) and timeliness. Note that the discovery step is optional, and may be avoided if the values for RemoteEngineId, RemoteEngineBoots, and RemoteEngineTime are known in advance and provided to the class through the respective properties.
By default, the class operates synchronously (except for the Discover method), sending a request and waiting until the corresponding response has been received. This behavior may be overridden by setting Timeout to 0, in which case the class returns control immediately after a send, and responses are received exclusively through the Response event.
Property List
The following is the full list of the properties of the class with short descriptions. Click on the links for further details.
AcceptData | Enables or disables data reception. |
Active | Enables or disables sending and receiving of SNMP packets. |
AuthenticationPassword | The password used for SNMPv3 authentication. |
AuthenticationProtocol | The authentication protocol used for SNMPv3 packets. |
Community | The community string used to authenticate SNMP packets. |
EncryptionAlgorithm | The encryption algorithm used for SNMPv3 packets. |
EncryptionPassword | The password used for SNMPv3 privacy. |
ErrorDescription | Description of the status code for the last SNMP packet received by the class. |
ErrorIndex | Index of the first variable (object) that caused an error from the last SNMP response. |
ErrorStatus | Status code for the last SNMP packet received by the class. |
LocalEngineId | The Engine Id of the SNMP Manager. |
LocalHost | The name of the local host or user-assigned IP interface through which connections are initiated or accepted. |
LocalPort | The port in the local host where the SNMP Manager is bound to. |
Objects | The objects in the current request. |
RemoteEngineBoots | The remote engine boots (SNMPv3). |
RemoteEngineId | The Engine Id of the remote agent. |
RemoteEngineTime | The remote engine time (SNMPv3). |
RemoteHost | The address of the remote host. Domain names are resolved to IP addresses. |
RemotePort | The port where the remote SNMP agent is listening. |
RequestId | The request-id to mark outgoing packets with. |
SNMPVersion | Version of SNMP used for outgoing requests. |
SSLAcceptServerCert | Instructs the class to unconditionally accept the server certificate that matches the supplied certificate. |
SSLAuthenticateClients | If true, the server asks the client(s) for a certificate. |
SSLCert | The certificate to be used during SSL negotiation. |
SSLEnabled | Whether TLS/SSL is enabled. |
SSLServerCert | The server certificate for the last established connection. |
StoreWalkObjects | Tells the class whether or not to store returned objects. |
Timeout | A timeout for the class. |
User | The user name used for SNMPv3 authentication. |
WalkLimit | The limit of oid's returned in a walk. |
Method List
The following is the full list of the methods of the class with short descriptions. Click on the links for further details.
Config | Sets or retrieves a configuration setting. |
Discover | Performs SNMPv3 discovery. |
DoEvents | Processes events from the internal message queue. |
HashPasswords | Hashes all passwords in the cache. |
Interrupt | Interrupt the current method. |
Reset | Clears the object arrays. |
SendGetBulkRequest | Send a GetBulkRequest packet. |
SendGetNextRequest | Send GetNextRequest packet. |
SendGetRequest | Send GetRequest packet. |
SendInformRequest | Send an InformRequest packet. |
SendSetRequest | Send Set Request packet. |
Value | Returns the value corresponding to an OID. |
Walk | Does an SNMP walk starting with the specified oid. |
Event List
The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.
BadPacket | Fired for erroneous and/or malformed messages. |
Connected | Fired immediately after a connection completes (or fails). |
ConnectionStatus | TBD. |
Disconnected | TBD. |
DiscoveryRequest | Fired when an SNMPv3 discovery packet is received. |
DiscoveryResponse | Fired when an SNMPv3 discovery response is received. |
Error | Information about errors during data delivery. |
HashPassword | Fired before and after a password is hashed. |
InformRequest | Fired when an InformRequest packet is received. |
PacketTrace | Fired for every packet sent or received. |
ReadyToSend | Fired when the class is ready to send data. |
Report | Fired when a Report packet is received. |
Response | Fired when a GetResponse packet is received. |
SSLClientAuthentication | Fired when the client presents its credentials to the server. |
SSLServerAuthentication | Fires when connecting to the server. |
SSLStatus | Shows the progress of the secure connection. |
Trap | Fired when a SNMP trap packet is received. |
Configuration Settings
The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.
CheckMessageOrigin | Whether to match the origin IP address when receiving responses. |
CompatibilityMode | Whether to operate the class in a specific compatibility mode. |
ContextEngineId | Sets the context engine id of the SNMP entity. |
ContextName | Sets the context name of the SNMP entity. |
DecryptLogPackets | Whether to decrypt logged packets. |
ForceLocalPort | Forces the class to bind to a specific port. |
MsgMaxSize | The maximum supported message size. |
SourceAddress | The source address of the received packet. |
SourcePort | The source port of the received packet. |
TimeoutInMilliseconds | The timeout is treated as milliseconds. |
WalkInsideRange | Stops the SNMP walk if the OID value returned from an agent is outside the table. |
WalkStartOID | Specifies the OID to be used when a Walk is performed. |
ConnectionTimeout | Sets a separate timeout value for establishing a connection. |
FirewallAutoDetect | Tells the class whether or not to automatically detect and use firewall system settings, if available. |
FirewallHost | Name or IP address of firewall (optional). |
FirewallPassword | Password to be used if authentication is to be used when connecting through the firewall. |
FirewallPort | The TCP port for the FirewallHost;. |
FirewallType | Determines the type of firewall to connect through. |
FirewallUser | A user name if authentication is to be used connecting through a firewall. |
KeepAliveInterval | The retry interval, in milliseconds, to be used when a TCP keep-alive packet is sent and no response is received. |
KeepAliveTime | The inactivity time in milliseconds before a TCP keep-alive packet is sent. |
Linger | When set to True, connections are terminated gracefully. |
LingerTime | Time in seconds to have the connection linger. |
LocalHost | The name of the local host through which connections are initiated or accepted. |
LocalPort | The port in the local host where the class binds. |
MaxLineLength | The maximum amount of data to accumulate when no EOL is found. |
MaxTransferRate | The transfer rate limit in bytes per second. |
ProxyExceptionsList | A semicolon separated list of hosts and IPs to bypass when using a proxy. |
TCPKeepAlive | Determines whether or not the keep alive socket option is enabled. |
TcpNoDelay | Whether or not to delay when sending packets. |
UseIPv6 | Whether to use IPv6. |
LogSSLPackets | Controls whether SSL packets are logged when using the internal security API. |
OpenSSLCADir | The path to a directory containing CA certificates. |
OpenSSLCAFile | Name of the file containing the list of CA's trusted by your application. |
OpenSSLCipherList | A string that controls the ciphers to be used by SSL. |
OpenSSLPrngSeedData | The data to seed the pseudo random number generator (PRNG). |
ReuseSSLSession | Determines if the SSL session is reused. |
SSLAcceptAnyServerCert | Whether to trust any certificate presented by the server. |
SSLCACerts | A newline separated list of CA certificate to use during SSL client authentication. |
SSLCipherStrength | The minimum cipher strength used for bulk encryption. |
SSLEnabledCipherSuites | The cipher suite to be used in an SSL negotiation. |
SSLEnabledProtocols | Used to enable/disable the supported security protocols. |
SSLEnableRenegotiation | Whether the renegotiation_info SSL extension is supported. |
SSLIncludeCertChain | Whether the entire certificate chain is included in the SSLServerAuthentication event. |
SSLNegotiatedCipher | Returns the negotiated ciphersuite. |
SSLNegotiatedCipherStrength | Returns the negotiated ciphersuite strength. |
SSLNegotiatedCipherSuite | Returns the negotiated ciphersuite. |
SSLNegotiatedKeyExchange | Returns the negotiated key exchange algorithm. |
SSLNegotiatedKeyExchangeStrength | Returns the negotiated key exchange algorithm strength. |
SSLNegotiatedVersion | Returns the negotiated protocol version. |
SSLProvider | The name of the security provider to use. |
SSLSecurityFlags | Flags that control certificate verification. |
SSLServerCACerts | A newline separated list of CA certificate to use during SSL server certificate validation. |
TLS12SignatureAlgorithms | Defines the allowed TLS 1.2 signature algorithms when UseInternalSecurityAPI is True. |
TLS12SupportedGroups | The supported groups for ECC. |
TLS13KeyShareGroups | The groups for which to pregenerate key shares. |
TLS13SignatureAlgorithms | The allowed certificate signature algorithms. |
TLS13SupportedGroups | The supported groups for (EC)DHE key exchange. |
AbsoluteTimeout | Determines whether timeouts are inactivity timeouts or absolute timeouts. |
FirewallData | Used to send extra data to the firewall. |
InBufferSize | The size in bytes of the incoming queue of the socket. |
OutBufferSize | The size in bytes of the outgoing queue of the socket. |
BuildInfo | Information about the product's build. |
CodePage | The system code page used for Unicode to Multibyte translations. |
LicenseInfo | Information about the current license. |
UseInternalSecurityAPI | Tells the class whether or not to use the system security libraries or an internal implementation. |