Index: net/cert/internal/verify_certificate_chain.h |
diff --git a/net/cert/internal/verify_certificate_chain.h b/net/cert/internal/verify_certificate_chain.h |
index a8b29176d756d8af2b38efe9b535606060a2eb74..8d1f044805192df088776b66f6a9b9f6f6c9a50e 100644 |
--- a/net/cert/internal/verify_certificate_chain.h |
+++ b/net/cert/internal/verify_certificate_chain.h |
@@ -5,7 +5,7 @@ |
#ifndef NET_CERT_INTERNAL_VERIFY_CERTIFICATE_CHAIN_H_ |
#define NET_CERT_INTERNAL_VERIFY_CERTIFICATE_CHAIN_H_ |
-#include <set> |
+#include <vector> |
#include "base/compiler_specific.h" |
#include "base/memory/ref_counted.h" |
@@ -30,160 +30,72 @@ |
CLIENT_AUTH, |
}; |
-enum class InitialExplicitPolicy { |
- kFalse, |
- kTrue, |
-}; |
- |
-enum class InitialPolicyMappingInhibit { |
- kFalse, |
- kTrue, |
-}; |
- |
-enum class InitialAnyPolicyInhibit { |
- kFalse, |
- kTrue, |
-}; |
- |
// VerifyCertificateChain() verifies an ordered certificate path in accordance |
-// with RFC 5280's "Certification Path Validation" algorithm (section 6). |
+// with RFC 5280 (with some modifications [1]). |
// |
-// ----------------------------------------- |
-// Deviations from RFC 5280 |
-// ----------------------------------------- |
+// [1] Deviations from RFC 5280: |
// |
-// * If Extended Key Usage appears on intermediates, it is treated as |
-// a restriction on subordinate certificates. |
+// * If Extended Key Usage appears on intermediates it is treated as a |
+// restriction on subordinate certificates. |
// |
-// ----------------------------------------- |
-// Additional responsibilities of the caller |
-// ----------------------------------------- |
-// |
-// After successful path verification, the caller is responsible for |
-// subsequently checking: |
+// The caller is responsible for additionally checking: |
// |
// * The end-entity's KeyUsage before using its SPKI. |
-// * The end-entity's name/subjectAltName. Name constraints from intermediates |
-// will have already been applied, so it is sufficient to check the |
-// end-entity for a match. |
+// * The end-entity's name/subjectAltName (note that name constraints from |
+// intermediates will have already been applied, so just need to check |
+// the end-entity for a match). |
+// * Policies |
+// |
+// WARNING: This implementation is in progress, and is currently incomplete. |
+// Consult an OWNER before using it. |
+// |
+// TODO(eroman): Take a CertPath instead of ParsedCertificateList + |
+// TrustAnchor. |
// |
// --------- |
// Inputs |
// --------- |
// |
-// certs: |
-// A non-empty chain of DER-encoded certificates, listed in the |
-// "forward" direction. The first certificate is the target |
-// certificate to verify, and the last certificate has trustedness |
-// given by |last_cert_trust| (generally a trust anchor). |
+// cert_chain: |
+// A non-empty chain of N DER-encoded certificates, listed in the |
+// "forward" direction. The first certificate is the target certificate to |
+// verify, and the last certificate has trustedness given by |
+// |last_cert_trust|. |
// |
-// * certs[0] is the target certificate to verify. |
-// * certs[i+1] holds the certificate that issued cert_chain[i]. |
-// * certs[N-1] the root certificate |
-// |
-// Note that THIS IS NOT identical in meaning to the same named |
-// "certs" input defined in RFC 5280 section 6.1.1.a. The differences |
-// are: |
-// |
-// * The order of certificates is reversed |
-// * In RFC 5280 "certs" DOES NOT include the trust anchor |
+// * cert_chain[0] is the target certificate to verify. |
+// * cert_chain[i+1] holds the certificate that issued cert_chain[i]. |
+// * cert_chain[N-1] the root certificate |
// |
// last_cert_trust: |
-// Trustedness of |certs.back()|. The trustedness of |certs.back()| |
-// MUST BE decided by the caller -- this function takes it purely as |
-// an input. Moreover, the CertificateTrust can be used to specify |
-// trust anchor constraints. |
-// |
-// This combined with |certs.back()| (the root certificate) fills a |
-// similar role to "trust anchor information" defined in RFC 5280 |
-// section 6.1.1.d. |
+// Trustedness of certs.back(). The trustedness of certs.back() MUST BE |
+// decided by the caller -- this function takes it purely as an input. |
+// Moreover, the CertificateTrust can be used to specify trust anchor |
+// constraints [1] |
// |
// signature_policy: |
// The policy to use when verifying signatures (what hash algorithms are |
// allowed, what length keys, what named curves, etc). |
// |
// time: |
-// The UTC time to use for expiration checks. This is equivalent to |
-// the input from RFC 5280 section 6.1.1: |
+// The UTC time to use for expiration checks. |
// |
-// (b) the current date/time. |
-// |
-// required_key_purpose: |
+// key_purpose: |
// The key purpose that the target certificate needs to be valid for. |
-// |
-// user_initial_policy_set: |
-// This is equivalent to the same named input in RFC 5280 section |
-// 6.1.1: |
-// |
-// (c) user-initial-policy-set: A set of certificate policy |
-// identifiers naming the policies that are acceptable to the |
-// certificate user. The user-initial-policy-set contains the |
-// special value any-policy if the user is not concerned about |
-// certificate policy. |
-// |
-// initial_policy_mapping_inhibit: |
-// This is equivalent to the same named input in RFC 5280 section |
-// 6.1.1: |
-// |
-// (e) initial-policy-mapping-inhibit, which indicates if policy |
-// mapping is allowed in the certification path. |
-// |
-// initial_explicit_policy: |
-// This is equivalent to the same named input in RFC 5280 section |
-// 6.1.1: |
-// |
-// (f) initial-explicit-policy, which indicates if the path must be |
-// valid for at least one of the certificate policies in the |
-// user-initial-policy-set. |
-// |
-// initial_any_policy_inhibit: |
-// This is equivalent to the same named input in RFC 5280 section |
-// 6.1.1: |
-// |
-// (g) initial-any-policy-inhibit, which indicates whether the |
-// anyPolicy OID should be processed if it is included in a |
-// certificate. |
// |
// --------- |
// Outputs |
// --------- |
-// |
-// user_constrained_policy_set: |
-// Can be null. If non-null, |user_constrained_policy_set| will be filled |
-// with the matching policies (intersected with user_initial_policy_set). |
-// This is equivalent to the same named output in X.509 section 10.2. |
-// Note that it is OK for this to point to input user_initial_policy_set. |
-// |
// errors: |
// Must be non-null. The set of errors/warnings encountered while |
// validating the path are appended to this structure. If verification |
// failed, then there is guaranteed to be at least 1 high severity error |
// written to |errors|. |
// |
-// ------------------------- |
-// Trust Anchor constraints |
-// ------------------------- |
-// |
-// Conceptually, VerifyCertificateChain() sets RFC 5937's |
-// "enforceTrustAnchorConstraints" to true. |
-// |
-// One specifies trust anchor constraints using the |last_cert_trust| |
-// parameter in conjunction with extensions appearing in |certs.back()|. |
-// |
-// The trust anchor |certs.back()| is always passed as a certificate to |
-// this function, however the manner in which that certificate is |
-// interpreted depends on |last_cert_trust|: |
-// |
-// TRUSTED_ANCHOR: |
-// |
-// No properties from the root certificate, other than its Subject and |
-// SPKI, are checked during verification. This is the usual |
-// interpretation for a "trust anchor". |
-// |
-// TRUSTED_ANCHOR_WITH_CONSTRAINTS: |
-// |
-// Only a subset of extensions and properties from the certificate are checked, |
-// as described by RFC 5937. |
+// [1] Conceptually VerifyCertificateChain() sets RFC 5937's |
+// "enforceTrustAnchorConstraints" to true. And one specifies whether to |
+// interpret a root certificate as having trust anchor constraints through the |
+// |last_cert_trust| parameter. The constraints are just a subset of the |
+// extensions present in the certificate: |
// |
// * Signature: No |
// * Validity (expiration): No |
@@ -192,24 +104,17 @@ |
// * Basic constraints: Yes, but only the pathlen (CA=false is accepted) |
// * Name constraints: Yes |
// * Certificate policies: Not currently, TODO(crbug.com/634453) |
-// * Policy Mappings: No |
// * inhibitAnyPolicy: Not currently, TODO(crbug.com/634453) |
// * PolicyConstraints: Not currently, TODO(crbug.com/634452) |
// |
// The presence of any other unrecognized extension marked as critical fails |
// validation. |
-NET_EXPORT void VerifyCertificateChain( |
- const ParsedCertificateList& certs, |
- const CertificateTrust& last_cert_trust, |
- const SignaturePolicy* signature_policy, |
- const der::GeneralizedTime& time, |
- KeyPurpose required_key_purpose, |
- InitialExplicitPolicy initial_explicit_policy, |
- const std::set<der::Input>& user_initial_policy_set, |
- InitialPolicyMappingInhibit initial_policy_mapping_inhibit, |
- InitialAnyPolicyInhibit initial_any_policy_inhibit, |
- std::set<der::Input>* user_constrained_policy_set, |
- CertPathErrors* errors); |
+NET_EXPORT void VerifyCertificateChain(const ParsedCertificateList& certs, |
+ const CertificateTrust& last_cert_trust, |
+ const SignaturePolicy* signature_policy, |
+ const der::GeneralizedTime& time, |
+ KeyPurpose required_key_purpose, |
+ CertPathErrors* errors); |
// TODO(crbug.com/634443): Move exported errors to a central location? |
extern CertErrorId kValidityFailedNotAfter; |