certificate-bundle-fetcher.hpp

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2013-2024 Regents of the University of California.
 *
 * This file is part of ndn-cxx library (NDN C++ library with eXperimental eXtensions).
 *
 * ndn-cxx library is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free Software
 * Foundation, either version 3 of the License, or (at your option) any later version.
 *
 * ndn-cxx library is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
 * PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details.
 *
 * You should have received copies of the GNU General Public License and GNU Lesser
 * General Public License along with ndn-cxx, e.g., in COPYING.md file.  If not, see
 * <http://www.gnu.org/licenses/>.
 *
 * See AUTHORS.md for complete list of ndn-cxx authors and contributors.
 */
 
#ifndef NDN_CXX_SECURITY_CERTIFICATE_BUNDLE_FETCHER_HPP
#define NDN_CXX_SECURITY_CERTIFICATE_BUNDLE_FETCHER_HPP
 
#include "ndn-cxx/face.hpp"
#include "ndn-cxx/security/certificate-fetcher.hpp"
 
namespace ndn::security {
 
class CertificateBundleFetcher : public CertificateFetcher
{
public:
  explicit
  CertificateBundleFetcher(unique_ptr<CertificateFetcher> inner, Face& face);
 
  time::milliseconds
  getBundleInterestLifetime() const
  {
    return m_bundleInterestLifetime;
  }
 
  void
  setBundleInterestLifetime(time::milliseconds time)
  {
    m_bundleInterestLifetime = time;
  }
 
  void
  setCertificateStorage(CertificateStorage& certStorage) override;
 
protected:
  void
  doFetch(const shared_ptr<CertificateRequest>& certRequest,
          const shared_ptr<ValidationState>& state,
          const ValidationContinuation& continueValidation) override;
 
private:
  void
  fetchFirstBundleSegment(const Name& bundleNamePrefix,
                          const shared_ptr<CertificateRequest>& certRequest,
                          const shared_ptr<ValidationState>& state,
                          const ValidationContinuation& continueValidation);
 
  void
  fetchNextBundleSegment(const Name& fullBundleName, const name::Component& segmentNo,
                         const shared_ptr<CertificateRequest>& certRequest,
                         const shared_ptr<ValidationState>& state,
                         const ValidationContinuation& continueValidation);
 
  static Name
  deriveBundleName(const Name& name);
 
  void
  dataCallback(const Data& data, bool isSegmentZeroExpected,
               const shared_ptr<CertificateRequest>& certRequest, const shared_ptr<ValidationState>& state,
               const ValidationContinuation& continueValidation);
 
  void
  nackCallback(const lp::Nack& nack,
               const shared_ptr<CertificateRequest>& certRequest, const shared_ptr<ValidationState>& state,
               const ValidationContinuation& continueValidation, const Name& bundleName);
 
  void
  timeoutCallback(const shared_ptr<CertificateRequest>& certRequest, const shared_ptr<ValidationState>& state,
                  const ValidationContinuation& continueValidation, const Name& bundleName);
 
private:
  unique_ptr<CertificateFetcher> m_inner;
  Face& m_face;
  time::milliseconds m_bundleInterestLifetime = 1_s;
};
 
} // namespace ndn::security
 
#endif // NDN_CXX_SECURITY_CERTIFICATE_BUNDLE_FETCHER_HPP