NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
back-end-osx.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2013-2019 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_IMPL_BACK_END_OSX_HPP
23 #define NDN_SECURITY_TPM_IMPL_BACK_END_OSX_HPP
24 
26 
27 #ifndef NDN_CXX_HAVE_OSX_FRAMEWORKS
28 #error "This file should not be compiled ..."
29 #endif
30 
32 
33 namespace ndn {
34 namespace security {
35 namespace tpm {
36 
40 class BackEndOsx final : public BackEnd
41 {
42 public:
48  explicit
49  BackEndOsx(const std::string& location = "");
50 
51  ~BackEndOsx() final;
52 
53  static const std::string&
54  getScheme();
55 
56 public: // management
57  bool
58  isTerminalMode() const final;
59 
60  void
61  setTerminalMode(bool isTerminal) const final;
62 
63  bool
64  isTpmLocked() const final;
65 
66  bool
67  unlockTpm(const char* pw, size_t pwLen) const final;
68 
69 public: // crypto transformation
73  static ConstBufferPtr
74  sign(const KeyRefOsx& key, DigestAlgorithm digestAlgorithm, const uint8_t* buf, size_t size);
75 
76  static ConstBufferPtr
77  decrypt(const KeyRefOsx& key, const uint8_t* cipherText, size_t cipherSize);
78 
79  static ConstBufferPtr
80  derivePublicKey(const KeyRefOsx& key);
81 
82 private: // inherited from tpm::BackEnd
83  bool
84  doHasKey(const Name& keyName) const final;
85 
86  unique_ptr<KeyHandle>
87  doGetKeyHandle(const Name& keyName) const final;
88 
89  unique_ptr<KeyHandle>
90  doCreateKey(const Name& identityName, const KeyParams& params) final;
91 
92  void
93  doDeleteKey(const Name& keyName) final;
94 
96  doExportKey(const Name& keyName, const char* pw, size_t pwLen) final;
97 
98  void
99  doImportKey(const Name& keyName, const uint8_t* buf, size_t size, const char* pw, size_t pwLen) final;
100 
101  void
102  doImportKey(const Name& keyName, shared_ptr<transform::PrivateKey> key) final;
103 
104 private:
105  class Impl;
106  const unique_ptr<Impl> m_impl;
107 };
108 
109 } // namespace tpm
110 } // namespace security
111 } // namespace ndn
112 
113 #endif // NDN_SECURITY_TPM_IMPL_BACK_END_OSX_HPP
buf
const uint8_t * buf
Definition: verification-helpers.cpp:47
ndn::security::tpm::BackEndOsx::getScheme
static const std::string & getScheme()
Definition: back-end-osx.cpp:199
ndn::KeyParams
Base class for key parameters.
Definition: key-params.hpp:36
transform
ndn::security::tpm::BackEnd
Abstract interface for a TPM backend implementation.
Definition: back-end.hpp:37
key-ref-osx.hpp
ndn::DigestAlgorithm
DigestAlgorithm
Definition: security-common.hpp:96
ndn::security::tpm::KeyHandle
Abstraction of TPM key handle.
Definition: key-handle.hpp:38
ndn::detail::CFReleaser< SecKeyRef >
ndn::Name
Represents an absolute name.
Definition: name.hpp:44
ndn::security::tpm::BackEndOsx::isTerminalMode
bool isTerminalMode() const final
Check if the TPM is in terminal mode.
Definition: back-end-osx.cpp:206
ndn::security::tpm::BackEndOsx
The back-end implementation of TPM based on macOS Keychain Services.
Definition: back-end-osx.hpp:41
ndn::security::tpm::BackEndOsx::Impl
Definition: back-end-osx.cpp:41
ndn::security::tpm::BackEndOsx::BackEndOsx
BackEndOsx(const std::string &location="")
Create TPM backed based on macOS Keychain Services.
Definition: back-end-osx.cpp:185
back-end.hpp
ndn::security::tpm::BackEndOsx::unlockTpm
bool unlockTpm(const char *pw, size_t pwLen) const final
Unlock the TPM.
Definition: back-end-osx.cpp:230
ndn::security::tpm::BackEndOsx::isTpmLocked
bool isTpmLocked() const final
Check if the TPM is locked.
Definition: back-end-osx.cpp:219
ndn::security::tpm::BackEndOsx::setTerminalMode
void setTerminalMode(bool isTerminal) const final
Set the terminal mode of the TPM.
Definition: back-end-osx.cpp:212
ndn::security::tpm::BackEndOsx::decrypt
static ConstBufferPtr decrypt(const KeyRefOsx &key, const uint8_t *cipherText, size_t cipherSize)
Definition: back-end-osx.cpp:295
ndn::security::tpm::BackEndOsx::derivePublicKey
static ConstBufferPtr derivePublicKey(const KeyRefOsx &key)
Definition: back-end-osx.cpp:324
ndn::security::tpm::BackEndOsx::~BackEndOsx
~BackEndOsx() final
ndn::ConstBufferPtr
shared_ptr< const Buffer > ConstBufferPtr
Definition: buffer.hpp:126
ndn::security::tpm::BackEndOsx::sign
static ConstBufferPtr sign(const KeyRefOsx &key, DigestAlgorithm digestAlgorithm, const uint8_t *buf, size_t size)
Sign buf with key using digestAlgorithm.
Definition: back-end-osx.cpp:249
ndn::security::transform::PrivateKey
Abstraction of private key in crypto transformation.
Definition: private-key.hpp:39
ndn
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-strategy-choice-helper.hpp:34