Description
-
Fires when remote server provides its certificate.
Syntax
-
Private Sub
object_HostCertificate(Cert,
ErrorCode, ErrorText,
Action)
The HostCertificate Event syntax has these parts:
| object |
A wodXMPP object. |
| Cert |
An ICertificate object.
Reference to Certificate object that holds information
about server's
certificate. |
| ErrorCode |
A Long value. Code
of the error, if any. |
| ErrorText |
A String value. Text
description of the error, if any. |
| Action |
A XMPPActionsEnum
enumeration, as described in settings. |
Settings
-
The settings for Action are:
 |
Deny |
0 |
Deny execution of the
action. |
|
Allow |
1 |
Allow to execute
action. |
|
SilentDeny |
2 |
Silently deny execution of
the action. |
|
SilentAllow |
3 |
Silently allow to execute
action. |
Remarks
-
Once wodXMPP connects to SSL/TLS server, it will receive
server's certificate that holds information about
server's validity. It will contain information such as
server's name, organization, valid dates etc..
Certificates are usually signed by some known CA
(Certificate Authority) whose responsibility is to prove
that server is really the one he's representing to
be.
wodXMPP will try to detect if remote certificate should be
trusted or not. If any errors are found, ErrorText
will contain line-by-line descriptions for all errors
found, and ErrorCode will contain first error that
was found. If ErrorText is empty (and
ErrorCode is 0), certificate should be trusted.
wodXMPP will load all certificates in your Windows
Certificate store (ROOT and MY stores) and remote
certificate will be tested against all certificates in
those stores.
Even if no error is found - make sure certificate's
CommonName property point to the Hostname
you're connecting to! This test should be done by your
application.
If you think remote server's certificate is invalid,
you should set Accept parameter to Deny and wodXMPP
will immediately close the connection.
|
HostCertificate
Event
