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    CERT_NAME_CONSTRAINT_VIOLATION,
36    UNKNOWN,
37    CERT_WEAK_KEY_DH,
38    CERT_PINNED_KEY_MISSING,
39    END_OF_ENUM
40  };
41
42  virtual ~SSLErrorInfo();
43
44  // Converts a network error code to an ErrorType.
45  static ErrorType NetErrorToErrorType(int net_error);
46
47  static SSLErrorInfo CreateError(ErrorType error_type,
48                                  net::X509Certificate* cert,
49                                  const GURL& request_url);
50
51  // Populates the specified |errors| vector with the errors contained in
52  // |cert_status|.  Returns the number of errors found.
53  // Callers only interested in the error count can pass NULL for |errors|.
54  // TODO(wtc): Document |cert_id| and |url| arguments.
55  static int GetErrorsForCertStatus(int cert_id,
56                                    net::CertStatus cert_status,
57                                    const GURL& url,
58                                    std::vector<SSLErrorInfo>* errors);
59
60  // A description of the error.
61  const base::string16& details() const { return details_; }
62
63  // A short message describing the error (1 line).
64  const base::string16& short_description() const { return short_description_; }
65
66 private:
67  SSLErrorInfo(const base::string16& details,
68               const base::string16& short_description);
69
70  base::string16 details_;
71  base::string16 short_description_;
72};
73
74#endif  // CHROME_BROWSER_SSL_SSL_ERROR_INFO_H_
75