| OLD | NEW |
| (Empty) |
| 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_CERT_CERT_VERIFY_PROC_H_ | |
| 6 #define NET_CERT_CERT_VERIFY_PROC_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 #include <vector> | |
| 10 | |
| 11 #include "base/gtest_prod_util.h" | |
| 12 #include "base/memory/ref_counted.h" | |
| 13 #include "net/base/net_export.h" | |
| 14 #include "net/cert/x509_cert_types.h" | |
| 15 | |
| 16 namespace net { | |
| 17 | |
| 18 class CertVerifyResult; | |
| 19 class CRLSet; | |
| 20 class X509Certificate; | |
| 21 typedef std::vector<scoped_refptr<X509Certificate> > CertificateList; | |
| 22 | |
| 23 // Class to perform certificate path building and verification for various | |
| 24 // certificate uses. All methods of this class must be thread-safe, as they | |
| 25 // may be called from various non-joinable worker threads. | |
| 26 class NET_EXPORT CertVerifyProc | |
| 27 : public base::RefCountedThreadSafe<CertVerifyProc> { | |
| 28 public: | |
| 29 // Creates and returns the default CertVerifyProc. | |
| 30 static CertVerifyProc* CreateDefault(); | |
| 31 | |
| 32 // Verifies the certificate against the given hostname as an SSL server | |
| 33 // certificate. Returns OK if successful or an error code upon failure. | |
| 34 // | |
| 35 // The |*verify_result| structure, including the |verify_result->cert_status| | |
| 36 // bitmask, is always filled out regardless of the return value. If the | |
| 37 // certificate has multiple errors, the corresponding status flags are set in | |
| 38 // |verify_result->cert_status|, and the error code for the most serious | |
| 39 // error is returned. | |
| 40 // | |
| 41 // |flags| is bitwise OR'd of VerifyFlags: | |
| 42 // | |
| 43 // If VERIFY_REV_CHECKING_ENABLED is set in |flags|, online certificate | |
| 44 // revocation checking is performed (i.e. OCSP and downloading CRLs). CRLSet | |
| 45 // based revocation checking is always enabled, regardless of this flag, if | |
| 46 // |crl_set| is given. | |
| 47 // | |
| 48 // If VERIFY_EV_CERT is set in |flags| too, EV certificate verification is | |
| 49 // performed. | |
| 50 // | |
| 51 // |crl_set| points to an optional CRLSet structure which can be used to | |
| 52 // avoid revocation checks over the network. | |
| 53 // | |
| 54 // |additional_trust_anchors| lists certificates that can be trusted when | |
| 55 // building a certificate chain, in addition to the anchors known to the | |
| 56 // implementation. | |
| 57 int Verify(X509Certificate* cert, | |
| 58 const std::string& hostname, | |
| 59 int flags, | |
| 60 CRLSet* crl_set, | |
| 61 const CertificateList& additional_trust_anchors, | |
| 62 CertVerifyResult* verify_result); | |
| 63 | |
| 64 // Returns true if the implementation supports passing additional trust | |
| 65 // anchors to the Verify() call. The |additional_trust_anchors| parameter | |
| 66 // passed to Verify() is ignored when this returns false. | |
| 67 virtual bool SupportsAdditionalTrustAnchors() const = 0; | |
| 68 | |
| 69 protected: | |
| 70 CertVerifyProc(); | |
| 71 virtual ~CertVerifyProc(); | |
| 72 | |
| 73 private: | |
| 74 friend class base::RefCountedThreadSafe<CertVerifyProc>; | |
| 75 FRIEND_TEST_ALL_PREFIXES(CertVerifyProcTest, DigiNotarCerts); | |
| 76 FRIEND_TEST_ALL_PREFIXES(CertVerifyProcTest, TestHasTooLongValidity); | |
| 77 | |
| 78 // Performs the actual verification using the desired underlying | |
| 79 // cryptographic library. | |
| 80 virtual int VerifyInternal(X509Certificate* cert, | |
| 81 const std::string& hostname, | |
| 82 int flags, | |
| 83 CRLSet* crl_set, | |
| 84 const CertificateList& additional_trust_anchors, | |
| 85 CertVerifyResult* verify_result) = 0; | |
| 86 | |
| 87 // Returns true if |cert| is explicitly blacklisted. | |
| 88 static bool IsBlacklisted(X509Certificate* cert); | |
| 89 | |
| 90 // IsPublicKeyBlacklisted returns true iff one of |public_key_hashes| (which | |
| 91 // are hashes of SubjectPublicKeyInfo structures) is explicitly blocked. | |
| 92 static bool IsPublicKeyBlacklisted(const HashValueVector& public_key_hashes); | |
| 93 | |
| 94 // HasNameConstraintsViolation returns true iff one of |public_key_hashes| | |
| 95 // (which are hashes of SubjectPublicKeyInfo structures) has name constraints | |
| 96 // imposed on it and the names in |dns_names| are not permitted. | |
| 97 static bool HasNameConstraintsViolation( | |
| 98 const HashValueVector& public_key_hashes, | |
| 99 const std::string& common_name, | |
| 100 const std::vector<std::string>& dns_names, | |
| 101 const std::vector<std::string>& ip_addrs); | |
| 102 | |
| 103 // The CA/Browser Forum's Baseline Requirements specify maximum validity | |
| 104 // periods (https://cabforum.org/Baseline_Requirements_V1.pdf): | |
| 105 // | |
| 106 // For certificates issued after 1 July 2012: 60 months. | |
| 107 // For certificates issued after 1 April 2015: 39 months. | |
| 108 // | |
| 109 // For certificates issued before the BRs took effect, there were no | |
| 110 // guidelines, but clamp them at a maximum of 10 year validity, with the | |
| 111 // requirement they expire within 7 years after the effective date of the BRs | |
| 112 // (i.e. by 1 July 2019). | |
| 113 static bool HasTooLongValidity(const X509Certificate& cert); | |
| 114 | |
| 115 DISALLOW_COPY_AND_ASSIGN(CertVerifyProc); | |
| 116 }; | |
| 117 | |
| 118 } // namespace net | |
| 119 | |
| 120 #endif // NET_CERT_CERT_VERIFY_PROC_H_ | |
| OLD | NEW |