From 19d30190e20f1c0b2848ea4043aaf9c31e48e386 Mon Sep 17 00:00:00 2001
From: Guillaume Mazoyer <respawneral@gmail.com>
Date: Tue, 5 Aug 2014 16:34:22 +0200
Subject: Add config.defaults.php to set default configuration options.

The defaults can be overriden in the config.php file but some of
them are fine as defaults. This will help in having a config.php
file as short as we can.

Also move utils.php to the includes directory.
---
 config.php.example           | 33 +--------------
 execute.php                  |  1 +
 includes/config.defaults.php | 56 +++++++++++++++++++++++++
 includes/utils.php           | 99 ++++++++++++++++++++++++++++++++++++++++++++
 index.php                    |  1 +
 routers/bird.php             |  2 +-
 routers/cisco.php            |  2 +-
 routers/juniper.php          |  2 +-
 routers/quagga.php           |  2 +-
 routers/router.php           |  3 +-
 utils.php                    | 99 --------------------------------------------
 11 files changed, 164 insertions(+), 136 deletions(-)
 create mode 100644 includes/config.defaults.php
 create mode 100644 includes/utils.php
 delete mode 100644 utils.php

diff --git a/config.php.example b/config.php.example
index fc093c1..13f7b33 100644
--- a/config.php.example
+++ b/config.php.example
@@ -6,48 +6,17 @@ $config['contact']['mail'] = 'support@example.com';
 
 // Frontpage configuration
 
-// CSS to use
-$config['frontpage']['css'] = 'css/style.css';
 // Title of the page
 $config['frontpage']['title'] = 'Looking Glass';
-$config['frontpage']['show_title'] = true;
-// Logo to display
+// Logo to display (remove it to not display any logo)
 $config['frontpage']['image'] = 'logo.png';
-// Show visitor IP address
-$config['frontpage']['show_visitor_ip'] = true;
 // Disclaimer to inform people using the looking glass
 $config['frontpage']['disclaimer'] = 'This is a disclaimer!';
-// Frontpage order you can use: routers, commands, parameters, buttons
-$config['frontpage']['order'] = array('routers', 'commands', 'parameters', 'buttons');
-
-// Logs file when commands will be written
-$config['misc']['logs'] = '/var/log/looking-glass.log';
-
-// Allow private ASN
-$config['misc']['allow_private_asn'] = false;
 
 // Things to remove from the output (PHP compatible regex)
 $config['filters'][] = '/(client1|client2)/';
 $config['filters'][] = '/^NotToShow/';
 
-// Documentation for commands (must be HTML)
-
-// Documentation for the 'show route' query
-$config['doc']['bgp']['query'] = 'Show the best routes to a given destination.';
-$config['doc']['bgp']['parameter'] = 'The parameter must be a valid destination. Destination means an IPv4/IPv6 address or a subnet. Masks are also accepted as part of a valid IPv4/IPv6 address.<br />Please note that some routers always need a mask to be given when looking for an IPv6 address.<br /><br />Example of valid arguments:<br /><ul><li>10.1.1.1</li><li>172.16.0.0/12</li><li>2001:db8:1337::42</li><li>2001:db8::/32</li>';
-// Documentation for the 'as-path-regex' query
-$config['doc']['as-path-regex']['query'] = 'Show the routes matching the given AS path regular expression.';
-$config['doc']['as-path-regex']['parameter'] = 'The parameter must be a valid AS path regular expression.<br />Please note that these expression can change depending on the router and its software.<br /><br />Here are some examples:<ul><li><strong>Juniper</strong> - ^AS1 AS2 .*$</li><li><strong>Cisco</strong> - ^AS1_</li><li><strong>BIRD</strong> - AS1 AS2 AS3 &hellip; ASZ</li></ul><br />You may find some help with the following link:<br /><ul><li><a href="http://www.juniper.net/techpubs/en_US/junos13.3/topics/reference/command-summary/show-route-aspath-regex.html" title="Juniper Documentation">Juniper Documentation</a></li><li><a href="http://www.cisco.com/c/en/us/support/docs/ip/border-gateway-protocol-bgp/26634-bgp-toc.html#asregexp" title="Cisco Documentation">Cisco Documentation</a></li><li><a href="http://bird.network.cz/?get_doc&f=bird-5.html" title="BIRD Documentation">BIRD Documentation</a> (search for bgpmask)</li></ul>';
-// Documentation for the 'as' query
-$config['doc']['as']['query'] = 'Show the routes received from a given AS number.';
-$config['doc']['as']['parameter'] = 'The parameter must be a valid 16-bit or 32-bit autonomous system number.<br />Be careful, 32-bit ASN are not handled by old routers or old router softwares.<br />Unless specified, private ASN will be considered as invalid.<br /><br />Example of valid argument:<br /><ul><li>15169</li><li>29467</li></ul>';
-// Documentation for the 'ping' query
-$config['doc']['ping']['query'] = 'Send 10 pings to the given destination.';
-$config['doc']['ping']['parameter'] = 'The parameter must be an IPv4/IPv6 address (without mask) or a fully qualified domain name.<br /><br />Example of valid arguments:<br /><ul><li>10.1.1.1</li><li>2001:db8:1337::42</li><li>example.com</li></ul>';
-// Documentation for the 'traceroute' query
-$config['doc']['traceroute']['query'] = 'Display the path to a given destination.';
-$config['doc']['traceroute']['parameter'] = 'The parameter must be an IPv4/IPv6 address (without mask) or a fully qualified domain name.<br /><br />Example of valid arguments:<br /><ul><li>10.1.1.1</li><li>2001:db8:1337::42</li><li>example.com</li></ul>';
-
 // Routers definitions
 
 // Authentication based on SSH or Telnet with password
