pfSense

 * services_unbound.php

 *

 * part of pfSense (https://www.pfsense.org)

 * Copyright (c) 2004-2013 BSD Perimeter

 * Copyright (c) 2014-2022 Rubicon Communications, LLC (Netgate)

 * Copyright (c) 2014 Warren Baker (warren@pfsense.org)

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 *

 * http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 */

##|*IDENT=page-services-dnsresolver

##|*NAME=Services: DNS Resolver

##|*DESCR=Allow access to the 'Services: DNS Resolver' page.

##|-PRIV

require_once("pfsense-utils.inc");

require_once("system.inc");

init_config_arr(array('unbound', 'hosts'));

$a_domainOverrides = &$a_unboundcfg['domainoverrides'];

if (isset($a_unboundcfg['enable'])) {

	$pconfig['enable'] = true;

}

if (isset($a_unboundcfg['enablessl'])) {

if (isset($a_unboundcfg['strictout'])) {

if (isset($a_unboundcfg['dnssec'])) {

	$pconfig['dnssec'] = true;

}

if (isset($a_unboundcfg['python'])) {

if (isset($a_unboundcfg['forwarding'])) {

	$pconfig['forwarding'] = true;

}

if (isset($a_unboundcfg['forward_tls_upstream'])) {

if (isset($a_unboundcfg['regdhcp'])) {

	$pconfig['regdhcp'] = true;

}

if (isset($a_unboundcfg['regdhcpstatic'])) {

	$pconfig['regdhcpstatic'] = true;

}

if (isset($a_unboundcfg['regovpnclients'])) {

$pconfig['python_order'] = $a_unboundcfg['python_order'];

$pconfig['port'] = $a_unboundcfg['port'];

$pconfig['tlsport'] = $a_unboundcfg['tlsport'];

$pconfig['sslcertref'] = $a_unboundcfg['sslcertref'];

$pconfig['custom_options'] = base64_decode($a_unboundcfg['custom_options']);

if (empty($a_unboundcfg['active_interface'])) {

	$pconfig['active_interface'] = array();

} else {

	$pconfig['active_interface'] = explode(",", $a_unboundcfg['active_interface']);

}

if (empty($a_unboundcfg['outgoing_interface'])) {

	$pconfig['outgoing_interface'] = array();

} else {

	$pconfig['outgoing_interface'] = explode(",", $a_unboundcfg['outgoing_interface']);

}

if (empty($a_unboundcfg['system_domain_local_zone_type'])) {

init_config_arr(array('cert'));

$certs_available = false;

		}

	}

	if (isset($pconfig['enablessl']) && (!$certs_available || empty($pconfig['sslcertref']))) {

	// forwarding mode requires having valid DNS servers

		foreach (get_dns_nameservers(false, true) as $dns_server) {

			}

		if ($founddns == false) {

			$input_errors[] = gettext("At least one DNS server must be specified under System > General Setup to enable Forwarding mode.");

		}

	}

	if (empty($pconfig['active_interface'])) {

	} elseif (($config['system']['dnslocalhost'] != 'remote') && (!in_array("lo0", $pconfig['active_interface']) && !in_array("all", $pconfig['active_interface']))) {

		$input_errors[] = gettext("This system is configured to use the DNS Resolver as its DNS server, so Localhost or All must be selected in Network Interfaces.");

	if (empty($pconfig['outgoing_interface'])) {

	if ($pconfig['port'] && !is_port($pconfig['port'])) {

	if ($pconfig['tlsport'] && !is_port($pconfig['tlsport'])) {

		$input_errors[] = gettext("A valid SSL/TLS port number must be specified.");

	if (is_array($pconfig['active_interface']) && !empty($pconfig['active_interface'])) {

	if ((isset($pconfig['regdhcp']) || isset($pconfig['regdhcpstatic'])) && !is_dhcp_server_enabled()) {

	if (($pconfig['system_domain_local_zone_type'] == "redirect") && isset($pconfig['regdhcp'])) {

	$display_custom_options = $pconfig['custom_options'];

	if (is_array($pconfig['outgoing_interface']) && !empty($pconfig['outgoing_interface'])) {

	$test_output = array();

	if (!$input_errors) {

		$a_unboundcfg['enablessl'] = isset($pconfig['enablessl']);

		$a_unboundcfg['port'] = $pconfig['port'];

		$a_unboundcfg['tlsport'] = $pconfig['tlsport'];

		$a_unboundcfg['sslcertref'] = $pconfig['sslcertref'];

		$a_unboundcfg['strictout'] = isset($pconfig['strictout']);

		$a_unboundcfg['dnssec'] = isset($pconfig['dnssec']);

		$a_unboundcfg['forwarding'] = isset($pconfig['forwarding']);

		$a_unboundcfg['forward_tls_upstream'] = isset($pconfig['forward_tls_upstream']);

		$a_unboundcfg['regdhcp'] = isset($pconfig['regdhcp']);

		$a_unboundcfg['regovpnclients'] = isset($pconfig['regovpnclients']);

		$a_unboundcfg['active_interface'] = $pconfig['active_interface'];

	}

}

if ($pconfig['custom_options']) {

if ($_POST['act'] == "del") {

			write_config(gettext("Host override deleted from DNS Resolver."));

			mark_subsystem_dirty('unbound');

	} elseif ($_POST['type'] == 'doverride') {

			write_config(gettext("Domain override deleted from DNS Resolver."));

			mark_subsystem_dirty('unbound');

}

function build_if_list($selectedifs) {

	$interface_addresses = get_possible_listen_ips(true);

	$iflist['options']['all']	= gettext("All");

	if (empty($selectedifs) || empty($selectedifs[0]) || in_array("all", $selectedifs)) {

		array_push($iflist['selected'], "all");

	}

		if ($selectedifs && in_array($laddr, $selectedifs)) {

			array_push($iflist['selected'], $laddr);

		}

	}

$pgtitle = array(gettext("Services"), gettext("DNS Resolver"), gettext("General Settings"));

$pglinks = array("", "@self", "@self");

$shortcut_section = "resolver";

include_once("head.inc");

if ($input_errors) {

	print_input_errors($input_errors);

}

if ($_POST['apply']) {

}

if (is_subsystem_dirty('unbound')) {

	print_apply_box(gettext("The DNS resolver configuration has been changed.") . "<br />" . gettext("The changes must be applied for them to take effect."));

}

$tab_array = array();

$tab_array[] = array(gettext("General Settings"), true, "services_unbound.php");

$tab_array[] = array(gettext("Access Lists"), false, "/services_unbound_acls.php");

	'number',

	$pconfig['port'],

))->setHelp('The port used for responding to DNS queries. It should normally be left blank unless another service needs to bind to TCP/UDP port 53.');

$section->addInput(new Form_Checkbox(

		cert_build_list('cert', 'IPsec')

	))->setHelp('The server certificate to use for SSL/TLS service. The CA chain will be determined automatically.');

	'tlsport',

	'SSL/TLS Listen Port',

	$pconfig['tlsport'],

	['placeholder' => '853']

$activeiflist = build_if_list($pconfig['active_interface']);

	'*Network Interfaces',

	$activeiflist['selected'],

	true

))->addClass('general', 'resizable')->setHelp('Interface IPs used by the DNS Resolver for responding to queries from clients. If an interface has both IPv4 and IPv6 IPs, both are used. Queries to other interface IPs not selected below are discarded. ' .

			'The default behavior is to respond to queries on every available IPv4 and IPv6 address.');

$outiflist = build_if_list($pconfig['outgoing_interface']);

$section->addInput(new Form_Select(

	'*Outgoing Network Interfaces',

	$outiflist['selected'],

	true

))->addClass('general', 'resizable')->setHelp('Utilize different network interface(s) that the DNS Resolver will use to send queries to authoritative servers and receive their replies. By default all interfaces are used.');

$section->addInput(new Form_Checkbox(

$section->addInput(new Form_Select(

	'*System Domain Local Zone Type',

	$pconfig['system_domain_local_zone_type'],

	unbound_local_zone_types()

))->setHelp('The local-zone type used for the %1$s system domain (System | General Setup | Domain).  Transparent is the default.', $g['product_label']);

$section->addInput(new Form_Checkbox(

$section->addInput(new Form_Checkbox(

$section->addInput(new Form_Checkbox(

))->setHelp('If this option is set, DNS queries will be forwarded to the upstream DNS servers defined under'.

					' %1$sSystem > General Setup%2$s or those obtained via dynamic ' .

$section->addInput(new Form_Checkbox(

	'Use SSL/TLS for outgoing DNS Queries to Forwarding Servers',

	$pconfig['forward_tls_upstream']

$section->addInput(new Form_Checkbox(

))->setHelp('If this option is set, then machines that specify their hostname when requesting an IPv4 DHCP lease will be registered'.

					' in the DNS Resolver so that their name can be resolved.'.

	    				' Note that this will cause the Resolver to reload and flush its resolution cache whenever a DHCP lease is issued.'.

					' The domain in %1$sSystem &gt; General Setup%2$s should also be set to the proper value.','<a href="system.php">','</a>');

))->setHelp('If this option is set, then DHCP static mappings will be registered in the DNS Resolver, so that their name can be resolved. '.

$section->addInput(new Form_Checkbox(

))->setHelp(sprintf('If this option is set, then the common name (CN) of connected OpenVPN clients will be ' .

$btnadv = new Form_Button(

	'Custom options',

	null,

);

$btnadv->setAttribute('type','button')->addClass('btn-info btn-sm');

	'Display Custom Options',

));

$section->addInput(new Form_Textarea (

	'custom_options',

))->setHelp('Enter any additional configuration parameters to add to the DNS Resolver configuration here, separated by a newline.');

<script type="text/javascript">

//<![CDATA[

events.push(function() {

	// Show advanced custom options ==============================================

			showadvcustom = <?=($customoptions ? 'true' : 'false');?>;

		} else {

	// If the enable checkbox is not checked, hide all inputs

		var hide = ! $('#enable').prop('checked');

		hideMultiClass('general', hide);

		hideCheckbox('strictout', hide);

		hideCheckbox('dnssec', hide);

		hideCheckbox('regovpnclients', hide);

		hideInput('btnadvcustom', hide);

	}

	// Un-hide additional controls

	});

	// When 'enable' is clicked, disable/enable the following hide inputs

	$('#enable').click(function() {

		hideGeneral();

	});

	if ($('#custom_options').val().length == 0) {

		hideInput('custom_options', true);

	hideGeneral();

	show_advcustom(true);

	// When the Python Module 'enable' is clicked, disable/enable the Python Module options

});

	<div class="panel-heading"><h2 class="panel-title"><?=gettext("Host Overrides")?></h2></div>

	<div class="panel-body table-responsive">

		<table class="table table-striped table-hover table-condensed sortable-theme-bootstrap table-rowdblclickedit" data-sortable>

			<thead>

				<tr>

					<th><?=gettext("Host")?></th>

					<th><?=gettext("Parent domain of host")?></th>

					<th><?=gettext("IP to return for host")?></th>

					<th><?=gettext("Description")?></th>

					<th><?=gettext("Actions")?></th>

				</tr>

			</thead>

				<tr>

					<td>

						<?=$hostent['host']?>

					</td>

						<?=$hostent['domain']?>

					</td>

						<?=$hostent['ip']?>

					</td>

						<a class="fa fa-pencil"	title="<?=gettext('Edit host override')?>" href="services_unbound_host_edit.php?id=<?=$i?>"></a>

						<a class="fa fa-trash"	title="<?=gettext('Delete host override')?>" href="services_unbound.php?type=host&amp;act=del&amp;id=<?=$i?>" usepost></a>

					</td>

				</tr>

	foreach (array_get_path($hostent, 'aliases/item', []) as $alias):

?>

				<tr>

					<td>

						<?=$alias['host']?>

					</td>

						<?=$alias['domain']?>

					</td>

						<?=gettext("Alias for ");?><?=$hostent['host'] ? $hostent['host'] . '.' . $hostent['domain'] : $hostent['domain']?>

					</td>

						<i class="fa fa-angle-double-right text-info"></i>

						<?=htmlspecialchars($alias['description'])?>

						<a class="fa fa-pencil"	title="<?=gettext('Edit host override')?>" 	href="services_unbound_host_edit.php?id=<?=$i?>"></a>

					</td>

				</tr>

<?php

	endforeach;

	$i++;

<span class="help-block">

	IPv4 or IPv6 address should automatically be returned by the resolver. Standard and also non-standard names and parent domains

	can be entered, such as 'test', 'nas.home.arpa', 'mycompany.localdomain', '1.168.192.in-addr.arpa', or 'somesite.com'. Any lookup attempt for

	the host will automatically return the given IP address, and the usual lookup server for the domain will not be queried for

	the host's records.

</span>

<nav class="action-buttons">

	<a href="services_unbound_host_edit.php" class="btn btn-sm btn-success">

		<i class="fa fa-plus icon-embed-btn"></i>

		<?=gettext('Add')?>

</nav>