| Index: net/cert/nss_cert_database.h
|
| diff --git a/net/cert/nss_cert_database.h b/net/cert/nss_cert_database.h
|
| deleted file mode 100644
|
| index 50eb037a2068aa7e1f33d3302d2bca2e56e5456f..0000000000000000000000000000000000000000
|
| --- a/net/cert/nss_cert_database.h
|
| +++ /dev/null
|
| @@ -1,313 +0,0 @@
|
| -// Copyright (c) 2012 The Chromium Authors. All rights reserved.
|
| -// Use of this source code is governed by a BSD-style license that can be
|
| -// found in the LICENSE file.
|
| -
|
| -#ifndef NET_CERT_NSS_CERT_DATABASE_H_
|
| -#define NET_CERT_NSS_CERT_DATABASE_H_
|
| -
|
| -#include <string>
|
| -#include <vector>
|
| -
|
| -#include "base/basictypes.h"
|
| -#include "base/callback_forward.h"
|
| -#include "base/memory/ref_counted.h"
|
| -#include "base/memory/weak_ptr.h"
|
| -#include "base/strings/string16.h"
|
| -#include "crypto/scoped_nss_types.h"
|
| -#include "net/base/net_errors.h"
|
| -#include "net/base/net_export.h"
|
| -#include "net/cert/cert_type.h"
|
| -#include "net/cert/x509_certificate.h"
|
| -
|
| -namespace base {
|
| -class TaskRunner;
|
| -}
|
| -template <class ObserverType> class ObserverListThreadSafe;
|
| -
|
| -namespace net {
|
| -
|
| -class CryptoModule;
|
| -typedef std::vector<scoped_refptr<CryptoModule> > CryptoModuleList;
|
| -
|
| -// Provides functions to manipulate the NSS certificate stores.
|
| -// Forwards notifications about certificate changes to the global CertDatabase
|
| -// singleton.
|
| -class NET_EXPORT NSSCertDatabase {
|
| - public:
|
| - class NET_EXPORT Observer {
|
| - public:
|
| - virtual ~Observer() {}
|
| -
|
| - // Will be called when a new certificate is added.
|
| - // Called with |cert| == NULL after importing a list of certificates
|
| - // in ImportFromPKCS12().
|
| - virtual void OnCertAdded(const X509Certificate* cert) {}
|
| -
|
| - // Will be called when a certificate is removed.
|
| - virtual void OnCertRemoved(const X509Certificate* cert) {}
|
| -
|
| - // Will be called when a CA certificate is changed.
|
| - // Called with |cert| == NULL after importing a list of certificates
|
| - // in ImportCACerts().
|
| - virtual void OnCACertChanged(const X509Certificate* cert) {}
|
| -
|
| - protected:
|
| - Observer() {}
|
| -
|
| - private:
|
| - DISALLOW_COPY_AND_ASSIGN(Observer);
|
| - };
|
| -
|
| - // Stores per-certificate error codes for import failures.
|
| - struct NET_EXPORT ImportCertFailure {
|
| - public:
|
| - ImportCertFailure(const scoped_refptr<X509Certificate>& cert, int err);
|
| - ~ImportCertFailure();
|
| -
|
| - scoped_refptr<X509Certificate> certificate;
|
| - int net_error;
|
| - };
|
| - typedef std::vector<ImportCertFailure> ImportCertFailureList;
|
| -
|
| - // Constants that define which usages a certificate is trusted for.
|
| - // They are used in combination with CertType to specify trust for each type
|
| - // of certificate.
|
| - // For a CA_CERT, they specify that the CA is trusted for issuing server and
|
| - // client certs of each type.
|
| - // For SERVER_CERT, only TRUSTED_SSL makes sense, and specifies the cert is
|
| - // trusted as a server.
|
| - // For EMAIL_CERT, only TRUSTED_EMAIL makes sense, and specifies the cert is
|
| - // trusted for email.
|
| - // DISTRUSTED_* specifies that the cert should not be trusted for the given
|
| - // usage, regardless of whether it would otherwise inherit trust from the
|
| - // issuer chain.
|
| - // Use TRUST_DEFAULT to inherit trust as normal.
|
| - // NOTE: The actual constants are defined using an enum instead of static
|
| - // consts due to compilation/linkage constraints with template functions.
|
| - typedef uint32 TrustBits;
|
| - enum {
|
| - TRUST_DEFAULT = 0,
|
| - TRUSTED_SSL = 1 << 0,
|
| - TRUSTED_EMAIL = 1 << 1,
|
| - TRUSTED_OBJ_SIGN = 1 << 2,
|
| - DISTRUSTED_SSL = 1 << 3,
|
| - DISTRUSTED_EMAIL = 1 << 4,
|
| - DISTRUSTED_OBJ_SIGN = 1 << 5,
|
| - };
|
| -
|
| - typedef base::Callback<void(scoped_ptr<CertificateList> certs)>
|
| - ListCertsCallback;
|
| -
|
| - typedef base::Callback<void(bool)> DeleteCertCallback;
|
| -
|
| - // Creates a NSSCertDatabase that will store public information (such as
|
| - // certificates and trust records) in |public_slot|, and private information
|
| - // (such as keys) in |private_slot|.
|
| - // In general, code should avoid creating an NSSCertDatabase directly,
|
| - // as doing so requires making opinionated decisions about where to store
|
| - // data, and instead prefer to be passed an existing NSSCertDatabase
|
| - // instance.
|
| - // |public_slot| must not be NULL, |private_slot| can be NULL. Both slots can
|
| - // be identical.
|
| - NSSCertDatabase(crypto::ScopedPK11Slot public_slot,
|
| - crypto::ScopedPK11Slot private_slot);
|
| - virtual ~NSSCertDatabase();
|
| -
|
| - // Get a list of unique certificates in the certificate database (one
|
| - // instance of all certificates).
|
| - // DEPRECATED by |ListCerts|. See http://crbug.com/340460.
|
| - virtual void ListCertsSync(CertificateList* certs);
|
| -
|
| - // Asynchronously get a list of unique certificates in the certificate
|
| - // database (one instance of all certificates). Note that the callback may be
|
| - // run even after the database is deleted.
|
| - virtual void ListCerts(const ListCertsCallback& callback);
|
| -
|
| - // Get a list of certificates in the certificate database of the given slot.
|
| - // Note that the callback may be run even after the database is deleted.
|
| - // Must be called on the IO thread and it calls |callback| on the IO thread.
|
| - // This does not block by retrieving the certs asynchronously on a worker
|
| - // thread. Never calls |callback| synchronously.
|
| - virtual void ListCertsInSlot(const ListCertsCallback& callback,
|
| - PK11SlotInfo* slot);
|
| -
|
| -#if defined(OS_CHROMEOS)
|
| - // Get the slot for system-wide key data. May be NULL if the system token was
|
| - // not explicitly set.
|
| - // Note: The System slot is set after the NSSCertDatabase is constructed and
|
| - // this call returns synchronously. Thus, it is possible to call this function
|
| - // before SetSystemSlot is called and get a NULL result.
|
| - // See https://crbug.com/399554 .
|
| - virtual crypto::ScopedPK11Slot GetSystemSlot() const;
|
| -#endif
|
| -
|
| - // Get the default slot for public key data.
|
| - crypto::ScopedPK11Slot GetPublicSlot() const;
|
| -
|
| - // Get the default slot for private key or mixed private/public key data.
|
| - // Can return NULL.
|
| - crypto::ScopedPK11Slot GetPrivateSlot() const;
|
| -
|
| - // Get the default module for public key data.
|
| - // The returned pointer must be stored in a scoped_refptr<CryptoModule>.
|
| - // DEPRECATED: use GetPublicSlot instead.
|
| - // TODO(mattm): remove usage of this method and remove it.
|
| - CryptoModule* GetPublicModule() const;
|
| -
|
| - // Get the default module for private key or mixed private/public key data.
|
| - // The returned pointer must be stored in a scoped_refptr<CryptoModule>.
|
| - // DEPRECATED: use GetPrivateSlot instead.
|
| - // TODO(mattm): remove usage of this method and remove it.
|
| - CryptoModule* GetPrivateModule() const;
|
| -
|
| - // Get all modules.
|
| - // If |need_rw| is true, only writable modules will be returned.
|
| - // TODO(mattm): come up with better alternative to CryptoModuleList.
|
| - virtual void ListModules(CryptoModuleList* modules, bool need_rw) const;
|
| -
|
| - // Import certificates and private keys from PKCS #12 blob into the module.
|
| - // If |is_extractable| is false, mark the private key as being unextractable
|
| - // from the module.
|
| - // Returns OK or a network error code such as ERR_PKCS12_IMPORT_BAD_PASSWORD
|
| - // or ERR_PKCS12_IMPORT_ERROR. |imported_certs|, if non-NULL, returns a list
|
| - // of certs that were imported.
|
| - int ImportFromPKCS12(CryptoModule* module,
|
| - const std::string& data,
|
| - const base::string16& password,
|
| - bool is_extractable,
|
| - CertificateList* imported_certs);
|
| -
|
| - // Export the given certificates and private keys into a PKCS #12 blob,
|
| - // storing into |output|.
|
| - // Returns the number of certificates successfully exported.
|
| - int ExportToPKCS12(const CertificateList& certs,
|
| - const base::string16& password,
|
| - std::string* output) const;
|
| -
|
| - // Uses similar logic to nsNSSCertificateDB::handleCACertDownload to find the
|
| - // root. Assumes the list is an ordered hierarchy with the root being either
|
| - // the first or last element.
|
| - // TODO(mattm): improve this to handle any order.
|
| - X509Certificate* FindRootInList(const CertificateList& certificates) const;
|
| -
|
| - // Import CA certificates.
|
| - // Tries to import all the certificates given. The root will be trusted
|
| - // according to |trust_bits|. Any certificates that could not be imported
|
| - // will be listed in |not_imported|.
|
| - // Returns false if there is an internal error, otherwise true is returned and
|
| - // |not_imported| should be checked for any certificates that were not
|
| - // imported.
|
| - bool ImportCACerts(const CertificateList& certificates,
|
| - TrustBits trust_bits,
|
| - ImportCertFailureList* not_imported);
|
| -
|
| - // Import server certificate. The first cert should be the server cert. Any
|
| - // additional certs should be intermediate/CA certs and will be imported but
|
| - // not given any trust.
|
| - // Any certificates that could not be imported will be listed in
|
| - // |not_imported|.
|
| - // |trust_bits| can be set to explicitly trust or distrust the certificate, or
|
| - // use TRUST_DEFAULT to inherit trust as normal.
|
| - // Returns false if there is an internal error, otherwise true is returned and
|
| - // |not_imported| should be checked for any certificates that were not
|
| - // imported.
|
| - bool ImportServerCert(const CertificateList& certificates,
|
| - TrustBits trust_bits,
|
| - ImportCertFailureList* not_imported);
|
| -
|
| - // Get trust bits for certificate.
|
| - TrustBits GetCertTrust(const X509Certificate* cert, CertType type) const;
|
| -
|
| - // IsUntrusted returns true if |cert| is specifically untrusted. These
|
| - // certificates are stored in the database for the specific purpose of
|
| - // rejecting them.
|
| - bool IsUntrusted(const X509Certificate* cert) const;
|
| -
|
| - // Set trust values for certificate.
|
| - // Returns true on success or false on failure.
|
| - bool SetCertTrust(const X509Certificate* cert,
|
| - CertType type,
|
| - TrustBits trust_bits);
|
| -
|
| - // Delete certificate and associated private key (if one exists).
|
| - // |cert| is still valid when this function returns. Returns true on
|
| - // success.
|
| - bool DeleteCertAndKey(X509Certificate* cert);
|
| -
|
| - // Like DeleteCertAndKey but does not block by running the removal on a worker
|
| - // thread. This must be called on IO thread and it will run |callback| on IO
|
| - // thread. Never calls |callback| synchronously.
|
| - void DeleteCertAndKeyAsync(const scoped_refptr<X509Certificate>& cert,
|
| - const DeleteCertCallback& callback);
|
| -
|
| - // Check whether cert is stored in a readonly slot.
|
| - bool IsReadOnly(const X509Certificate* cert) const;
|
| -
|
| - // Check whether cert is stored in a hardware slot.
|
| - bool IsHardwareBacked(const X509Certificate* cert) const;
|
| -
|
| - // Overrides task runner that's used for running slow tasks.
|
| - void SetSlowTaskRunnerForTest(
|
| - const scoped_refptr<base::TaskRunner>& task_runner);
|
| -
|
| - protected:
|
| - // Certificate listing implementation used by |ListCerts*| and
|
| - // |ListCertsSync|. Static so it may safely be used on the worker thread.
|
| - // If |slot| is NULL, obtains the certs of all slots, otherwise only of
|
| - // |slot|.
|
| - static void ListCertsImpl(crypto::ScopedPK11Slot slot,
|
| - CertificateList* certs);
|
| -
|
| - // Gets task runner that should be used for slow tasks like certificate
|
| - // listing. Defaults to a base::WorkerPool runner, but may be overriden
|
| - // in tests (see SetSlowTaskRunnerForTest).
|
| - scoped_refptr<base::TaskRunner> GetSlowTaskRunner() const;
|
| -
|
| - protected:
|
| - // Broadcasts notifications to all registered observers.
|
| - void NotifyObserversOfCertAdded(const X509Certificate* cert);
|
| - void NotifyObserversOfCertRemoved(const X509Certificate* cert);
|
| - void NotifyObserversOfCACertChanged(const X509Certificate* cert);
|
| -
|
| - private:
|
| - // Registers |observer| to receive notifications of certificate changes. The
|
| - // thread on which this is called is the thread on which |observer| will be
|
| - // called back with notifications.
|
| - // NOTE: Observers registered here will only receive notifications generated
|
| - // directly through the NSSCertDatabase, but not those from the CertDatabase.
|
| - // CertDatabase observers will receive all certificate notifications.
|
| - void AddObserver(Observer* observer);
|
| -
|
| - // Unregisters |observer| from receiving notifications. This must be called
|
| - // on the same thread on which AddObserver() was called.
|
| - void RemoveObserver(Observer* observer);
|
| -
|
| - // Notifies observers of the removal of |cert| and calls |callback| with
|
| - // |success| as argument.
|
| - void NotifyCertRemovalAndCallBack(scoped_refptr<X509Certificate> cert,
|
| - const DeleteCertCallback& callback,
|
| - bool success);
|
| -
|
| - // Certificate removal implementation used by |DeleteCertAndKey*|. Static so
|
| - // it may safely be used on the worker thread.
|
| - static bool DeleteCertAndKeyImpl(scoped_refptr<X509Certificate> cert);
|
| -
|
| - crypto::ScopedPK11Slot public_slot_;
|
| - crypto::ScopedPK11Slot private_slot_;
|
| -
|
| - // A helper observer that forwards events from this database to CertDatabase.
|
| - scoped_ptr<Observer> cert_notification_forwarder_;
|
| -
|
| - // Task runner that should be used in tests if set.
|
| - scoped_refptr<base::TaskRunner> slow_task_runner_for_test_;
|
| -
|
| - const scoped_refptr<ObserverListThreadSafe<Observer> > observer_list_;
|
| -
|
| - base::WeakPtrFactory<NSSCertDatabase> weak_factory_;
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(NSSCertDatabase);
|
| -};
|
| -
|
| -} // namespace net
|
| -
|
| -#endif // NET_CERT_NSS_CERT_DATABASE_H_
|
|
|