$context.getSSLCertInfo

Returns the requested information about certificates used in an SSL enabled IRC session

Usage

$context.getSSLCertInfo(<query:string>[,<type:string='remote'>[,<context_id:integer>[,<param1:string>]]])

Description

Returns the requested information about certificates used in an SSL enabled IRC session.
The second <type> parameter can be "local" or "remote", and refers to the certificate you want to query the information from; if omitted, it defaults to "remote".
If <context_id> is omitted then the IRC context associated with the current window is assumed.
If <context_id> is not a valid IRC context identifier (or it is omitted and the current window has no associated IRC context) then this function prints a warning and returns an empty string.
If the IRC context is not using SSL then this function returns an empty string.
Some queries can accept an optional parameter <param1>.
Available query strings are:

signatureType
signatureContents
subjectCountry
subjectStateOrProvince
subjectLocality
subjectOrganization
subjectOrganizationalUnit
subjectCommonName
issuerCountry
issuerStateOrProvince
issuerLocality
issuerOrganization
issuerOrganizationalUnit
issuerCommonName
publicKeyBits
publicKeyType
serialNumber
pemBase64
version
fingerprintIsValid
fingerprintDigestId
fingerprintDigestStr
fingerprintContents * accepts parameter interpreted as "digest name"

Examples

# get a sha256 fingerprint of remote peer's certificate
$context.getSSLCertInfo(fingerprintContents,remote,$context,sha256)