key-handle.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2013-2020 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 
22 #ifndef NDN_SECURITY_TPM_KEY_HANDLE_HPP
23 #define NDN_SECURITY_TPM_KEY_HANDLE_HPP
24 
25 #include "ndn-cxx/name.hpp"
27 
28 namespace ndn {
29 namespace security {
30 namespace tpm {
31 
37 class KeyHandle : noncopyable
38 {
39 public:
40  class Error : public std::runtime_error
41  {
42  public:
43  using std::runtime_error::runtime_error;
44  };
45 
46 public:
47  virtual
48  ~KeyHandle();
49 
54  sign(DigestAlgorithm digestAlgorithm, const InputBuffers& bufs) const;
55 
60  sign(DigestAlgorithm digestAlgorithm, const uint8_t* buf, size_t size) const;
61 
65  bool
66  verify(DigestAlgorithm digestAlgorithm, const InputBuffers& bufs,
67  const uint8_t* sig, size_t sigLen) const;
68 
72  bool
73  verify(DigestAlgorithm digestAlgorithm, const uint8_t* buf, size_t bufLen,
74  const uint8_t* sig, size_t sigLen) const;
75 
80  decrypt(const uint8_t* cipherText, size_t cipherTextLen) const;
81 
86  derivePublicKey() const;
87 
88  Name
89  getKeyName() const
90  {
91  return m_keyName;
92  }
93 
94  void
95  setKeyName(const Name& keyName)
96  {
97  m_keyName = keyName;
98  }
99 
100 private:
101  virtual ConstBufferPtr
102  doSign(DigestAlgorithm digestAlgorithm, const InputBuffers& bufs) const = 0;
103 
104  virtual bool
105  doVerify(DigestAlgorithm digestAlgorithm, const InputBuffers& bufs,
106  const uint8_t* sig, size_t sigLen) const = 0;
107 
108  virtual ConstBufferPtr
109  doDecrypt(const uint8_t* cipherText, size_t cipherTextLen) const = 0;
110 
111  virtual ConstBufferPtr
112  doDerivePublicKey() const = 0;
113 
114 private:
115  Name m_keyName;
116 };
117 
118 } // namespace tpm
119 } // namespace security
120 } // namespace ndn
121 
122 #endif // NDN_SECURITY_TPM_KEY_HANDLE_HPP
void setKeyName(const Name &keyName)
Definition: key-handle.hpp:95
ConstBufferPtr sign(DigestAlgorithm digestAlgorithm, const InputBuffers &bufs) const
Generate a digital signature for bufs using this key with digestAlgorithm.
Definition: key-handle.cpp:31
Definition: data.cpp:26
ConstBufferPtr derivePublicKey() const
Definition: key-handle.cpp:63
ConstBufferPtr decrypt(const uint8_t *cipherText, size_t cipherTextLen) const
Return plain text content decrypted from cipherText using this key.
Definition: key-handle.cpp:57
bool verify(DigestAlgorithm digestAlgorithm, const InputBuffers &bufs, const uint8_t *sig, size_t sigLen) const
Verify the signature sig for bufs using this key and digestAlgorithm.
Definition: key-handle.cpp:43
Abstraction of TPM key handle.
Definition: key-handle.hpp:37
size_t sigLen
const uint8_t * sig
Represents an absolute name.
Definition: name.hpp:44
InputBuffers bufs
shared_ptr< const Buffer > ConstBufferPtr
Definition: buffer.hpp:126