validity-period.cpp
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 
25 
26 namespace ndn {
27 namespace security {
28 
29 BOOST_CONCEPT_ASSERT((boost::EqualityComparable<ValidityPeriod>));
30 BOOST_CONCEPT_ASSERT((WireEncodable<ValidityPeriod>));
31 BOOST_CONCEPT_ASSERT((WireEncodableWithEncodingBuffer<ValidityPeriod>));
32 BOOST_CONCEPT_ASSERT((WireDecodable<ValidityPeriod>));
33 static_assert(std::is_base_of<tlv::Error, ValidityPeriod::Error>::value,
34  "ValidityPeriod::Error must inherit from tlv::Error");
35 
36 static const size_t ISO_DATETIME_SIZE = 15;
37 static const size_t NOT_BEFORE_OFFSET = 0;
38 static const size_t NOT_AFTER_OFFSET = 1;
39 
40 using boost::chrono::time_point_cast;
41 
43  : ValidityPeriod(time::system_clock::TimePoint() + 1_ns,
44  time::system_clock::TimePoint())
45 {
46 }
47 
49  const time::system_clock::TimePoint& notAfter)
50  : m_notBefore(time_point_cast<TimePoint::duration>(notBefore + TimePoint::duration(1) -
51  time::system_clock::TimePoint::duration(1)))
52  , m_notAfter(time_point_cast<TimePoint::duration>(notAfter))
53 {
54 }
55 
57 {
58  wireDecode(block);
59 }
60 
61 template<encoding::Tag TAG>
62 size_t
64 {
65  size_t totalLength = 0;
66 
67  totalLength += prependStringBlock(encoder, tlv::NotAfter, time::toIsoString(m_notAfter));
68  totalLength += prependStringBlock(encoder, tlv::NotBefore, time::toIsoString(m_notBefore));
69 
70  totalLength += encoder.prependVarNumber(totalLength);
71  totalLength += encoder.prependVarNumber(tlv::ValidityPeriod);
72  return totalLength;
73 }
74 
76 
77 const Block&
79 {
80  if (m_wire.hasWire())
81  return m_wire;
82 
83  EncodingEstimator estimator;
84  size_t estimatedSize = wireEncode(estimator);
85 
86  EncodingBuffer buffer(estimatedSize, 0);
87  wireEncode(buffer);
88 
89  m_wire = buffer.block();
90  m_wire.parse();
91 
92  return m_wire;
93 }
94 
95 void
97 {
98  if (!wire.hasWire()) {
99  NDN_THROW(Error("The supplied block does not contain wire format"));
100  }
101 
102  m_wire = wire;
103  m_wire.parse();
104 
105  if (m_wire.type() != tlv::ValidityPeriod)
106  NDN_THROW(Error("ValidityPeriod", m_wire.type()));
107 
108  if (m_wire.elements_size() != 2)
109  NDN_THROW(Error("ValidityPeriod does not have two sub-TLVs"));
110 
111  if (m_wire.elements()[NOT_BEFORE_OFFSET].type() != tlv::NotBefore ||
112  m_wire.elements()[NOT_BEFORE_OFFSET].value_size() != ISO_DATETIME_SIZE ||
113  m_wire.elements()[NOT_AFTER_OFFSET].type() != tlv::NotAfter ||
114  m_wire.elements()[NOT_AFTER_OFFSET].value_size() != ISO_DATETIME_SIZE) {
115  NDN_THROW(Error("Invalid NotBefore or NotAfter field"));
116  }
117 
118  try {
119  m_notBefore = time_point_cast<TimePoint::duration>(
120  time::fromIsoString(readString(m_wire.elements()[NOT_BEFORE_OFFSET])));
121  m_notAfter = time_point_cast<TimePoint::duration>(
122  time::fromIsoString(readString(m_wire.elements()[NOT_AFTER_OFFSET])));
123  }
124  catch (const std::bad_cast&) {
125  NDN_THROW(Error("Invalid date format in NOT-BEFORE or NOT-AFTER field"));
126  }
127 }
128 
131  const time::system_clock::TimePoint& notAfter)
132 {
133  m_wire.reset();
134  m_notBefore = time_point_cast<TimePoint::duration>(notBefore + TimePoint::duration(1) -
136  m_notAfter = time_point_cast<TimePoint::duration>(notAfter);
137  return *this;
138 }
139 
140 std::pair<time::system_clock::TimePoint, time::system_clock::TimePoint>
142 {
143  return std::make_pair(m_notBefore, m_notAfter);
144 }
145 
146 bool
148 {
149  return m_notBefore <= now && now <= m_notAfter;
150 }
151 
152 std::ostream&
153 operator<<(std::ostream& os, const ValidityPeriod& period)
154 {
155  os << "(" << time::toIsoString(period.getPeriod().first)
156  << ", " << time::toIsoString(period.getPeriod().second) << ")";
157  return os;
158 }
159 
160 } // namespace security
161 } // namespace ndn
Represents a TLV element of the NDN packet format.
Definition: block.hpp:45
size_t elements_size() const
Equivalent to elements().size()
Definition: block.hpp:426
uint32_t type() const
Return the TLV-TYPE of the Block.
Definition: block.hpp:285
bool hasWire() const noexcept
Check if the Block contains a fully encoded wire representation.
Definition: block.hpp:241
void reset() noexcept
Reset the Block to a default-constructed state.
Definition: block.cpp:265
const element_container & elements() const
Get container of sub-elements.
Definition: block.hpp:402
void parse() const
Parse TLV-VALUE into sub-elements.
Definition: block.cpp:341
Represents a ValidityPeriod TLV element.
ValidityPeriod()
Set validity period [UNIX epoch + 1 nanosecond, UNIX epoch] that is always invalid.
bool isValid(const time::system_clock::TimePoint &now=time::system_clock::now()) const
Check if now falls within the validity period.
void wireDecode(const Block &wire)
Decode ValidityPeriod from TLV block.
std::pair< time::system_clock::TimePoint, time::system_clock::TimePoint > getPeriod() const
Get the stored validity period.
ValidityPeriod & setPeriod(const time::system_clock::TimePoint &notBefore, const time::system_clock::TimePoint &notAfter)
Set validity period [notBefore, notAfter].
const Block & wireEncode() const
Encode ValidityPeriod into TLV block.
time_point TimePoint
Definition: time.hpp:203
#define NDN_CXX_DEFINE_WIRE_ENCODE_INSTANTIATIONS(ClassName)
#define NDN_THROW(e)
Definition: exception.hpp:61
EncodingImpl< EstimatorTag > EncodingEstimator
size_t prependStringBlock(EncodingImpl< TAG > &encoder, uint32_t type, const std::string &value)
Prepend a TLV element containing a string.
std::string readString(const Block &block)
Read TLV-VALUE of a TLV element as a string.
EncodingImpl< EncoderTag > EncodingBuffer
std::ostream & operator<<(std::ostream &os, const AdditionalDescription &desc)
std::string toIsoString(const system_clock::time_point &timePoint)
Convert to the ISO 8601 string representation, basic format (YYYYMMDDTHHMMSS,fffffffff).
Definition: time.cpp:143
boost::chrono::duration< Rep, Period > duration
Definition: time.hpp:34
system_clock::time_point fromIsoString(const std::string &isoString)
Convert from the ISO 8601 basic string format (YYYYMMDDTHHMMSS,fffffffff) to the internal time format...
Definition: time.cpp:168
@ ValidityPeriod
Definition: tlv.hpp:147
@ NotAfter
Definition: tlv.hpp:149
@ NotBefore
Definition: tlv.hpp:148
Definition: data.cpp:25