text: // Copyright 2013 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_CT_VERIFIER_H_
  #define NET_CERT_CT_VERIFIER_H_
  
  #include <string>
  
  #include "net/base/net_export.h"
  
  namespace net {
  
  namespace ct {
  struct CTVerifyResult;
  struct SignedCertificateTimestamp;
  }  // namespace ct
  
  class BoundNetLog;
  class CTLogVerifier;
  class X509Certificate;
  
  // Interface for verifying Signed Certificate Timestamps over a certificate.
  class NET_EXPORT CTVerifier {
   public:
    class NET_EXPORT Observer {
     public:
      // Called for each Signed Certificate Timestamp from a known log that vas
      // verified successfully (i.e. the signature verifies). |sct| is the
      // Signed Certificate Timestamp, |cert| is the certificate it applies to.
      // The certificate is needed to calculate the hash of the log entry,
      // necessary for checking inclusion in the log.
      // Note: The observer (whose implementation is expected to exist outside
      // net/) may store the observed |cert| and |sct|.
      virtual void OnSCTVerified(X509Certificate* cert,
                                 const ct::SignedCertificateTimestamp* sct) = 0;
  
     protected:
      virtual ~Observer() {}
    };
  
    virtual ~CTVerifier() {}
  
    // Verifies SCTs embedded in the certificate itself, SCTs embedded in a
    // stapled OCSP response, and SCTs obtained via the
    // signed_certificate_timestamp TLS extension on the given |cert|.
    // A certificate is permitted but not required to use multiple sources for
    // SCTs. It is expected that most certificates will use only one source
    // (embedding, TLS extension or OCSP stapling). If no stapled OCSP response
    // is available, |stapled_ocsp_response| should be an empty string. If no SCT
    // TLS extension was negotiated, |sct_list_from_tls_extension| should be an
    // empty string. |result| will be filled with the SCTs present, divided into
    // categories based on the verification result.
    virtual int Verify(X509Certificate* cert,
                       const std::string& stapled_ocsp_response,
                       const std::string& sct_list_from_tls_extension,
                       ct::CTVerifyResult* result,
                       const BoundNetLog& net_log) = 0;
  
    // Registers |observer| to receive notifications of validated SCTs. Does not
    // take ownership of the observer as the observer may be performing
    // URLRequests which have to be cancelled before this object is destroyed.
    // Setting |observer| to nullptr has the effect of stopping all notifications.
    virtual void SetObserver(Observer* observer) = 0;
  };
  
  }  // namespace net
  
  #endif  // NET_CERT_CT_VERIFIER_H_
  