| // Copyright (c) 2012 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_SSL_SSL_INFO_H_ | |
| #define NET_SSL_SSL_INFO_H_ | |
| #include <stdint.h> | |
| #include <vector> | |
| #include "base/memory/ref_counted.h" | |
| #include "net/base/net_export.h" | |
| #include "net/cert/cert_status_flags.h" | |
| #include "net/cert/ct_policy_status.h" | |
| #include "net/cert/ct_verify_result.h" | |
| #include "net/cert/ocsp_verify_result.h" | |
| #include "net/cert/sct_status_flags.h" | |
| #include "net/cert/signed_certificate_timestamp_and_status.h" | |
| #include "net/cert/x509_cert_types.h" | |
| #include "net/ssl/ssl_config.h" | |
| namespace net { | |
| class X509Certificate; | |
| // SSL connection info. | |
| // This is really a struct. All members are public. | |
| class NET_EXPORT SSLInfo { | |
| public: | |
| // HandshakeType enumerates the possible resumption cases after an SSL | |
| // handshake. | |
| enum HandshakeType { | |
| HANDSHAKE_UNKNOWN = 0, | |
| HANDSHAKE_RESUME, // we resumed a previous session. | |
| HANDSHAKE_FULL, // we negotiated a new session. | |
| }; | |
| SSLInfo(); | |
| SSLInfo(const SSLInfo& info); | |
| ~SSLInfo(); | |
| SSLInfo& operator=(const SSLInfo& info); | |
| void Reset(); | |
| bool is_valid() const { return cert.get() != NULL; } | |
| // Adds the specified |error| to the cert status. | |
| void SetCertError(int error); | |
| // Adds the SignedCertificateTimestamps and policy compliance details | |
| // from ct_verify_result to |signed_certificate_timestamps| and | |
| // |ct_policy_compliance_details|. SCTs are held in three separate | |
| // vectors in ct_verify_result, each vetor representing a particular | |
| // verification state, this method associates each of the SCTs with | |
| // the corresponding SCTVerifyStatus as it adds it to the | |
| // |signed_certificate_timestamps| list. | |
| void UpdateCertificateTransparencyInfo( | |
| const ct::CTVerifyResult& ct_verify_result); | |
| // The SSL certificate. | |
| scoped_refptr<X509Certificate> cert; | |
| // The SSL certificate as received by the client. Can be different | |
| // from |cert|, which is the chain as built by the client during | |
| // validation. | |
| scoped_refptr<X509Certificate> unverified_cert; | |
| // Bitmask of status info of |cert|, representing, for example, known errors | |
| // and extended validation (EV) status. | |
| // See cert_status_flags.h for values. | |
| CertStatus cert_status = 0; | |
| // The ID of the (EC)DH group used by the key exchange or zero if unknown | |
| // (older cache entries may not store the value) or not applicable. | |
| uint16_t key_exchange_group = 0; | |
| // The signature algorithm used by the peer in the TLS handshake, as defined | |
| // by the TLS SignatureScheme registry | |
| // (https://www.iana.org/assignments/tls-parameters/tls-parameters.xhtml#tls-signaturescheme). | |
| // These correspond to |SSL_SIGN_*| constants in BoringSSL. The value is zero | |
| // if unknown (older cache entries may not store the value) or not applicable. | |
| uint16_t peer_signature_algorithm = 0; | |
| // Information about the SSL connection itself. See | |
| // ssl_connection_status_flags.h for values. The protocol version, | |
| // ciphersuite, and compression in use are encoded within. | |
| int connection_status = 0; | |
| // If the certificate is valid, then this is true iff it was rooted at a | |
| // standard CA root. (As opposed to a user-installed root.) | |
| bool is_issued_by_known_root = false; | |
| // True if pinning was bypassed on this connection. | |
| bool pkp_bypassed = false; | |
| // True if a client certificate was sent to the server. Note that sending | |
| // a Certificate message with no client certificate in it does not count. | |
| bool client_cert_sent = false; | |
| // True if a channel ID was sent to the server. | |
| bool channel_id_sent = false; | |
| // True if data was received over early data on the server. This field is only | |
| // set for server sockets. | |
| bool early_data_received = false; | |
| HandshakeType handshake_type = HANDSHAKE_UNKNOWN; | |
| // The hashes, in several algorithms, of the SubjectPublicKeyInfos from | |
| // each certificate in the chain. | |
| HashValueVector public_key_hashes; | |
| // pinning_failure_log contains a message produced by | |
| // TransportSecurityState::PKPState::CheckPublicKeyPins in the event of a | |
| // pinning failure. It is a (somewhat) human-readable string. | |
| std::string pinning_failure_log; | |
| // List of SignedCertificateTimestamps and their corresponding validation | |
| // status. | |
| SignedCertificateTimestampAndStatusList signed_certificate_timestamps; | |
| // Whether the connection complied with the CT cert policy, and if | |
| // not, why not. | |
| ct::CTPolicyCompliance ct_policy_compliance = | |
| ct::CTPolicyCompliance::CT_POLICY_COMPLIANCE_DETAILS_NOT_AVAILABLE; | |
| // True if the connection was required to comply with the CT cert policy. Only | |
| // meaningful if |ct_policy_compliance| is not | |
| // COMPLIANCE_DETAILS_NOT_AVAILABLE. | |
| bool ct_policy_compliance_required = false; | |
| // OCSP stapling details. | |
| OCSPVerifyResult ocsp_result; | |
| // True if there was a certificate error which should be treated as fatal, | |
| // and false otherwise. | |
| bool is_fatal_cert_error = false; | |
| }; | |
| } // namespace net | |
| #endif // NET_SSL_SSL_INFO_H_ |