Comment fixes.
[libdcp.git] / src / certificates.h
1 /*
2     Copyright (C) 2012-2014 Carl Hetherington <cth@carlh.net>
3
4     This program is free software; you can redistribute it and/or modify
5     it under the terms of the GNU General Public License as published by
6     the Free Software Foundation; either version 2 of the License, or
7     (at your option) any later version.
8
9     This program is distributed in the hope that it will be useful,
10     but WITHOUT ANY WARRANTY; without even the implied warranty of
11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12     GNU General Public License for more details.
13
14     You should have received a copy of the GNU General Public License
15     along with this program; if not, write to the Free Software
16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17
18 */
19
20 /** @file  src/certificates.h
21  *  @brief Certificate and CertificateChain classes.
22  */
23
24 #ifndef LIBDCP_CERTIFICATES_H
25 #define LIBDCP_CERTIFICATES_H
26
27 #undef X509_NAME
28 #include <openssl/x509.h>
29 #include <boost/shared_ptr.hpp>
30 #include <boost/filesystem.hpp>
31 #include <string>
32 #include <list>
33
34 class certificates;
35
36 namespace xmlpp {
37         class Element;
38 }
39
40 namespace dcp {
41
42 /** @class Certificate
43  *  @brief A wrapper for an X509 certificate.
44  *
45  *  This class can take a Certificate from a string or an OpenSSL X509 object.
46  */
47 class Certificate
48 {
49 public:
50         Certificate ()
51                 : _certificate (0)
52         {}
53
54         Certificate (std::string);
55         Certificate (X509 *);
56         Certificate (Certificate const &);
57         ~Certificate ();
58
59         Certificate& operator= (Certificate const &);
60
61         std::string certificate (bool with_begin_end = false) const;
62         std::string issuer () const;
63         std::string serial () const;
64         std::string subject () const;
65         std::string common_name () const;
66
67         X509* x509 () const {
68                 return _certificate;
69         }
70
71         RSA* public_key () const;
72
73         std::string thumbprint () const;
74
75 private:
76         void read_string (std::string);
77         
78         static std::string name_for_xml (X509_NAME *);
79         static std::string asn_to_utf8 (ASN1_STRING *);
80         static std::string get_name_part (X509_NAME *, int);
81
82         X509* _certificate;
83         mutable RSA* _public_key;
84 };
85
86 /** @class CertificateChain
87  *  @brief A chain of any number of certificates, from root to leaf.
88  */
89 class CertificateChain
90 {
91 public:
92         CertificateChain () {}
93
94         void add (boost::shared_ptr<const Certificate> c);
95         void remove (boost::shared_ptr<const Certificate> c);
96         void remove (int);
97
98         boost::shared_ptr<const Certificate> root () const;
99         boost::shared_ptr<const Certificate> leaf () const;
100
101         typedef std::list<boost::shared_ptr<const Certificate> > List;
102         
103         List leaf_to_root () const;
104         List root_to_leaf () const;
105
106         bool valid () const;
107         bool attempt_reorder ();
108
109 private:
110         friend class ::certificates;
111
112         List _certificates;
113 };
114
115 }
116
117 #endif