SelectCertificate Event 848

Applies To: HTMLRenderer

Description

This event is triggered when HTMLRenderer requests a resource from a server that requires a certificate.

The event message reported as the result of ⎕DQ, or supplied as the right argument to your callback function, is a 7-element vector as follows:

[1]	Object	ref or character vector
[2]	Event	'SelectCertificate' or 848
[3]	Index	Integer (see below)
[4]	Addr	Host address
[5]	Port	Host port
[6]		'is proxy'
[7]	Certificates	See below

Certificates is a vector of namespaces, each of which represents an available certificate and contains the following variables:

Name	Description
DER	Distinguished Encoding Rules. Character Vector.
Subject	Namespace (see below)
Issuer	Namespace (see below)
SerialNumber	Integer

The Subject and Issuer namespaces contain the following variables:

Name	Description
CommonName	Character vector
CountryName	Character vector
DisplayName	Character vector

The application should respond to this event by selecting a certficate from the list of available certificates reported by the 7th element of the event message. This is done by having a callback function that sets the 3rd element of the event message (Index) to the 0-origin index in Certificates and returns the event message as its result.

Example

     ∇ arg←cb arg
[1]   ⍝ SelectCertificate callback function
[2]    arg[3]←0 ⍝ Select the first certificate
     ∇