ssl_error_info.h revision a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7
1// Copyright (c) 2011 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 CHROME_BROWSER_SSL_SSL_ERROR_INFO_H_ 6#define CHROME_BROWSER_SSL_SSL_ERROR_INFO_H_ 7 8#include <string> 9#include <vector> 10 11#include "base/strings/string16.h" 12#include "net/cert/cert_status_flags.h" 13#include "net/cert/x509_certificate.h" 14 15class GURL; 16 17// This class describes an error that happened while showing a page over SSL. 18// An SSLErrorInfo object only exists on the UI thread and only contains 19// information about an error (type of error and text details). 20// Note no DISALLOW_COPY_AND_ASSIGN as we want the copy constructor. 21class SSLErrorInfo { 22 public: 23 // This enum is being histogrammed; please only add new values at the end. 24 enum ErrorType { 25 CERT_COMMON_NAME_INVALID = 0, 26 CERT_DATE_INVALID, 27 CERT_AUTHORITY_INVALID, 28 CERT_CONTAINS_ERRORS, 29 CERT_NO_REVOCATION_MECHANISM, 30 CERT_UNABLE_TO_CHECK_REVOCATION, 31 CERT_REVOKED, 32 CERT_INVALID, 33 CERT_WEAK_SIGNATURE_ALGORITHM, 34 CERT_WEAK_KEY, 35 UNKNOWN, 36 CERT_WEAK_KEY_DH, 37 CERT_PINNED_KEY_MISSING, 38 END_OF_ENUM 39 }; 40 41 virtual ~SSLErrorInfo(); 42 43 // Converts a network error code to an ErrorType. 44 static ErrorType NetErrorToErrorType(int net_error); 45 46 static SSLErrorInfo CreateError(ErrorType error_type, 47 net::X509Certificate* cert, 48 const GURL& request_url); 49 50 // Populates the specified |errors| vector with the errors contained in 51 // |cert_status|. Returns the number of errors found. 52 // Callers only interested in the error count can pass NULL for |errors|. 53 // TODO(wtc): Document |cert_id| and |url| arguments. 54 static int GetErrorsForCertStatus(int cert_id, 55 net::CertStatus cert_status, 56 const GURL& url, 57 std::vector<SSLErrorInfo>* errors); 58 59 // A title describing the error, usually to be used with the details below. 60 const base::string16& title() const { return title_; } 61 62 // A description of the error. 63 const base::string16& details() const { return details_; } 64 65 // A short message describing the error (1 line). 66 const base::string16& short_description() const { return short_description_; } 67 68 // A lengthy explanation of what the error is. Each entry in the returned 69 // vector is a paragraph. 70 const std::vector<string16>& extra_information() const { 71 return extra_information_; 72 } 73 74 private: 75 SSLErrorInfo(const base::string16& title, 76 const base::string16& details, 77 const base::string16& short_description, 78 const std::vector<string16>& extra_info); 79 80 base::string16 title_; 81 base::string16 details_; 82 base::string16 short_description_; 83 // Extra-informations contains paragraphs of text explaining in details what 84 // the error is and what the risks are. 85 std::vector<string16> extra_information_; 86}; 87 88#endif // CHROME_BROWSER_SSL_SSL_ERROR_INFO_H_ 89