net/ssl/client_cert_store.h

   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
   3 // found in the LICENSE file.
   4
   5 #ifndef NET_SSL_CLIENT_CERT_STORE_H_
   6 #define NET_SSL_CLIENT_CERT_STORE_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/callback_forward.h"
  10 #include "net/base/net_export.h"
  11 #include "net/cert/x509_certificate.h"
  12
  13 namespace net {
  14
  15 class SSLCertRequestInfo;
  16
  17 // A handle to a client certificate store to query matching certificates when a
  18 // server requests client auth. Note that there may be multiple ClientCertStore
  19 // objects corresponding to the same platform certificate store; each request
  20 // gets its own uniquely owned handle.
  21 class NET_EXPORT ClientCertStore {
  22  public:
  23   virtual ~ClientCertStore() {}
  24
  25   // Get client certs matching the |cert_request_info|. On completion, the
  26   // results will be stored in |selected_certs| and the |callback| will be run.
  27   // The |callback| may be called sychronously. The caller must ensure the
  28   // ClientCertStore, |cert_request_info|, and |selected_certs| remain alive
  29   // until the callback has been run.
  30   virtual void GetClientCerts(const SSLCertRequestInfo& cert_request_info,
  31                               CertificateList* selected_certs,
  32                               const base::Closure& callback) = 0;
  33  protected:
  34   ClientCertStore() {}
  35
  36  private:
  37   DISALLOW_COPY_AND_ASSIGN(ClientCertStore);
  38 };
  39
  40 }  // namespace net
  41
  42 #endif  // NET_SSL_CLIENT_CERT_STORE_H_