test_acl.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 2010, Digium, Inc.
 *
 * Mark Michelson <[email protected]>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*!
 * \file
 * \brief ACL unit tests
 *
 * \author Mark Michelson <[email protected]>
 *
 */

/*** MODULEINFO
   <depend>TEST_FRAMEWORK</depend>
   <support_level>core</support_level>
 ***/

#include "asterisk.h"

#include "asterisk/test.h"
#include "asterisk/acl.h"
#include "asterisk/module.h"
#include "asterisk/netsock2.h"
#include "asterisk/config.h"

AST_TEST_DEFINE(invalid_acl)
{
   const char * invalid_acls[] = {
      /* Negative netmask */
      "1.3.3.7/-1",
      /* Netmask too large */
      "1.3.3.7/33",
      /* Netmask waaaay too large */
      "1.3.3.7/92342348927389492307420",
      /* Netmask non-numeric */
      "1.3.3.7/California",
      /* Too many octets in Netmask */
      "1.3.3.7/255.255.255.255.255",
      /* Octets in IP address exceed 255 */
      "57.60.278.900/31",
      /* Octets in IP address exceed 255 and are negative */
      "400.32.201029.-6/24",
      /* Invalidly formatted IP address */
      "EGGSOFDEATH/4000",
      /* Too many octets in IP address */
      "33.4.7.8.3/300030",
      /* Too many octets in Netmask */
      "1.2.3.4/6.7.8.9.0",
      /* Too many octets in IP address */
      "3.1.4.1.5.9/3",
      /* IPv6 address has multiple double colons */
      "ff::ff::ff/3",
      /* IPv6 address is too long */
      "1234:5678:90ab:cdef:1234:5678:90ab:cdef:1234/56",
      /* IPv6 netmask is too large */
      "::ffff/129",
      /* IPv4-mapped IPv6 address has too few octets */
      "::ffff:255.255.255/128",
      /* Leading and trailing colons for IPv6 address */
      ":1234:/15",
      /* IPv6 address and IPv4 netmask */
      "fe80::1234/255.255.255.0",
   };

   enum ast_test_result_state res = AST_TEST_PASS;
   struct ast_ha *ha = NULL;
   int i;

   switch (cmd) {
   case TEST_INIT:
      info->name = "invalid_acl";
      info->category = "/main/acl/";
      info->summary = "Invalid ACL unit test";
      info->description =
         "Ensures that garbage ACL values are not accepted";
      return AST_TEST_NOT_RUN;
   case TEST_EXECUTE:
      break;
   }

   for (i = 0; i < ARRAY_LEN(invalid_acls); ++i) {
      int err = 0;
      ha = ast_append_ha("permit", invalid_acls[i], ha, &err);
      if (ha || !err) {
         ast_test_status_update(test, "ACL %s accepted even though it is total garbage.\n",
               invalid_acls[i]);
         if (ha) {
            ast_free_ha(ha);
         }
         res = AST_TEST_FAIL;
      }
   }

   return res;
}

struct acl {
   const char *host;
   const char *access;
};

/* These constants are defined for the sole purpose of being shorter
 * than their real names. It makes lines in this test quite a bit shorter
 */

#define TACL_A AST_SENSE_ALLOW
#define TACL_D AST_SENSE_DENY

static int build_ha(const struct acl *acl, size_t len, struct ast_ha **ha, const char *acl_name, int *err, struct ast_test *test, enum ast_test_result_state *res)
{
   size_t i;

   for (i = 0; i < len; ++i) {
      if (!(*ha = ast_append_ha(acl[i].access, acl[i].host, *ha, err))) {
         ast_test_status_update(test, "Failed to add rule %s with access %s to %s\n",
                      acl[i].host, acl[i].access, acl_name);
         *res = AST_TEST_FAIL;
         return -1;
      }
   }

   return 0;
}

