Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(170)

Side by Side Diff: net/cert/nss_cert_database.h

Issue 405973003: Remove the deprecated NSSCertDatabase::GetInstance() . (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: Changed comment. Created 6 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
« no previous file with comments | « chromeos/cert_loader_unittest.cc ('k') | net/cert/nss_cert_database.cc » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 #ifndef NET_CERT_NSS_CERT_DATABASE_H_ 5 #ifndef NET_CERT_NSS_CERT_DATABASE_H_
6 #define NET_CERT_NSS_CERT_DATABASE_H_ 6 #define NET_CERT_NSS_CERT_DATABASE_H_
7 7
8 #include <string> 8 #include <string>
9 #include <vector> 9 #include <vector>
10 10
11 #include "base/basictypes.h" 11 #include "base/basictypes.h"
12 #include "base/callback_forward.h" 12 #include "base/callback_forward.h"
13 #include "base/memory/ref_counted.h" 13 #include "base/memory/ref_counted.h"
14 #include "base/memory/weak_ptr.h" 14 #include "base/memory/weak_ptr.h"
15 #include "base/strings/string16.h" 15 #include "base/strings/string16.h"
16 #include "crypto/scoped_nss_types.h" 16 #include "crypto/scoped_nss_types.h"
17 #include "net/base/net_errors.h" 17 #include "net/base/net_errors.h"
18 #include "net/base/net_export.h" 18 #include "net/base/net_export.h"
19 #include "net/cert/cert_type.h" 19 #include "net/cert/cert_type.h"
20 #include "net/cert/x509_certificate.h" 20 #include "net/cert/x509_certificate.h"
21 21
22 namespace base { 22 namespace base {
23 template <typename T> struct DefaultLazyInstanceTraits;
24 class TaskRunner; 23 class TaskRunner;
25 } 24 }
26 template <class ObserverType> class ObserverListThreadSafe; 25 template <class ObserverType> class ObserverListThreadSafe;
27 26
28 namespace net { 27 namespace net {
29 28
30 class CryptoModule; 29 class CryptoModule;
31 typedef std::vector<scoped_refptr<CryptoModule> > CryptoModuleList; 30 typedef std::vector<scoped_refptr<CryptoModule> > CryptoModuleList;
32 31
33 // Provides functions to manipulate the NSS certificate stores. 32 // Provides functions to manipulate the NSS certificate stores.
34 // Forwards notifications about certificate changes to the global CertDatabase 33 // Forwards notifications about certificate changes to the global CertDatabase
35 // singleton. 34 // singleton.
36 class NET_EXPORT NSSCertDatabase { 35 class NET_EXPORT NSSCertDatabase {
37 public: 36 public:
38
39 class NET_EXPORT Observer { 37 class NET_EXPORT Observer {
40 public: 38 public:
41 virtual ~Observer() {} 39 virtual ~Observer() {}
42 40
43 // Will be called when a new certificate is added. 41 // Will be called when a new certificate is added.
44 // Called with |cert| == NULL after importing a list of certificates 42 // Called with |cert| == NULL after importing a list of certificates
45 // in ImportFromPKCS12(). 43 // in ImportFromPKCS12().
46 virtual void OnCertAdded(const X509Certificate* cert) {} 44 virtual void OnCertAdded(const X509Certificate* cert) {}
47 45
48 // Will be called when a certificate is removed. 46 // Will be called when a certificate is removed.
(...skipping 46 matching lines...) Expand 10 before | Expand all | Expand 10 after
95 DISTRUSTED_SSL = 1 << 3, 93 DISTRUSTED_SSL = 1 << 3,
96 DISTRUSTED_EMAIL = 1 << 4, 94 DISTRUSTED_EMAIL = 1 << 4,
97 DISTRUSTED_OBJ_SIGN = 1 << 5, 95 DISTRUSTED_OBJ_SIGN = 1 << 5,
98 }; 96 };
99 97
100 typedef base::Callback<void(scoped_ptr<CertificateList> certs)> 98 typedef base::Callback<void(scoped_ptr<CertificateList> certs)>
101 ListCertsCallback; 99 ListCertsCallback;
102 100
103 typedef base::Callback<void(bool)> DeleteCertCallback; 101 typedef base::Callback<void(bool)> DeleteCertCallback;
104 102
105 // DEPRECATED: See http://crbug.com/329735. 103 // Creates a NSSCertDatabase that will store public information (such as
106 static NSSCertDatabase* GetInstance(); 104 // certificates and trust records) in |public_slot|, and private information
105 // (such as keys) in |private_slot|.
106 // In general, code should avoid creating an NSSCertDatabase directly,
107 // as doing so requires making opinionated decisions about where to store
108 // data, and instead prefer to be passed an existing NSSCertDatabase
109 // instance.
110 // Both slots must not be NULL but can be identical.
111 NSSCertDatabase(crypto::ScopedPK11Slot public_slot,
112 crypto::ScopedPK11Slot private_slot);
113 virtual ~NSSCertDatabase();
107 114
108 // Get a list of unique certificates in the certificate database (one 115 // Get a list of unique certificates in the certificate database (one
109 // instance of all certificates). 116 // instance of all certificates).
110 // DEPRECATED by |ListCerts|. See http://crbug.com/340460. 117 // DEPRECATED by |ListCerts|. See http://crbug.com/340460.
111 virtual void ListCertsSync(CertificateList* certs); 118 virtual void ListCertsSync(CertificateList* certs);
112 119
113 // Asynchronously get a list of unique certificates in the certificate 120 // Asynchronously get a list of unique certificates in the certificate
114 // database (one instance of all certificates). Note that the callback may be 121 // database (one instance of all certificates). Note that the callback may be
115 // run even after the database is deleted. 122 // run even after the database is deleted.
116 virtual void ListCerts(const ListCertsCallback& callback); 123 virtual void ListCerts(const ListCertsCallback& callback);
117 124
118 // Get a list of certificates in the certificate database of the given slot. 125 // Get a list of certificates in the certificate database of the given slot.
119 // Note that the callback may be run even after the database is deleted. 126 // Note that the callback may be run even after the database is deleted.
120 // Must be called on the IO thread and it calls |callback| on the IO thread. 127 // Must be called on the IO thread and it calls |callback| on the IO thread.
121 // This does not block by retrieving the certs asynchronously on a worker 128 // This does not block by retrieving the certs asynchronously on a worker
122 // thread. Never calls |callback| synchronously. 129 // thread. Never calls |callback| synchronously.
123 virtual void ListCertsInSlot(const ListCertsCallback& callback, 130 virtual void ListCertsInSlot(const ListCertsCallback& callback,
124 PK11SlotInfo* slot); 131 PK11SlotInfo* slot);
125 132
126 // Get the default slot for public key data. 133 // Get the default slot for public key data.
127 virtual crypto::ScopedPK11Slot GetPublicSlot() const; 134 crypto::ScopedPK11Slot GetPublicSlot() const;
128 135
129 // Get the default slot for private key or mixed private/public key data. 136 // Get the default slot for private key or mixed private/public key data.
130 virtual crypto::ScopedPK11Slot GetPrivateSlot() const; 137 crypto::ScopedPK11Slot GetPrivateSlot() const;
131 138
132 // Get the default module for public key data. 139 // Get the default module for public key data.
133 // The returned pointer must be stored in a scoped_refptr<CryptoModule>. 140 // The returned pointer must be stored in a scoped_refptr<CryptoModule>.
134 // DEPRECATED: use GetPublicSlot instead. 141 // DEPRECATED: use GetPublicSlot instead.
135 // TODO(mattm): remove usage of this method and remove it. 142 // TODO(mattm): remove usage of this method and remove it.
136 CryptoModule* GetPublicModule() const; 143 CryptoModule* GetPublicModule() const;
137 144
138 // Get the default module for private key or mixed private/public key data. 145 // Get the default module for private key or mixed private/public key data.
139 // The returned pointer must be stored in a scoped_refptr<CryptoModule>. 146 // The returned pointer must be stored in a scoped_refptr<CryptoModule>.
140 // DEPRECATED: use GetPrivateSlot instead. 147 // DEPRECATED: use GetPrivateSlot instead.
(...skipping 84 matching lines...) Expand 10 before | Expand all | Expand 10 after
225 bool IsReadOnly(const X509Certificate* cert) const; 232 bool IsReadOnly(const X509Certificate* cert) const;
226 233
227 // Check whether cert is stored in a hardware slot. 234 // Check whether cert is stored in a hardware slot.
228 bool IsHardwareBacked(const X509Certificate* cert) const; 235 bool IsHardwareBacked(const X509Certificate* cert) const;
229 236
230 // Overrides task runner that's used for running slow tasks. 237 // Overrides task runner that's used for running slow tasks.
231 void SetSlowTaskRunnerForTest( 238 void SetSlowTaskRunnerForTest(
232 const scoped_refptr<base::TaskRunner>& task_runner); 239 const scoped_refptr<base::TaskRunner>& task_runner);
233 240
234 protected: 241 protected:
235 NSSCertDatabase();
236 virtual ~NSSCertDatabase();
237
238 // Certificate listing implementation used by |ListCerts*| and 242 // Certificate listing implementation used by |ListCerts*| and
239 // |ListCertsSync|. Static so it may safely be used on the worker thread. 243 // |ListCertsSync|. Static so it may safely be used on the worker thread.
240 // If |slot| is NULL, obtains the certs of all slots, otherwise only of 244 // If |slot| is NULL, obtains the certs of all slots, otherwise only of
241 // |slot|. 245 // |slot|.
242 static void ListCertsImpl(crypto::ScopedPK11Slot slot, 246 static void ListCertsImpl(crypto::ScopedPK11Slot slot,
243 CertificateList* certs); 247 CertificateList* certs);
244 248
245 // Gets task runner that should be used for slow tasks like certificate 249 // Gets task runner that should be used for slow tasks like certificate
246 // listing. Defaults to a base::WorkerPool runner, but may be overriden 250 // listing. Defaults to a base::WorkerPool runner, but may be overriden
247 // in tests (see SetSlowTaskRunnerForTest). 251 // in tests (see SetSlowTaskRunnerForTest).
248 scoped_refptr<base::TaskRunner> GetSlowTaskRunner() const; 252 scoped_refptr<base::TaskRunner> GetSlowTaskRunner() const;
249 253
250 private: 254 private:
251 friend struct base::DefaultLazyInstanceTraits<NSSCertDatabase>;
252
253 // Registers |observer| to receive notifications of certificate changes. The 255 // Registers |observer| to receive notifications of certificate changes. The
254 // thread on which this is called is the thread on which |observer| will be 256 // thread on which this is called is the thread on which |observer| will be
255 // called back with notifications. 257 // called back with notifications.
256 // NOTE: Observers registered here will only receive notifications generated 258 // NOTE: Observers registered here will only receive notifications generated
257 // directly through the NSSCertDatabase, but not those from the CertDatabase. 259 // directly through the NSSCertDatabase, but not those from the CertDatabase.
258 // CertDatabase observers will receive all certificate notifications. 260 // CertDatabase observers will receive all certificate notifications.
259 void AddObserver(Observer* observer); 261 void AddObserver(Observer* observer);
260 262
261 // Unregisters |observer| from receiving notifications. This must be called 263 // Unregisters |observer| from receiving notifications. This must be called
262 // on the same thread on which AddObserver() was called. 264 // on the same thread on which AddObserver() was called.
263 void RemoveObserver(Observer* observer); 265 void RemoveObserver(Observer* observer);
264 266
265 // Notifies observers of the removal of |cert| and calls |callback| with 267 // Notifies observers of the removal of |cert| and calls |callback| with
266 // |success| as argument. 268 // |success| as argument.
267 void NotifyCertRemovalAndCallBack(scoped_refptr<X509Certificate> cert, 269 void NotifyCertRemovalAndCallBack(scoped_refptr<X509Certificate> cert,
268 const DeleteCertCallback& callback, 270 const DeleteCertCallback& callback,
269 bool success); 271 bool success);
270 272
271 // Broadcasts notifications to all registered observers. 273 // Broadcasts notifications to all registered observers.
272 void NotifyObserversOfCertAdded(const X509Certificate* cert); 274 void NotifyObserversOfCertAdded(const X509Certificate* cert);
273 void NotifyObserversOfCertRemoved(const X509Certificate* cert); 275 void NotifyObserversOfCertRemoved(const X509Certificate* cert);
274 void NotifyObserversOfCACertChanged(const X509Certificate* cert); 276 void NotifyObserversOfCACertChanged(const X509Certificate* cert);
275 277
276 // Certificate removal implementation used by |DeleteCertAndKey*|. Static so 278 // Certificate removal implementation used by |DeleteCertAndKey*|. Static so
277 // it may safely be used on the worker thread. 279 // it may safely be used on the worker thread.
278 static bool DeleteCertAndKeyImpl(scoped_refptr<X509Certificate> cert); 280 static bool DeleteCertAndKeyImpl(scoped_refptr<X509Certificate> cert);
279 281
282 crypto::ScopedPK11Slot public_slot_;
283 crypto::ScopedPK11Slot private_slot_;
284
280 // A helper observer that forwards events from this database to CertDatabase. 285 // A helper observer that forwards events from this database to CertDatabase.
281 scoped_ptr<Observer> cert_notification_forwarder_; 286 scoped_ptr<Observer> cert_notification_forwarder_;
282 287
283 // Task runner that should be used in tests if set. 288 // Task runner that should be used in tests if set.
284 scoped_refptr<base::TaskRunner> slow_task_runner_for_test_; 289 scoped_refptr<base::TaskRunner> slow_task_runner_for_test_;
285 290
286 const scoped_refptr<ObserverListThreadSafe<Observer> > observer_list_; 291 const scoped_refptr<ObserverListThreadSafe<Observer> > observer_list_;
287 292
288 base::WeakPtrFactory<NSSCertDatabase> weak_factory_; 293 base::WeakPtrFactory<NSSCertDatabase> weak_factory_;
289 294
290 DISALLOW_COPY_AND_ASSIGN(NSSCertDatabase); 295 DISALLOW_COPY_AND_ASSIGN(NSSCertDatabase);
291 }; 296 };
292 297
293 } // namespace net 298 } // namespace net
294 299
295 #endif // NET_CERT_NSS_CERT_DATABASE_H_ 300 #endif // NET_CERT_NSS_CERT_DATABASE_H_
OLDNEW
« no previous file with comments | « chromeos/cert_loader_unittest.cc ('k') | net/cert/nss_cert_database.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698