Kea  1.9.9-git
shared_network_parser.cc
Go to the documentation of this file.
1 // Copyright (C) 2017-2021 Internet Systems Consortium, Inc. ("ISC")
2 //
3 // This Source Code Form is subject to the terms of the Mozilla Public
4 // License, v. 2.0. If a copy of the MPL was not distributed with this
5 // file, You can obtain one at http://mozilla.org/MPL/2.0/.
6 
7 #include <config.h>
8 
9 #include <asiolink/io_address.h>
10 #include <cc/data.h>
11 #include <dhcpsrv/cfgmgr.h>
12 #include <dhcpsrv/cfg_option.h>
18 #include <dhcpsrv/shared_network.h>
19 #include <boost/pointer_cast.hpp>
20 #include <string>
21 
22 using namespace isc::asiolink;
23 using namespace isc::data;
24 using namespace isc::util;
25 
26 namespace isc {
27 namespace dhcp {
28 
29 SharedNetwork4Parser::SharedNetwork4Parser(bool check_iface)
30  : check_iface_(check_iface) {
31 }
32 
35  SharedNetwork4Ptr shared_network;
36  try {
37 
38  // Check parameters.
40  shared_network_data);
41 
42  // Make sure that the network name has been specified. The name is required
43  // to create a SharedNetwork4 object.
44  std::string name = getString(shared_network_data, "name");
45  shared_network.reset(new SharedNetwork4(name));
46 
47  // Move from reservation mode to new reservations flags.
48  ElementPtr mutable_params;
49  mutable_params = boost::const_pointer_cast<Element>(shared_network_data);
51 
52  // Parse parameters common to all Network derivations.
53  NetworkPtr network = boost::dynamic_pointer_cast<Network>(shared_network);
54  parseCommon(mutable_params, network);
55 
56  // interface is an optional parameter
57  if (shared_network_data->contains("interface")) {
58  std::string iface = getString(shared_network_data, "interface");
59  if (!iface.empty()) {
60  if (check_iface_ && !IfaceMgr::instance().getIface(iface)) {
62  shared_network_data->get("interface");
64  "Specified network interface name " << iface
65  << " for shared network " << name
66  << " is not present in the system ("
67  << error->getPosition() << ")");
68  }
69  shared_network->setIface(iface);
70  }
71  }
72 
73  if (shared_network_data->contains("option-data")) {
74  auto json = shared_network_data->get("option-data");
75  // Create parser instance for option-data.
76  CfgOptionPtr cfg_option = shared_network->getCfgOption();
77  OptionDataListParser parser(AF_INET);
78  parser.parse(cfg_option, json);
79  }
80 
81  if (shared_network_data->contains("subnet4")) {
82  auto json = shared_network_data->get("subnet4");
83 
84  // Create parser instance of subnet4.
86  Subnet4Collection subnets;
87  parser.parse(subnets, json);
88 
89  // Add all returned subnets into shared network.
90  for (auto subnet = subnets.cbegin(); subnet != subnets.cend();
91  ++subnet) {
92  shared_network->add(*subnet);
93  }
94  }
95 
96  if (shared_network_data->contains("match-client-id")) {
97  shared_network->setMatchClientId(getBoolean(shared_network_data,
98  "match-client-id"));
99  }
100 
101  if (shared_network_data->contains("authoritative")) {
102  shared_network->setAuthoritative(getBoolean(shared_network_data,
103  "authoritative"));
104  }
105 
106  // Set next-server
107  if (shared_network_data->contains("next-server")) {
108  std::string next_server;
109  try {
110  next_server = getString(shared_network_data, "next-server");
111  if (!next_server.empty()) {
112  shared_network->setSiaddr(IOAddress(next_server));
113  }
114  } catch (...) {
115  ConstElementPtr next = shared_network_data->get("next-server");
116  std::string pos;
117  if (next) {
118  pos = next->getPosition().str();
119  } else {
120  pos = shared_network_data->getPosition().str();
121  }
122  isc_throw(DhcpConfigError, "invalid parameter next-server : "
123  << next_server << "(" << pos << ")");
124  }
125  }
126 
127  // Set server-hostname.
128  if (shared_network_data->contains("server-hostname")) {
129  std::string sname = getString(shared_network_data, "server-hostname");
130  if (!sname.empty()) {
131  if (sname.length() >= Pkt4::MAX_SNAME_LEN) {
132  ConstElementPtr error = shared_network_data->get("server-hostname");
133  isc_throw(DhcpConfigError, "server-hostname must be at most "
134  << Pkt4::MAX_SNAME_LEN - 1 << " bytes long, it is "
135  << sname.length() << " ("
136  << error->getPosition() << ")");
137  }
138  shared_network->setSname(sname);
139  }
140  }
141 
142  // Set boot-file-name.
143  if (shared_network_data->contains("boot-file-name")) {
144  std::string filename = getString(shared_network_data, "boot-file-name");
145  if (!filename.empty()) {
146  if (filename.length() > Pkt4::MAX_FILE_LEN) {
147  ConstElementPtr error = shared_network_data->get("boot-file-name");
148  isc_throw(DhcpConfigError, "boot-file-name must be at most "
149  << Pkt4::MAX_FILE_LEN - 1 << " bytes long, it is "
150  << filename.length() << " ("
151  << error->getPosition() << ")");
152  }
153  shared_network->setFilename(filename);
154  }
155  }
156 
157  if (shared_network_data->contains("client-class")) {
158  std::string client_class = getString(shared_network_data, "client-class");
159  if (!client_class.empty()) {
160  shared_network->allowClientClass(client_class);
161  }
162  }
163 
164  ConstElementPtr user_context = shared_network_data->get("user-context");
165  if (user_context) {
166  shared_network->setContext(user_context);
167  }
168 
169  if (shared_network_data->contains("require-client-classes")) {
170  const std::vector<data::ElementPtr>& class_list =
171  shared_network_data->get("require-client-classes")->listValue();
172  for (auto cclass = class_list.cbegin();
173  cclass != class_list.cend(); ++cclass) {
174  if (((*cclass)->getType() != Element::string) ||
175  (*cclass)->stringValue().empty()) {
176  isc_throw(DhcpConfigError, "invalid class name ("
177  << (*cclass)->getPosition() << ")");
178  }
179  shared_network->requireClientClass((*cclass)->stringValue());
180  }
181  }
182 
183  if (shared_network_data->contains("relay")) {
184  auto relay_parms = shared_network_data->get("relay");
185  if (relay_parms) {
186  RelayInfoParser parser(Option::V4);
187  Network::RelayInfoPtr relay_info(new Network::RelayInfo());
188  parser.parse(relay_info, relay_parms);
189  shared_network->setRelayInfo(*relay_info);
190  }
191  }
192 
193  parseTeePercents(shared_network_data, network);
194 
195  // Parse DDNS parameters
196  parseDdnsParams(shared_network_data, network);
197 
198  // Parse lease cache parameters
199  parseCacheParams(shared_network_data, network);
200  } catch (const DhcpConfigError&) {
201  // Position was already added
202  throw;
203  } catch (const std::exception& ex) {
204  isc_throw(DhcpConfigError, ex.what() << " ("
205  << shared_network_data->getPosition() << ")");
206  }
207 
208  // In order to take advantage of the dynamic inheritance of global
209  // parameters to a shared network we need to set a callback function
210  // for each shared network to allow for fetching global parameters.
211  shared_network->setFetchGlobalsFn([]() -> ConstElementPtr {
212  return (CfgMgr::instance().getCurrentCfg()->getConfiguredGlobals());
213  });
214 
215  return (shared_network);
216 }
217 
219  : check_iface_(check_iface) {
220 }
221 
224  SharedNetwork6Ptr shared_network;
225  std::string name;
226  try {
227  // Check parameters.
229  shared_network_data);
230 
231  // Make sure that the network name has been specified. The name is required
232  // to create a SharedNetwork6 object.
233  std::string name = getString(shared_network_data, "name");
234  shared_network.reset(new SharedNetwork6(name));
235 
236  // Move from reservation mode to new reservations flags.
237  ElementPtr mutable_params;
238  mutable_params = boost::const_pointer_cast<Element>(shared_network_data);
240 
241  // Parse parameters common to all Network derivations.
242  NetworkPtr network = boost::dynamic_pointer_cast<Network>(shared_network);
243  parseCommon(mutable_params, network);
244 
245  // preferred-lifetime
246  shared_network->setPreferred(parseIntTriplet(shared_network_data,
247  "preferred-lifetime"));
248 
249  // Get interface-id option content. For now we support string
250  // representation only
251  Optional<std::string> ifaceid;
252  if (shared_network_data->contains("interface-id")) {
253  ifaceid = getString(shared_network_data, "interface-id");
254  }
255 
256  // Interface is an optional parameter
257  Optional<std::string> iface;
258  if (shared_network_data->contains("interface")) {
259  iface = getString(shared_network_data, "interface");
260  }
261 
262  // Specifying both interface for locally reachable subnets and
263  // interface id for relays is mutually exclusive. Need to test for
264  // this condition.
265  if (!ifaceid.unspecified() && !iface.unspecified() && !ifaceid.empty() &&
266  !iface.empty()) {
268  "parser error: interface (defined for locally reachable "
269  "subnets) and interface-id (defined for subnets reachable"
270  " via relays) cannot be defined at the same time for "
271  "shared network " << name << "("
272  << shared_network_data->getPosition() << ")");
273  }
274 
275  // Configure interface-id for remote interfaces, if defined
276  if (!ifaceid.unspecified() && !ifaceid.empty()) {
277  std::string ifaceid_value = ifaceid.get();
278  OptionBuffer tmp(ifaceid_value.begin(), ifaceid_value.end());
280  shared_network->setInterfaceId(opt);
281  }
282 
283  // Set interface name. If it is defined, then subnets are available
284  // directly over specified network interface.
285  if (!iface.unspecified() && !iface.empty()) {
286  if (check_iface_ && !IfaceMgr::instance().getIface(iface)) {
287  ConstElementPtr error = shared_network_data->get("interface");
289  "Specified network interface name " << iface
290  << " for shared network " << name
291  << " is not present in the system ("
292  << error->getPosition() << ")");
293  }
294  shared_network->setIface(iface);
295  }
296 
297  if (shared_network_data->contains("rapid-commit")) {
298  shared_network->setRapidCommit(getBoolean(shared_network_data,
299  "rapid-commit"));
300  }
301 
302  if (shared_network_data->contains("option-data")) {
303  auto json = shared_network_data->get("option-data");
304  // Create parser instance for option-data.
305  CfgOptionPtr cfg_option = shared_network->getCfgOption();
306  OptionDataListParser parser(AF_INET6);
307  parser.parse(cfg_option, json);
308  }
309 
310  if (shared_network_data->contains("client-class")) {
311  std::string client_class = getString(shared_network_data, "client-class");
312  if (!client_class.empty()) {
313  shared_network->allowClientClass(client_class);
314  }
315  }
316 
317  ConstElementPtr user_context = shared_network_data->get("user-context");
318  if (user_context) {
319  shared_network->setContext(user_context);
320  }
321 
322  if (shared_network_data->contains("require-client-classes")) {
323  const std::vector<data::ElementPtr>& class_list =
324  shared_network_data->get("require-client-classes")->listValue();
325  for (auto cclass = class_list.cbegin();
326  cclass != class_list.cend(); ++cclass) {
327  if (((*cclass)->getType() != Element::string) ||
328  (*cclass)->stringValue().empty()) {
329  isc_throw(DhcpConfigError, "invalid class name ("
330  << (*cclass)->getPosition() << ")");
331  }
332  shared_network->requireClientClass((*cclass)->stringValue());
333  }
334  }
335 
336  if (shared_network_data->contains("subnet6")) {
337  auto json = shared_network_data->get("subnet6");
338 
339  // Create parser instance of subnet6.
341  Subnet6Collection subnets;
342  parser.parse(subnets, json);
343 
344  // Add all returned subnets into shared network.
345  for (auto subnet = subnets.cbegin(); subnet != subnets.cend();
346  ++subnet) {
347  shared_network->add(*subnet);
348  }
349  }
350 
351  if (shared_network_data->contains("relay")) {
352  auto relay_parms = shared_network_data->get("relay");
353  if (relay_parms) {
354  RelayInfoParser parser(Option::V6);
355  Network::RelayInfoPtr relay_info(new Network::RelayInfo());
356  parser.parse(relay_info, relay_parms);
357  shared_network->setRelayInfo(*relay_info);
358  }
359  }
360 
361  parseTeePercents(shared_network_data, network);
362 
363  // Parse DDNS parameters
364  parseDdnsParams(shared_network_data, network);
365 
366  // Parse lease cache parameters
367  parseCacheParams(shared_network_data, network);
368  } catch (const std::exception& ex) {
369  isc_throw(DhcpConfigError, ex.what() << " ("
370  << shared_network_data->getPosition() << ")");
371  }
372 
373  // In order to take advantage of the dynamic inheritance of global
374  // parameters to a shared network we need to set a callback function
375  // for each shared network which can be used to fetch global parameters.
376  shared_network->setFetchGlobalsFn([]() -> ConstElementPtr {
377  return (CfgMgr::instance().getCurrentCfg()->getConfiguredGlobals());
378  });
379 
380  return (shared_network);
381 }
382 
383 } // end of namespace isc::dhcp
384 } // end of namespace isc
void parseDdnsParams(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses parameters pertaining to DDNS behavior.
static const size_t MAX_SNAME_LEN
length of the SNAME field in DHCPv4 message
Definition: pkt4.h:44
IfacePtr getIface(int ifindex)
Returns interface specified interface index.
Definition: iface_mgr.cc:875
static bool getBoolean(isc::data::ConstElementPtr scope, const std::string &name)
Returns a boolean parameter from a scope.
void unspecified(bool unspecified)
Modifies the flag that indicates whether the value is specified or unspecified.
Definition: optional.h:121
void parse(const CfgOptionPtr &cfg, isc::data::ConstElementPtr option_data_list)
Parses a list of options, instantiates them and stores in cfg.
boost::shared_ptr< CfgOption > CfgOptionPtr
Non-const pointer.
Definition: cfg_option.h:706
size_t parse(SrvConfigPtr cfg, data::ConstElementPtr subnets_list)
parses contents of the list
bool check_iface_
Check if the specified interface exists in the system.
boost::shared_ptr< Network > NetworkPtr
Pointer to the Network object.
Definition: network.h:40
this class parses a list of DHCP6 subnets
Definition: dhcp_parsers.h:793
static const isc::data::SimpleKeywords SHARED_NETWORK6_PARAMETERS
This table defines all shared network parameters for DHCPv6.
const dhcp::Triplet< uint32_t > parseIntTriplet(const data::ConstElementPtr &scope, const std::string &name)
Parses an integer triplet.
boost::shared_ptr< Network::RelayInfo > RelayInfoPtr
Pointer to the RelayInfo structure.
Definition: network.h:180
void parseCommon(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses common parameters.
static const size_t MAX_FILE_LEN
length of the FILE field in DHCPv4 message
Definition: pkt4.h:47
static CfgMgr & instance()
returns a single instance of Configuration Manager
Definition: cfgmgr.cc:25
static const isc::data::SimpleKeywords SHARED_NETWORK4_PARAMETERS
This table defines all shared network parameters for DHCPv4.
boost::shared_ptr< Option > OptionPtr
Definition: option.h:36
void parseCacheParams(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses parameters related to lease cache settings.
boost::shared_ptr< Element > ElementPtr
Definition: data.h:20
bool check_iface_
Check if the specified interface exists in the system.
this class parses list of DHCP4 subnets
Definition: dhcp_parsers.h:579
std::vector< uint8_t > OptionBuffer
buffer types used in DHCP code.
Definition: option.h:24
Shared network holding IPv4 subnets.
Holds optional information about relay.
Definition: network.h:132
#define isc_throw(type, stream)
A shortcut macro to insert known values into exception arguments.
SharedNetwork6Ptr parse(const data::ConstElementPtr &shared_network_data)
Parses shared configuration information for IPv6 shared network.
Definition: edns.h:19
boost::multi_index_container< Subnet4Ptr, boost::multi_index::indexed_by< boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetSubnetIdIndexTag >, boost::multi_index::const_mem_fun< Subnet, SubnetID,&Subnet::getID > >, boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetPrefixIndexTag >, boost::multi_index::const_mem_fun< Subnet, std::string,&Subnet::toText > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SubnetServerIdIndexTag >, boost::multi_index::const_mem_fun< Network4, asiolink::IOAddress,&Network4::getServerId > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SubnetModificationTimeIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime,&data::BaseStampedElement::getModificationTime > > >> Subnet4Collection
A collection of Subnet4 objects.
Definition: subnet.h:867
parser for additional relay information
Definition: dhcp_parsers.h:405
To be removed. Please use ConfigError instead.
void parseTeePercents(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses parameters related to "percent" timers settings.
Common interface representing a network to which the DHCP clients are connected.
Definition: network.h:122
static void moveReservationMode(isc::data::ElementPtr config)
Moves deprecated reservation-mode parameter to new reservations flags.
boost::shared_ptr< const Element > ConstElementPtr
Definition: data.h:23
static std::string getString(isc::data::ConstElementPtr scope, const std::string &name)
Returns a string parameter from a scope.
Parser for option data values within a subnet.
boost::shared_ptr< SharedNetwork6 > SharedNetwork6Ptr
Pointer to SharedNetwork6 object.
virtual const char * what() const
Returns a C-style character string of the cause of the exception.
size_t parse(SrvConfigPtr cfg, data::ConstElementPtr subnets_list)
parses contents of the list
boost::shared_ptr< SharedNetwork4 > SharedNetwork4Ptr
Pointer to SharedNetwork4 object.
boost::multi_index_container< Subnet6Ptr, boost::multi_index::indexed_by< boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetSubnetIdIndexTag >, boost::multi_index::const_mem_fun< Subnet, SubnetID,&Subnet::getID > >, boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetPrefixIndexTag >, boost::multi_index::const_mem_fun< Subnet, std::string,&Subnet::toText > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SubnetModificationTimeIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime,&data::BaseStampedElement::getModificationTime > > >> Subnet6Collection
A collection of Subnet6 objects.
Definition: subnet.h:914
bool empty() const
Checks if the encapsulated value is empty.
Definition: optional.h:138
Defines the logger used by the top-level component of kea-dhcp-ddns.
T get() const
Retrieves the encapsulated value.
Definition: optional.h:112
SharedNetwork6Parser(bool check_iface=true)
Constructor.
void parse(const isc::dhcp::Network::RelayInfoPtr &relay_info, isc::data::ConstElementPtr relay_elem)
parses the actual relay parameters
static IfaceMgr & instance()
IfaceMgr is a singleton class.
Definition: iface_mgr.cc:53
static void checkKeywords(const SimpleKeywords &keywords, isc::data::ConstElementPtr scope)
Checks acceptable keywords with their expected type.
The Element class represents a piece of data, used by the command channel and configuration parts...
Definition: data.h:66
Shared network holding IPv6 subnets.
SharedNetwork4Ptr parse(const data::ConstElementPtr &shared_network_data)
Parses shared configuration information for IPv4 shared network.