/*
 * The contents of this file are subject to the Mozilla Public
 * License Version 1.1 (the "License"); you may not use this file
 * except in compliance with the License. You may obtain a copy of
 * the License at http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS
 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * rights and limitations under the License.
 *
 * The Original Code is mozilla.org code.
 *
 * The Initial Developer of the Original Code is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 2001 Netscape Communications Corporation. All
 * Rights Reserved.
 *
 * Contributor(s):
 *   Terry Hayes <thayes@netscape.com>
 */

#include "nsISupports.idl"
#include "nsIX509Cert.idl"

interface nsIInterfaceRequestor;

/**
 * nsITokenPasswordDialogs
 *  This is the interface for setting and changing password
 *  on a PKCS11 token.
 */
[scriptable, uuid(be26b580-1dd1-11b2-9946-c598d0d07727)]
interface nsITokenPasswordDialogs : nsISupports
{
  /**
   * setPassword - sets the password/PIN on the named token.
   *   The canceled output value should be set to TRUE when
   *   the user (or implementation) cancels the operation.
   */
  void setPassword(in nsIInterfaceRequestor ctx, in wstring tokenName,
                   out boolean canceled);

  void getPassword(in nsIInterfaceRequestor ctx, 
                   in wstring tokenName,
                   out wstring password,
                   out boolean canceled);
};


/**
 * nsINSSDialogs - a collection of functions that
 *   implement activities that may require interaction
 *   with the user.
 */
[scriptable, uuid(4a8c5584-1dd2-11b2-bfff-f232dbfab27e)]
interface nsINSSDialogs : nsISupports
{
  /**
   * This is the base class for NSSDialogs.  It must support all
   * the interfaces for dialogs that it wants to support.
   * 
   * nsITokenPasswordDialogs is one such implementation.
   */
};


/**
 * nsISecurityWarningDialogs - functions that
 *   display warnings for transitions between secure
 *   and insecure pages, posts to insecure servers etc.
 */
[scriptable, uuid(1c399d06-1dd2-11b2-bc58-c87cbcacdb78)]
interface nsISecurityWarningDialogs : nsISupports
{
  /**
   * alertEnteringSecure
   */
  void alertEnteringSecure(in nsIInterfaceRequestor ctx);

  /**
   * alertEnteringWeak
   */
  void alertEnteringWeak(in nsIInterfaceRequestor ctx);

  /**
   * alertLeavingSecure
   */
  void alertLeavingSecure(in nsIInterfaceRequestor ctx);

  /**
   * alertMixedMode
   */
  void alertMixedMode(in nsIInterfaceRequestor ctx);

  /**
   * confirmPostToInsecure
   */
  boolean confirmPostToInsecure(in nsIInterfaceRequestor ctx);

  /**
   * confirmPostToInsecureFromSecure
   */
  boolean confirmPostToInsecureFromSecure(in nsIInterfaceRequestor ctx);
};

/**
 * nsICertificateDialogs
 * Provides UI for certificate-related dialogs.
 */
[scriptable, uuid(a03ca940-09be-11d5-ac5d-000064657374)]
interface nsICertificateDialogs : nsISupports
{
  /**
   * downloadCACert
   *   UI shown when a user is asked to download a new CA cert.  Provides
   *   user with ability to choose trust settings for the cert.
   */
  void downloadCACert(in nsIInterfaceRequestor ctx, 
                      in nsIX509Cert cert,
                      out unsigned long trust,
                      out boolean canceled);

  void setPKCS12FilePassword(in nsIInterfaceRequestor ctx, 
                             out wstring password,
                             out boolean canceled);

  void getPKCS12FilePassword(in nsIInterfaceRequestor ctx, 
                             out wstring password,
                             out boolean canceled);

  void viewCert(in nsIX509Cert cert);
};

/**
 * nsIClientAuthDialog
 * Provides UI for SSL client-auth dialogs.
 */
[scriptable, uuid(fa4c7520-1433-11d5-ba24-00108303b117)]
interface nsIClientAuthDialogs : nsISupports
{
  /**
   * display
   *   UI shown when a user is asked to do SSL client auth.
   */
  void ChooseCertificate(in nsIInterfaceRequestor ctx, 
                      in wstring cn,
					  in wstring organization,
					  in wstring issuer,
					  [array, size_is(count)] in wstring certNickList,
					  in PRUint32 count,
                      out wstring certNick,
                      out boolean canceled);
};

/**
 * NS_NSSDIALOGS_CONTRACTID - contract id of a service that
 *   implements nsINSSDialogs (and possibly other interfaces)
 *   that provide interaction with the user.
 */
%{C++
#define NS_NSSDIALOGS_CONTRACTID "@mozilla.org/nsNSSDialogs;1"
%}
