nsICertificateDialogs

IID:a03ca940-09be-11d5-ac5d-000064657374
Inherits From:nsISupports
Status:FROZEN

Functions that implement user interface dialogs to manage certificates.

This interface is implemented by the following components:


Methods

PRBool confirmDownloadCACert ( nsIInterfaceRequestor ctx , nsIX509Cert cert , out PRUint32 trust ) void crlImportStatusDialog ( nsIInterfaceRequestor ctx , nsICRLInfo crl ) PRBool getPKCS12FilePassword ( nsIInterfaceRequestor ctx , out AString password ) void notifyCACertExists ( nsIInterfaceRequestor ctx ) PRBool setPKCS12FilePassword ( nsIInterfaceRequestor ctx , out AString password ) void viewCert ( nsIInterfaceRequestor ctx , nsIX509Cert cert )

PRBool confirmDownloadCACert ( nsIInterfaceRequestor ctx , nsIX509Cert cert , out PRUint32 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.

Arguments:
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 crlImportStatusDialog ( nsIInterfaceRequestor ctx , nsICRLInfo crl )

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

Arguments:
ctx: A user interface context.
crl: Information describing the CRL that was imported.

PRBool getPKCS12FilePassword ( 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.

Arguments:
ctx: A user interface context.
password: The password provided by the user.
Returns:
false if the user requests to cancel.

void notifyCACertExists ( 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.

Arguments:
ctx: A user interface context.

PRBool setPKCS12FilePassword ( 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.

Arguments:
ctx: A user interface context.
password: The password provided by the user.
Returns:
false if the user requests to cancel.

void viewCert ( nsIInterfaceRequestor ctx , 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.

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

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com