diff --git a/execute.php b/execute.php
index cd94ae6..330e070 100644
--- a/execute.php
+++ b/execute.php
@@ -19,6 +19,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
  */
 
+require_once 'includes/config.defaults.php';
 require_once 'config.php';
 require_once 'routers/router.php';
 
diff --git a/includes/config.defaults.php b/includes/config.defaults.php
new file mode 100644
index 0000000..895810b
--- /dev/null
+++ b/includes/config.defaults.php
@@ -0,0 +1,56 @@
+<?php
+
+$config = array (
+
+  // Frontpage configuration
+  'frontpage' => array (
+    // CSS to use
+    'css' => 'css/style.css',
+    // Title of the page
+    'title' => 'Looking Glass',
+    'show_title' => true,
+    // Show visitor IP address
+    'show_visitor_ip' => true,
+    // Frontpage order you can use: routers, commands, parameters, buttons
+    'order' => array('routers', 'commands', 'parameters', 'buttons')
+  ),
+
+  // Misc
+  'misc' => array(
+    // Logs file when commands will be written
+    'logs' => '/var/log/looking-glass.log',
+    // Allow private ASN
+    'allow_private_asn' => false
+  ),
+
+  // Documentation (must be HTML)
+  'doc' => array (
+    // Documentation for the 'show route' query
+    'bgp' => array(
+      'query' => 'Show the best routes to a given destination.',
+      'parameter' => 'The parameter must be a valid destination. Destination means an IPv4/IPv6 address or a subnet. Masks are also accepted as part of a valid IPv4/IPv6 address.<br />Please note that some routers always need a mask to be given when looking for an IPv6 address.<br /><br />Example of valid arguments:<br /><ul><li>10.1.1.1</li><li>172.16.0.0/12</li><li>2001:db8:1337::42</li><li>2001:db8::/32</li>'
+    ),
+    // Documentation for the 'as-path-regex' query
+    'as-path-regex' => array(
+      'query' => 'Show the routes matching the given AS path regular expression.',
+      'parameter' => 'The parameter must be a valid AS path regular expression.<br />Please note that these expression can change depending on the router and its software.<br /><br />Here are some examples:<ul><li><strong>Juniper</strong> - ^AS1 AS2 .*$</li><li><strong>Cisco</strong> - ^AS1_</li><li><strong>BIRD</strong> - AS1 AS2 AS3 &hellip; ASZ</li></ul><br />You may find some help with the following link:<br /><ul><li><a href="http://www.juniper.net/techpubs/en_US/junos13.3/topics/reference/command-summary/show-route-aspath-regex.html" title="Juniper Documentation">Juniper Documentation</a></li><li><a href="http://www.cisco.com/c/en/us/support/docs/ip/border-gateway-protocol-bgp/26634-bgp-toc.html#asregexp" title="Cisco Documentation">Cisco Documentation</a></li><li><a href="http://bird.network.cz/?get_doc&f=bird-5.html" title="BIRD Documentation">BIRD Documentation</a> (search for bgpmask)</li></ul>'
+    ),
+    // Documentation for the 'as' query
+    'as' => array(
+      'query' => 'Show the routes received from a given AS number.',
+      'parameter' => 'The parameter must be a valid 16-bit or 32-bit autonomous system number.<br />Be careful, 32-bit ASN are not handled by old routers or old router softwares.<br />Unless specified, private ASN will be considered as invalid.<br /><br />Example of valid argument:<br /><ul><li>15169</li><li>29467</li></ul>'
+    ),
+    // Documentation for the 'ping' query
+    'ping' => array(
+      'query' => 'Send 10 pings to the given destination.',
+      'parameter' => 'The parameter must be an IPv4/IPv6 address (without mask) or a fully qualified domain name.<br /><br />Example of valid arguments:<br /><ul><li>10.1.1.1</li><li>2001:db8:1337::42</li><li>example.com</li></ul>'
+    ),
+    // Documentation for the 'traceroute' query
+    'traceroute' => array(
+      'query' => 'Display the path to a given destination.',
+      'parameter' => 'The parameter must be an IPv4/IPv6 address (without mask) or a fully qualified domain name.<br /><br />Example of valid arguments:<br /><ul><li>10.1.1.1</li><li>2001:db8:1337::42</li><li>example.com</li></ul>'
+    )
+  )
+);
+
+// End of config.defaults..php
diff --git a/includes/utils.php b/includes/utils.php
new file mode 100644
index 0000000..b6fc061
--- /dev/null
+++ b/includes/utils.php
@@ -0,0 +1,99 @@
+<?php
+
+/*
+ * Looking Glass - An easy to deploy Looking Glass
+ * Copyright (C) 2014 Guillaume Mazoyer <gmazoyer@gravitons.in>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+ */
+
+require_once 'config.php';
+
+function match_ipv4($ip, $ip_only = true) {
+  if (strrpos($ip, '/') && !$ip_only)  {
+    $ip_and_mask = explode('/', $ip, 2);
+
+    return filter_var($ip_and_mask[0], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) &&
+      filter_var($ip_and_mask[1], FILTER_VALIDATE_INT);
+  } else {
+    return filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4);
+  }
+}
+
+function match_ipv6($ip, $ip_only = true) {
+  if (strrpos($ip, '/') && !$ip_only)  {
+    $ip_and_mask = explode('/', $ip, 2);
+
+    return filter_var($ip_and_mask[0], FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) &&
+      filter_var($ip_and_mask[1], FILTER_VALIDATE_INT);
+  } else {
+    return filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);
+  }
+}
+
+function match_fqdn($fqdn) {
+  $regex = '/(?=^.{4,255}$)(^((?!-)[a-zA-Z0-9-]{1,63}(?<!-)\.)+[a-zA-Z]{2,63}$)/';
+
+  if ((preg_match($regex, $fqdn) === false) ||
+      (preg_match($regex, $fqdn) === 0)) {
+    return false;
+  } else {
+    return true;
+  }
+}
+
+function match_as($as) {
+  global $config;
+
+  $options_wide_range = array(
+    'options' => array('min_range' => 1, 'max_range' => 4294967294)
+  );
+  $options_16bit_private = array(
+    'options' => array( 'min_range' => 64512, 'max_range' => 65534)
+  );
+  $options_32bit_private = array(
+    'options' => array('min_range' => 4200000000, 'max_range' => 4294967294)
+  );
+
+  if (!filter_var($as, FILTER_VALIDATE_INT, $options_wide_range)) {
+    return false;
+  }
+
+  if (filter_var($as, FILTER_VALIDATE_INT, $options_16bit_private)) {
+    return isset($config['misc']['allow_private_asn']) &&
+      $config['misc']['allow_private_asn'] == true;
+  }
+
+  if (filter_var($as, FILTER_VALIDATE_INT, $options_32bit_private)) {
+    return isset($config['misc']['allow_private_asn']) &&
+      $config['misc']['allow_private_asn'] == true;
+  }
+
+  return true;
+}
+
+function match_aspath_regex($aspath_regex) {
+  // TODO: validate a regex with a regex?
+  return true;
+}
+
+function log_to_file($log) {
+  global $config;
+
+  $log = '['.date("Y-m-d H:i:s").'] '.$log."\n";
+  file_put_contents($config['misc']['logs'], $log, FILE_APPEND | LOCK_EX);
+}
+
+// End of utils.php
diff --git a/index.php b/index.php
index b78699d..04d9904 100644
--- a/index.php
+++ b/index.php
@@ -18,6 +18,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
  */
 
