Aktualizr
C++ SOTA Client
All Classes Namespaces Files Functions Variables Enumerations Enumerator Pages
aktualizr_secondary.cc
1 #include "aktualizr_secondary.h"
2 
3 #include "crypto/keymanager.h"
4 #include "logging/logging.h"
5 #include "update_agent.h"
6 #include "uptane/manifest.h"
7 #include "utilities/utils.h"
8 
9 #include <sys/types.h>
10 #include <memory>
11 
12 AktualizrSecondary::AktualizrSecondary(AktualizrSecondaryConfig config, std::shared_ptr<INvStorage> storage,
13  std::shared_ptr<KeyManager> key_mngr, std::shared_ptr<UpdateAgent> update_agent)
14  : config_(std::move(config)),
15  storage_(std::move(storage)),
16  keys_(std::move(key_mngr)),
17  update_agent_(std::move(update_agent)) {
18  if (!uptaneInitialize()) {
19  LOG_ERROR << "Failed to initialize";
20  return;
21  }
22 
23  manifest_issuer_ = std::make_shared<Uptane::ManifestIssuer>(keys_, ecu_serial_);
24 
25  if (hasPendingUpdate()) {
26  // TODO: refactor this to make it simpler as we don't need to persist/store
27  // an installation status of each ECU but store it just for a given secondary ECU
28  std::vector<Uptane::Target> installed_versions;
29  boost::optional<Uptane::Target> pending_target;
30  storage_->loadInstalledVersions(ecu_serial_.ToString(), nullptr, &pending_target);
31  data::InstallationResult install_res =
32  data::InstallationResult(data::ResultCode::Numeric::kUnknown, "Unknown installation error");
33  LOG_INFO << "Pending update found; attempting to apply it. Target hash: " << pending_target_.sha256Hash();
34 
35  if (!!pending_target) {
36  install_res = update_agent_->applyPendingInstall(*pending_target);
37 
38  if (install_res.result_code != data::ResultCode::Numeric::kNeedCompletion) {
39  storage_->saveEcuInstallationResult(ecu_serial_, install_res);
40  if (install_res.success) {
41  LOG_INFO << "Pending update has been successfully applied: " << pending_target_.sha256Hash();
42  storage_->saveInstalledVersion(ecu_serial_.ToString(), *pending_target, InstalledVersionUpdateMode::kCurrent);
43  } else {
44  LOG_ERROR << "Application of the pending update has failed: (" << install_res.result_code.toString() << ")"
45  << install_res.description;
46  storage_->saveInstalledVersion(ecu_serial_.ToString(), *pending_target, InstalledVersionUpdateMode::kNone);
47  director_repo_.dropTargets(*storage_);
48  }
49  } else {
50  LOG_INFO << "Pending update hasn't been applied because a reboot hasn't been detected";
51  }
52  }
53  }
54 }
55 
56 Uptane::EcuSerial AktualizrSecondary::getSerial() const { return ecu_serial_; }
57 
58 Uptane::HardwareIdentifier AktualizrSecondary::getHwId() const { return hardware_id_; }
59 
60 PublicKey AktualizrSecondary::getPublicKey() const { return keys_->UptanePublicKey(); }
61 
62 Uptane::Manifest AktualizrSecondary::getManifest() const {
63  Uptane::InstalledImageInfo installed_image_info;
64  Uptane::Manifest manifest;
65  if (update_agent_->getInstalledImageInfo(installed_image_info)) {
66  manifest = manifest_issuer_->assembleAndSignManifest(installed_image_info);
67  }
68 
69  return manifest;
70 }
71 
72 int32_t AktualizrSecondary::getRootVersion(bool director) const {
73  std::string root_meta;
74  if (!storage_->loadLatestRoot(&root_meta,
75  (director) ? Uptane::RepositoryType::Director() : Uptane::RepositoryType::Image())) {
76  LOG_ERROR << "Could not load root metadata";
77  return -1;
78  }
79 
80  return Uptane::extractVersionUntrusted(root_meta);
81 }
82 
83 bool AktualizrSecondary::putRoot(const std::string& root, bool director) {
84  (void)root;
85  (void)director;
86  LOG_ERROR << "putRootResp is not implemented yet";
87  return false;
88 }
89 
90 bool AktualizrSecondary::putMetadata(const Metadata& metadata) { return doFullVerification(metadata); }
91 
92 bool AktualizrSecondary::sendFirmware(const std::string& firmware) {
93  // TODO: how to handle the case when secondary is rebooted after metadata are received
94  if (!pending_target_.IsValid()) {
95  LOG_ERROR << "Aborting image download/receiving; no valid target found.";
96  return false;
97  }
98 
99  if (!update_agent_->download(pending_target_, firmware)) {
100  LOG_ERROR << "Failed to pull/store an update data";
101  pending_target_ = Uptane::Target::Unknown();
102  return false;
103  }
104 
105  return true;
106 }
107 
108 data::ResultCode::Numeric AktualizrSecondary::install(const std::string& target_name) {
109  // TODO: how to handle the case when secondary is rebooted after metadata are received
110  if (!pending_target_.IsValid()) {
111  LOG_ERROR << "Aborting target image installation; no valid target found.";
113  }
114 
115  if (pending_target_.filename() != target_name) {
116  LOG_ERROR << "name of the target to install and a name of the pending target do not match";
118  }
119 
120  auto install_result = update_agent_->install(pending_target_);
121 
122  switch (install_result) {
123  case data::ResultCode::Numeric::kOk: {
124  storage_->saveInstalledVersion(ecu_serial_.ToString(), pending_target_, InstalledVersionUpdateMode::kCurrent);
125  pending_target_ = Uptane::Target::Unknown();
126  LOG_INFO << "The target has been successfully installed: " << target_name;
127  break;
128  }
129  case data::ResultCode::Numeric::kNeedCompletion: {
130  storage_->saveInstalledVersion(ecu_serial_.ToString(), pending_target_, InstalledVersionUpdateMode::kPending);
131  LOG_INFO << "The target has been successfully installed, but a reboot is required to be applied: " << target_name;
132  break;
133  }
134  default: { LOG_INFO << "Failed to install the target: " << target_name; }
135  }
136 
137  return install_result;
138 }
139 
140 bool AktualizrSecondary::doFullVerification(const Metadata& metadata) {
141  // 5.4.4.2. Full verification https://uptane.github.io/uptane-standard/uptane-standard.html#metadata_verification
142 
143  // 1. Load and verify the current time or the most recent securely attested time.
144  //
145  // We trust the time that the given system/OS/ECU provides, In ECU We Trust :)
146  TimeStamp now(TimeStamp::Now());
147 
148  // 2. Download and check the Root metadata file from the Director repository, following the procedure in
149  // Section 5.4.4.3. DirectorRepository::updateMeta() method implements this verification step, certain steps are
150  // missing though. see the method source code for details
151 
152  // 3. NOT SUPPORTED: Download and check the Timestamp metadata file from the Director repository, following the
153  // procedure in Section 5.4.4.4.
154  // 4. NOT SUPPORTED: Download and check the Snapshot metadata file from the Director repository, following the
155  // procedure in Section 5.4.4.5.
156  //
157  // 5. Download and check the Targets metadata file from the Director repository, following the procedure in
158  // Section 5.4.4.6. DirectorRepository::updateMeta() method implements this verification step
159  //
160  // The followin steps of the Director's target metadata verification are missing in DirectorRepository::updateMeta()
161  // 6. If checking Targets metadata from the Director repository, verify that there are no delegations.
162  // 7. If checking Targets metadata from the Director repository, check that no ECU identifier is represented more
163  // than once.
164  if (!director_repo_.updateMeta(*storage_, metadata)) {
165  LOG_ERROR << "Failed to update director metadata: " << director_repo_.getLastException().what();
166  return false;
167  }
168 
169  // 6. Download and check the Root metadata file from the Image repository, following the procedure in Section 5.4.4.3.
170  // 7. Download and check the Timestamp metadata file from the Image repository, following the procedure in
171  // Section 5.4.4.4.
172  // 8. Download and check the Snapshot metadata file from the Image repository, following the procedure in
173  // Section 5.4.4.5.
174  // 9. Download and check the top-level Targets metadata file from the Image repository, following the procedure in
175  // Section 5.4.4.6.
176  if (!image_repo_.updateMeta(*storage_, metadata)) {
177  LOG_ERROR << "Failed to update image metadata: " << image_repo_.getLastException().what();
178  return false;
179  }
180 
181  // 10. Verify that Targets metadata from the Director and Image repositories match.
182  if (!director_repo_.matchTargetsWithImageTargets(*(image_repo_.getTargets()))) {
183  LOG_ERROR << "Targets metadata from the Director and Image repositories DOES NOT match ";
184  return false;
185  }
186 
187  auto targetsForThisEcu = director_repo_.getTargets(getSerial(), getHwId());
188 
189  if (targetsForThisEcu.size() != 1) {
190  LOG_ERROR << "Invalid number of targets (should be 1): " << targetsForThisEcu.size();
191  return false;
192  }
193 
194  if (!update_agent_->isTargetSupported(targetsForThisEcu[0])) {
195  LOG_ERROR << "The given target type is not supported: " << targetsForThisEcu[0].type();
196  return false;
197  }
198 
199  pending_target_ = targetsForThisEcu[0];
200 
201  return true;
202 }
203 
204 bool AktualizrSecondary::uptaneInitialize() {
205  if (keys_->generateUptaneKeyPair().size() == 0) {
206  LOG_ERROR << "Failed to generate uptane key pair";
207  return false;
208  }
209 
210  // from uptane/initialize.cc but we only take care of our own serial/hwid
211  EcuSerials ecu_serials;
212 
213  if (storage_->loadEcuSerials(&ecu_serials)) {
214  ecu_serial_ = ecu_serials[0].first;
215  hardware_id_ = ecu_serials[0].second;
216 
217  return true;
218  }
219 
220  std::string ecu_serial_local = config_.uptane.ecu_serial;
221  if (ecu_serial_local.empty()) {
222  ecu_serial_local = keys_->UptanePublicKey().KeyId();
223  }
224 
225  std::string ecu_hardware_id = config_.uptane.ecu_hardware_id;
226  if (ecu_hardware_id.empty()) {
227  ecu_hardware_id = Utils::getHostname();
228  if (ecu_hardware_id == "") {
229  return false;
230  }
231  }
232 
233  ecu_serials.emplace_back(Uptane::EcuSerial(ecu_serial_local), Uptane::HardwareIdentifier(ecu_hardware_id));
234  storage_->storeEcuSerials(ecu_serials);
235  ecu_serial_ = ecu_serials[0].first;
236  hardware_id_ = ecu_serials[0].second;
237 
238  return true;
239 }
data::InstallationResult
Definition: types.h:179
AktualizrSecondaryConfig
Definition: aktualizr_secondary_config.h:39
Uptane::HardwareIdentifier
Definition: tuf.h:143
TimeStamp
Definition: types.h:85
Uptane::InstalledImageInfo
Definition: tuf.h:132
Uptane::EcuSerial
Definition: tuf.h:174
PublicKey
Definition: crypto.h:26
data::ResultCode::Numeric::kInternalError
SWM Internal integrity error.
data::ResultCode::Numeric
Numeric
Definition: types.h:125
Metadata
Definition: aktualizr_secondary_metadata.h:8
Uptane::Manifest
Definition: manifest.h:13