Public Member Functions

nsICertificateDialogs Interface Reference

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

import "nsICertificateDialogs.idl";

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.

Status:
FROZEN

Member Function Documentation

boolean nsICertificateDialogs::confirmDownloadCACert ( in nsIInterfaceRequestor  ctx,
in nsIX509Cert  cert,
out unsigned long  trust 
)

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:
ctx A user interface context.
cert The certificate that is about to get installed.
trust a bit mask of trust flags, see nsIX509CertDB for possible values.
Returns:
true if the user allows to import the certificate.
void nsICertificateDialogs::crlImportStatusDialog ( in nsIInterfaceRequestor  ctx,
in nsICRLInfo  crl 
)

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

Parameters:
ctx A user interface context.
crl Information describing the CRL that was imported.
boolean nsICertificateDialogs::getPKCS12FilePassword ( in nsIInterfaceRequestor  ctx,
out AString  password 
)

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:
ctx A user interface context.
password The password provided by the user.
Returns:
false if the user requests to cancel.
void nsICertificateDialogs::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.

Parameters:
ctx A user interface context.
boolean nsICertificateDialogs::setPKCS12FilePassword ( in nsIInterfaceRequestor  ctx,
out AString  password 
)

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:
ctx A user interface context.
password The password provided by the user.
Returns:
false if the user requests to cancel.
void nsICertificateDialogs::viewCert ( in nsIInterfaceRequestor  ctx,
in nsIX509Cert  cert 
)

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

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

Parameters:
ctx A user interface context.
cert The certificate to be shown to the user.

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