Table of Contents

# $EPIC: on_ssl_server_cert.txt,v 1.3 2006/08/19 02:42:38 sthalik Exp $

Synopsis:

on [<modes>]ssl_server_cert [<serial#>] [-|^]<match> { <action> }

Description:

This hook is triggered after SSL negotation with an irc server has successfully completed.

Parameters:

$0 The file descriptor for the server [NOT THE SERVER REFNUM]
$1 The certificate subject, passed through $urlencode(). Use $urldecode($1) to recover the cert subject.
$2 The certificate issuer, passed through $urlencode() Use $urldecode($2) to recover the cert issuer.
$3 The length of the public key, in bits.
$4 OpenSSL error code of the “most serious error” (18 = self-signed-cert, 62 = hostname mismatch, everything else is bad)
$5 The SSL regime being used, ie “TLSv1.2”
$6 The certificate's hash
$7 Was there a hostname mismatch? 0 → no error, 1 → error
$8 Was there a self-signed cert error? 0 → no error, 1 → error
$9 Was there another (serious) error? 0 → no error, 1 → error
$10Was there any error of any kind? 0 → no error of any kind, 1 → some kind of error

See also:

about ssl_connections

History:

ON SSL_SERVER_CERT originated with the EPIC4-SSL project. ON SSL_SERVER_CERT first appeared in EPIC4-1.1.3. The values passed in $4 through $10 first appeared in EPIC5-2.1.6