$dcc.getSSLCertInfo

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

Usage

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

Description

Returns the requested information about certificates used in an SSL enabled DCC 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 <dcc_id> is omitted then the DCC Session associated with the current window is assumed.
If <dcc_id> is not a valid DCC session identifier (or it is omitted and the current window has no associated DCC session) then this function prints a warning and returns an empty string.
If the DCC session 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
$dcc.getSSLCertInfo(fingerprintContents,remote,$dcc.session,sha256)