Table of Contents
Advertisement
Recover Key By Serial Number Interface
The recovery operation can be completed by one call to the Recover Key By Serial
Number Interface if the proper number of recovery agent user IDs and passwords
are provided. In this case, a PKCS #12 blob is returned with the recovered key and
an associated public key certificate.
The recovery operation can also be deferred if the agent passwords cannot be
immediately provided. In this case, the response from the interface is a new form
that polls the Get Approval Status Interface until the passwords are entered by
agents (from other locations) and the PKCS #12 blob can be delivered.
Default Forms
The Recover Key By Serial Number Interface typically follows a request to the
Display Key For Recovery Interface. The result of the Display Key For Recovery
Interface request is to display a key from the archive using the
displayBySerialForRecovery.template
making a request to the Recover Key By Serial Number Interface to initiate the
recovery operation for the selected key.
Request Parameters
The following table lists the parameters accepted by the Recover Key By Serial
Number interface.
Table 6-34 Parameters Accepted by the Recover Key By Serial Number Interface
Parameter
cert
localAgents
nickname
170
Netscape Certificate Management System Customization Guide • May 2002
Format and Description
base-64 encoded PKCS #7 certificate
You must supply the certificate containing the public key corresponding to the
key in the archive. Be sure to include the "-----BEGIN CERTIFICATE-----"
header and "-----END CERTIFICATE-----" footer.
yes | no
Specifies whether agent user IDs and passwords have been entered locally (that
is, submitted with this request), or will be entered remotely. If localAgents =
no, agents will have to access the Examine Recovery interface with the request
id and enter their passwords.
string
Specifies an optional nickname for the certificate that will be returned in the
PKCS #12 blob when the key is recovered.
file. This template provides a form for
Advertisement
Table of Contents
