naiveproxy/net/cert/ct_verifier.h
2018-02-02 05:49:39 -05:00

64 lines
2.7 KiB
C++

// 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 "base/strings/string_piece.h"
#include "net/base/net_export.h"
#include "net/cert/signed_certificate_timestamp_and_status.h"
namespace net {
class NetLogWithSource;
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. |output_scts| will be cleared and filled with the SCTs
// present, if any, along with their verification results.
virtual void Verify(X509Certificate* cert,
base::StringPiece stapled_ocsp_response,
base::StringPiece sct_list_from_tls_extension,
SignedCertificateTimestampAndStatusList* output_scts,
const NetLogWithSource& 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_