AST_TEST_DEFINE(acl)
{
   struct acl permitallv4 = { "0.0.0.0/0", "permit" };
   struct acl denyallv4 = { "0.0.0.0/0", "deny" };
   struct acl permitallv6 = { "::/0", "permit" };
   struct acl denyallv6 = { "::/0", "deny" };

   struct acl acl1[] = {
      { "0.0.0.0/0.0.0.0", "deny" },
      { "10.0.0.0/255.0.0.0", "permit" },
      { "192.168.0.0/255.255.255.0", "permit" },
   };

   struct acl acl2[] = {
      { "10.0.0.0/8", "deny" },
      { "10.0.0.0/8", "permit" },
      { "10.0.0.0/16", "deny" },
      { "10.0.0.0/24", "permit" },
   };

   struct acl acl3[] = {
      { "::/0", "deny" },
      { "fe80::/64", "permit" },
   };

   struct acl acl4[] = {
      { "::/0", "deny" },
      { "fe80::/64", "permit" },
      { "fe80::ffff:0:0:0/80", "deny" },
      { "fe80::ffff:0:ffff:0/112", "permit" },
   };

   struct acl acl5[] = {
      { "0.0.0.0/0.0.0.0", "deny" },
      { "10.0.0.0/255.0.0.0,192.168.0.0/255.255.255.0", "permit" },
   };

   struct acl acl6[] = {
      { "10.0.0.0/8", "deny" },
      { "10.0.0.0/8", "permit" },
      { "10.0.0.0/16,!10.0.0.0/24", "deny" },
   };

   struct acl acl7[] = {
      { "::/0,!fe80::/64", "deny" },
      { "fe80::ffff:0:0:0/80", "deny" },
      { "fe80::ffff:0:ffff:0/112", "permit" },
   };

   struct {
      const char *test_address;
      int v4_permitall_result;
      int v4_denyall_result;
      int v6_permitall_result;
      int v6_denyall_result;
      int acl1_result;
      int acl2_result;
      int acl3_result;
      int acl4_result;
      int acl5_result;
      int acl6_result;
      int acl7_result;
   } acl_tests[] = {
      { "10.1.1.5",                  TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A },
      { "192.168.0.5",               TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A },
      { "192.168.1.5",               TACL_A, TACL_D, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A },
      { "10.0.0.1",                  TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A },
      { "10.0.10.10",                TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_D, TACL_A },
      { "172.16.0.1",                TACL_A, TACL_D, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A },
      { "fe80::1234",                TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A },
      { "fe80::ffff:1213:dead:beef", TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_D },
      { "fe80::ffff:0:ffff:ABCD",    TACL_A, TACL_A, TACL_A, TACL_D, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A, TACL_A },
   };

   struct ast_ha *permit_hav4 = NULL;
   struct ast_ha *deny_hav4 = NULL;
   struct ast_ha *permit_hav6 = NULL;
   struct ast_ha *deny_hav6 = NULL;
   struct ast_ha *ha1 = NULL;
   struct ast_ha *ha2 = NULL;
   struct ast_ha *ha3 = NULL;
   struct ast_ha *ha4 = NULL;
   struct ast_ha *ha5 = NULL;
   struct ast_ha *ha6 = NULL;
   struct ast_ha *ha7 = NULL;
   enum ast_test_result_state res = AST_TEST_PASS;
   int err = 0;
   int i;


   switch (cmd) {
   case TEST_INIT:
      info->name = "acl";
      info->category = "/main/acl/";
      info->summary = "ACL unit test";
      info->description =
         "Tests that hosts are properly permitted or denied";
      return AST_TEST_NOT_RUN;
   case TEST_EXECUTE:
      break;
   }

   if (!(permit_hav4 = ast_append_ha(permitallv4.access, permitallv4.host, permit_hav4, &err))) {
      ast_test_status_update(test, "Failed to create permit_all ACL\n");
      res = AST_TEST_FAIL;
      goto acl_cleanup;
   }

   if (!(deny_hav4 = ast_append_ha(denyallv4.access, denyallv4.host, deny_hav4, &err))) {
      ast_test_status_update(test, "Failed to create deny_all ACL\n");
      res = AST_TEST_FAIL;
      goto acl_cleanup;
   }

   if (!(permit_hav6 = ast_append_ha(permitallv6.access, permitallv6.host, permit_hav6, &err))) {
      ast_test_status_update(test, "Failed to create permit_all ACL\n");
      res = AST_TEST_FAIL;
      goto acl_cleanup;
   }

   if (!(deny_hav6 = ast_append_ha(denyallv6.access, denyallv6.host, deny_hav6, &err))) {
      ast_test_status_update(test, "Failed to create deny_all ACL\n");
      res = AST_TEST_FAIL;
      goto acl_cleanup;
   }

   if (build_ha(acl1, ARRAY_LEN(acl1), &ha1, "ha1", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   if (build_ha(acl2, ARRAY_LEN(acl2), &ha2, "ha2", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   if (build_ha(acl3, ARRAY_LEN(acl3), &ha3, "ha3", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   if (build_ha(acl4, ARRAY_LEN(acl4), &ha4, "ha4", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   if (build_ha(acl5, ARRAY_LEN(acl5), &ha5, "ha5", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   if (build_ha(acl6, ARRAY_LEN(acl6), &ha6, "ha6", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   if (build_ha(acl7, ARRAY_LEN(acl7), &ha7, "ha7", &err, test, &res) != 0) {
      goto acl_cleanup;
   }

   for (i = 0; i < ARRAY_LEN(acl_tests); ++i) {
      struct ast_sockaddr addr;
      int permit_resv4;
      int permit_resv6;
      int deny_resv4;
      int deny_resv6;
      int acl1_res;
      int acl2_res;
      int acl3_res;
      int acl4_res;
      int acl5_res;
      int acl6_res;
      int acl7_res;

      ast_sockaddr_parse(&addr, acl_tests[i].test_address, PARSE_PORT_FORBID);

      permit_resv4 = ast_apply_ha(permit_hav4, &addr);
      deny_resv4 = ast_apply_ha(deny_hav4, &addr);
      permit_resv6 = ast_apply_ha(permit_hav6, &addr);
      deny_resv6 = ast_apply_ha(deny_hav6, &addr);
      acl1_res = ast_apply_ha(ha1, &addr);
      acl2_res = ast_apply_ha(ha2, &addr);
      acl3_res = ast_apply_ha(ha3, &addr);
      acl4_res = ast_apply_ha(ha4, &addr);
      acl5_res = ast_apply_ha(ha5, &addr);
      acl6_res = ast_apply_ha(ha6, &addr);
      acl7_res = ast_apply_ha(ha7, &addr);

      if (permit_resv4 != acl_tests[i].v4_permitall_result) {
         ast_test_status_update(test, "Access not as expected to %s on permitallv4. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].v4_permitall_result, permit_resv4);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (deny_resv4 != acl_tests[i].v4_denyall_result) {
         ast_test_status_update(test, "Access not as expected to %s on denyallv4. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].v4_denyall_result, deny_resv4);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (permit_resv6 != acl_tests[i].v6_permitall_result) {
         ast_test_status_update(test, "Access not as expected to %s on permitallv6. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].v6_permitall_result, permit_resv6);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (deny_resv6 != acl_tests[i].v6_denyall_result) {
         ast_test_status_update(test, "Access not as expected to %s on denyallv6. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].v6_denyall_result, deny_resv6);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl1_res != acl_tests[i].acl1_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl1. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl1_result, acl1_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl2_res != acl_tests[i].acl2_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl2. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl2_result, acl2_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl3_res != acl_tests[i].acl3_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl3. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl3_result, acl3_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl4_res != acl_tests[i].acl4_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl4. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl4_result, acl4_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl5_res != acl_tests[i].acl5_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl5. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl5_result, acl5_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl6_res != acl_tests[i].acl6_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl6. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl6_result, acl6_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }

      if (acl7_res != acl_tests[i].acl7_result) {
         ast_test_status_update(test, "Access not as expected to %s on acl7. Expected %d but "
               "got %d instead\n", acl_tests[i].test_address, acl_tests[i].acl7_result, acl7_res);
         res = AST_TEST_FAIL;
         goto acl_cleanup;
      }
   }

acl_cleanup:
   if (permit_hav4) {
      ast_free_ha(permit_hav4);
   }
   if (deny_hav4) {
      ast_free_ha(deny_hav4);
   }
   if (permit_hav6) {
      ast_free_ha(permit_hav6);
   }
   if (deny_hav6) {
      ast_free_ha(deny_hav6);
   }
   if (ha1) {
      ast_free_ha(ha1);
   }
   if (ha2) {
      ast_free_ha(ha2);
   }
   if (ha3) {
      ast_free_ha(ha3);
   }
   if (ha4) {
      ast_free_ha(ha4);
   }
   if (ha5) {
      ast_free_ha(ha5);
   }
   if (ha6) {
      ast_free_ha(ha6);
   }
   if (ha7) {
      ast_free_ha(ha7);
   }
   return res;
}

static int unload_module(void)
{
   AST_TEST_UNREGISTER(invalid_acl);
   AST_TEST_UNREGISTER(acl);
   return 0;
}

static int load_module(void)
{
   AST_TEST_REGISTER(invalid_acl);
   AST_TEST_REGISTER(acl);
   return AST_MODULE_LOAD_SUCCESS;
}

AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "ACL test module");