+require_once 'includes/config.defaults.php';
 require_once 'config.php';
 
 final class LookingGlass {
diff --git a/routers/bird.php b/routers/bird.php
index 4abd788..420cd42 100644
--- a/routers/bird.php
+++ b/routers/bird.php
@@ -20,7 +20,7 @@
  */
 
 require_once 'router.php';
-require_once 'utils.php';
+require_once 'includes/utils.php';
 
 final class Bird extends Router {
   protected function build_commands($command, $parameters) {
diff --git a/routers/cisco.php b/routers/cisco.php
index fa010e1..593b293 100644
--- a/routers/cisco.php
+++ b/routers/cisco.php
@@ -20,7 +20,7 @@
  */
 
 require_once 'router.php';
-require_once 'utils.php';
+require_once 'includes/utils.php';
 
 final class Cisco extends Router {
   protected function build_commands($command, $parameters) {
diff --git a/routers/juniper.php b/routers/juniper.php
index 30d783b..99da240 100644
--- a/routers/juniper.php
+++ b/routers/juniper.php
@@ -20,7 +20,7 @@
  */
 
 require_once 'router.php';
-require_once 'utils.php';
+require_once 'includes/utils.php';
 
 final class Juniper extends Router {
   protected function build_commands($command, $parameters) {
diff --git a/routers/quagga.php b/routers/quagga.php
index c905a5e..9f6426d 100644
--- a/routers/quagga.php
+++ b/routers/quagga.php
@@ -20,7 +20,7 @@
  */
 
 require_once 'router.php';
-require_once 'utils.php';
+require_once 'includes/utils.php';
 
 final class Quagga extends Router {
   protected function build_commands($command, $parameters) {
diff --git a/routers/router.php b/routers/router.php
index f1d2427..03336ac 100644
--- a/routers/router.php
+++ b/routers/router.php
@@ -19,12 +19,13 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
  */
 
+require_once 'includes/config.defaults.php';
 require_once 'config.php';
 require_once 'bird.php';
 require_once 'cisco.php';
 require_once 'juniper.php';
 require_once 'quagga.php';
-require_once 'utils.php';
+require_once 'includes/utils.php';
 require_once 'auth/authentication.php';
 
 abstract class Router {
diff --git a/utils.php b/utils.php
deleted file mode 100644
index b6fc061..0000000
--- a/utils.php
+++ /dev/null
@@ -1,99 +0,0 @@
-<?php
-
-/*
- * Looking Glass - An easy to deploy Looking Glass
- * Copyright (C) 2014 Guillaume Mazoyer <gmazoyer@gravitons.in>
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program 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 General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
- */
-
-require_once 'config.php';
-
-function match_ipv4($ip, $ip_only = true) {
-  if (strrpos($ip, '/') && !$ip_only)  {
-    $ip_and_mask = explode('/', $ip, 2);
-
-    return filter_var($ip_and_mask[0], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) &&
-      filter_var($ip_and_mask[1], FILTER_VALIDATE_INT);
-  } else {
-    return filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4);
-  }
-}
-
-function match_ipv6($ip, $ip_only = true) {
-  if (strrpos($ip, '/') && !$ip_only)  {
-    $ip_and_mask = explode('/', $ip, 2);
-
-    return filter_var($ip_and_mask[0], FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) &&
-      filter_var($ip_and_mask[1], FILTER_VALIDATE_INT);
-  } else {
-    return filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);
-  }
-}
-
-function match_fqdn($fqdn) {
-  $regex = '/(?=^.{4,255}$)(^((?!-)[a-zA-Z0-9-]{1,63}(?<!-)\.)+[a-zA-Z]{2,63}$)/';
-
-  if ((preg_match($regex, $fqdn) === false) ||
-      (preg_match($regex, $fqdn) === 0)) {
-    return false;
-  } else {
-    return true;
-  }
-}
-
-function match_as($as) {
-  global $config;
-
-  $options_wide_range = array(
-    'options' => array('min_range' => 1, 'max_range' => 4294967294)
-  );
-  $options_16bit_private = array(
-    'options' => array( 'min_range' => 64512, 'max_range' => 65534)
-  );
-  $options_32bit_private = array(
-    'options' => array('min_range' => 4200000000, 'max_range' => 4294967294)
-  );
-
-  if (!filter_var($as, FILTER_VALIDATE_INT, $options_wide_range)) {
-    return false;
-  }
-
-  if (filter_var($as, FILTER_VALIDATE_INT, $options_16bit_private)) {
-    return isset($config['misc']['allow_private_asn']) &&
-      $config['misc']['allow_private_asn'] == true;
-  }
-
-  if (filter_var($as, FILTER_VALIDATE_INT, $options_32bit_private)) {
-    return isset($config['misc']['allow_private_asn']) &&
-      $config['misc']['allow_private_asn'] == true;
-  }
-
-  return true;
-}
-
-function match_aspath_regex($aspath_regex) {
-  // TODO: validate a regex with a regex?
-  return true;
-}
-
-function log_to_file($log) {
-  global $config;
-
-  $log = '['.date("Y-m-d H:i:s").'] '.$log."\n";
-  file_put_contents($config['misc']['logs'], $log, FILE_APPEND | LOCK_EX);
-}
-
-// End of utils.php
-- 
cgit v1.2.3