# $dcc.getSSLCertInfo

Returns the requested information about certificates used in an ssl-enabled dcc session

Usage

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

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 sting.
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"

Syntax Specification

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

Examples

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

See also
$certificate $str.evpsign $str.evpverify dcc module

Index, Functions

KVIrc 4.2.0.6190 Documentation
Generated by root at Mon Sep 23 13:56:02 2013