/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * 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) 1998 Netscape Communications Corporation. All
 * Rights Reserved.
 *
 * Contributor(s):
 *   Hubbie Shaw
 *   Doug Turner <dougt@netscape.com>
 *   Mitch Stoltz <mstoltz@netscape.com>
*/

#include "nsISupports.idl"
interface nsIPrincipal;

%{C++
#include "cmtcmn.h"
%}

[ptr] native nsCMTControlStar(CMT_CONTROL);

[scriptable, uuid(9e482670-5412-11d3-bbc8-0000861d1237)]
interface nsIPSMComponent : nsISupports 
{

  [noscript] nsCMTControlStar getControlConnection( );

  /**
   *  Display the Security Advisor.  PickledStatus and hostName can be null. 
   *  If they are, the "Selected Info" dialog will be empty.
   */

  void displaySecurityAdvisor(in string pickledStatus, in string hostName);

  /**
   *  This will send PSM all preferences that we know about.
   */
  void passPrefs();

 /* Sig Verification Error Codes */
  const long VERIFY_OK = 0;
  const long VERIFY_NOSIG = -2;
  const long VERIFY_ERROR_UNKNOWN_CA  = -8172;
  
  /* Hash Algorithms (based on cmtcmn.h) */ 
  const short MD2  = 1;
  const short MD5  = 2;
  const short SHA1 = 3;
  const unsigned long MD2_LENGTH  = 16;
  const unsigned long MD5_LENGTH  = 16;
  const unsigned long SHA1_LENGTH = 20;
  const unsigned long MAX_HASH_LENGTH = SHA1_LENGTH;

  /* Secure Hashing functions */
  void hashBegin(in unsigned long alg, out unsigned long id);
  void hashUpdate(in unsigned long id, in string buf, in unsigned long buflen);
  void hashEnd(in unsigned long id, out string hash, out unsigned long hashlen,
               in unsigned long maxLen);
  
  /* Signature Verification functions */
  void verifyRSABegin(out unsigned long id);
  void verifyRSAUpdate(in unsigned long id, in string buf, 
                       in unsigned long buflen);
  void verifyRSAEnd(in unsigned long id, in string plaintext,
                    in unsigned long plaintextLen,
                    in boolean keepCert, out nsIPrincipal principal, out long result);
  nsIPrincipal CreatePrincipalFromCert(in unsigned long certID);
};

%{C++
#define PSM_COMPONENT_PROGID "component://netscape/psm"
#define PSM_COMPONENT_CLASSNAME "Mozilla PSM Component"
%}

