GetUserPassword Event
Retrieves a password associated with a user.
Syntax
class SNMPTCPAgentGetUserPasswordEventParams { public: int PasswordType(); const QString &User(); const QString &Password(); void SetPassword(const QString &qsPassword); int Algorithm(); void SetAlgorithm(int iAlgorithm); int EventRetVal(); void SetEventRetVal(int iRetVal); };
// To handle, connect one or more slots to this signal. void GetUserPassword(SNMPTCPAgentGetUserPasswordEventParams *e);
// Or, subclass SNMPTCPAgent and override this emitter function. virtual int FireGetUserPassword(SNMPTCPAgentGetUserPasswordEventParams *e) {...}
Remarks
The GetUserPassword event is fired after initial inspection of SNMPv3 requests.
The type of password required is provided in the PasswordType parameter: 1 for authentication, and 2 for encryption (privacy).
The password corresponding to User (if any) must be provided in the Password parameter. If the password is valid, processing will continue to other events such as GetRequest, SetRequest, etc.
If the PasswordType parameter is 1 (authentication is used), the Algorithm parameter can be set. Possible values are:
Value | Authentication Algorithm |
0 (default) | Any |
1 | MD5 |
2 | SHA1 |
3 | SHA256 |
4 | SHA512 |
Value | Encryption Algorithm |
1 (default) | DES |
2 | AES |
3 | 3DES |
4 | AES192 |
5 | AES256 |
If the password does not match the signature in the request, a BadPacket event will be fired, at which point you can decide whether to report the error to the client (see the description of the BadPacket event for more information).
If the User is invalid or unknown, set the password to empty string (default) to ignore the request. This will result in a BadPacket event being fired, at which point you can decide whether to report the error to the client or not.