Back to index

lightning-sunbird  0.9+nobinonly
Public Member Functions
nsICertificateDialogs Interface Reference

Functions that implement user interface dialogs to manage certificates. More...

import "nsICertificateDialogs.idl";

Inheritance diagram for nsICertificateDialogs:
Inheritance graph
[legend]
Collaboration diagram for nsICertificateDialogs:
Collaboration graph
[legend]

List of all members.

Public Member Functions

boolean confirmDownloadCACert (in nsIInterfaceRequestor ctx, in nsIX509Cert cert, out unsigned long trust)
 UI shown when a user is asked to download a new CA cert.
void notifyCACertExists (in nsIInterfaceRequestor ctx)
 UI shown when a web site has delivered a CA certificate to be imported, but the certificate is already contained in the user's storage.
boolean setPKCS12FilePassword (in nsIInterfaceRequestor ctx, out AString password)
 UI shown when a user's personal certificate is going to be exported to a backup file.
boolean getPKCS12FilePassword (in nsIInterfaceRequestor ctx, out AString password)
 UI shown when a user is about to restore a personal certificate from a backup file.
void viewCert (in nsIInterfaceRequestor ctx, in nsIX509Cert cert)
 UI shown when a certificate needs to be shown to the user.
void crlImportStatusDialog (in nsIInterfaceRequestor ctx, in nsICRLInfo crl)
 UI shown after a Certificate Revocation List (CRL) has been successfully imported.

Detailed Description

Functions that implement user interface dialogs to manage certificates.

FROZEN

Definition at line 50 of file nsICertificateDialogs.idl.


Member Function Documentation

UI shown when a user is asked to download a new CA cert.

Provides user with ability to choose trust settings for the cert. Asks the user to grant permission to import the certificate.

Parameters:
ctxA user interface context.
certThe certificate that is about to get installed.
trusta bit mask of trust flags, see nsIX509CertDB for possible values.
Returns:
true if the user allows to import the certificate.

UI shown after a Certificate Revocation List (CRL) has been successfully imported.

Parameters:
ctxA user interface context.
crlInformation describing the CRL that was imported.

UI shown when a user is about to restore a personal certificate from a backup file.

The user is requested to enter the password that was used in the past to protect that backup file.

Parameters:
ctxA user interface context.
passwordThe password provided by the user.
Returns:
false if the user requests to cancel.

UI shown when a web site has delivered a CA certificate to be imported, but the certificate is already contained in the user's storage.

Parameters:
ctxA user interface context.

UI shown when a user's personal certificate is going to be exported to a backup file.

The implementation of this dialog should make sure to prompt the user to type the password twice in order to confirm correct input. The wording in the dialog should also motivate the user to enter a strong password.

Parameters:
ctxA user interface context.
passwordThe password provided by the user.
Returns:
false if the user requests to cancel.

UI shown when a certificate needs to be shown to the user.

The implementation should try to display as many attributes as possible.

Parameters:
ctxA user interface context.
certThe certificate to be shown to the user.

The documentation for this interface was generated from the following file: