safe-bag.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2013-2021 Regents of the University of California.
4  *
5  * This file is part of ndn-cxx library (NDN C++ library with eXperimental eXtensions).
6  *
7  * ndn-cxx library is free software: you can redistribute it and/or modify it under the
8  * terms of the GNU Lesser General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later version.
10  *
11  * ndn-cxx library is distributed in the hope that it will be useful, but WITHOUT ANY
12  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
13  * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
14  *
15  * You should have received copies of the GNU General Public License and GNU Lesser
16  * General Public License along with ndn-cxx, e.g., in COPYING.md file. If not, see
17  * <http://www.gnu.org/licenses/>.
18  *
19  * See AUTHORS.md for complete list of ndn-cxx authors and contributors.
20  *
21  * @author Zhiyi Zhang <dreamerbarrychang@gmail.com>
22  */
23 
24 #ifndef NDN_CXX_SECURITY_SAFE_BAG_HPP
25 #define NDN_CXX_SECURITY_SAFE_BAG_HPP
26 
27 #include "ndn-cxx/data.hpp"
30 
31 namespace ndn {
32 namespace security {
33 
38 class SafeBag
39 {
40 public:
45 
49  explicit
50  SafeBag(const Block& wire);
51 
58  SafeBag(const Data& certificate, span<const uint8_t> encryptedKey);
59 
68  [[deprecated("use the constructor taking a span<>")]]
69  SafeBag(const Data& certificate,
70  const uint8_t* encryptedKey,
71  size_t encryptedKeyLen);
72 
73 public:
77  template<encoding::Tag TAG>
78  size_t
79  wireEncode(EncodingImpl<TAG>& encoder) const;
80 
84  const Block&
85  wireEncode() const;
86 
90  void
91  wireDecode(const Block& wire);
92 
93 public:
97  const Data&
99  {
100  return m_certificate;
101  }
102 
106  span<const uint8_t>
108  {
109  return m_encryptedKey;
110  }
111 
112 private:
113  Data m_certificate;
114  Buffer m_encryptedKey;
115 
116  mutable Block m_wire;
117 };
118 
120 
121 } // namespace security
122 } // namespace ndn
123 
124 #endif // NDN_CXX_SECURITY_SAFE_BAG_HPP
Represents a TLV element of the NDN packet format.
Definition: block.hpp:45
General-purpose automatically managed/resized buffer.
Definition: buffer.hpp:42
Represents a Data packet.
Definition: data.hpp:38
A secured container for sensitive information (certificate, private key)
Definition: safe-bag.hpp:39
span< const uint8_t > getEncryptedKey() const
Get the private key in PKCS #8 format from safe bag.
Definition: safe-bag.hpp:107
void wireDecode(const Block &wire)
Decode the input from wire format.
Definition: safe-bag.cpp:89
SafeBag()
Create a new empty SafeBag object.
const Data & getCertificate() const
Get the certificate data packet from safe bag.
Definition: safe-bag.hpp:98
const Block & wireEncode() const
Encode to a wire format.
Definition: safe-bag.cpp:76
#define NDN_CXX_DECLARE_WIRE_ENCODE_INSTANTIATIONS(ClassName)
Definition: data.cpp:25