Fri Nov 12 11:47:32 2010

Asterisk developer's documentation


acl.c File Reference

Various sorts of access control. More...

#include "asterisk.h"
#include "asterisk/network.h"
#include <ifaddrs.h>
#include "asterisk/acl.h"
#include "asterisk/channel.h"
#include "asterisk/utils.h"
#include "asterisk/lock.h"
#include "asterisk/srv.h"
Include dependency graph for acl.c:

Go to the source code of this file.

Data Structures

struct  dscp_codepoint

Functions

struct ast_haast_append_ha (const char *sense, const char *stuff, struct ast_ha *path, int *error)
 Append ACL entry to host access list.
int ast_apply_ha (struct ast_ha *ha, struct sockaddr_in *sin)
 Check IP address with host access list.
void ast_copy_ha (const struct ast_ha *from, struct ast_ha *to)
 Copy ha structure.
static struct ast_haast_duplicate_ha (struct ast_ha *original)
struct ast_haast_duplicate_ha_list (struct ast_ha *original)
 Copy host access list.
int ast_find_ourip (struct in_addr *ourip, struct sockaddr_in bindaddr)
void ast_free_ha (struct ast_ha *ha)
 Free host access list.
int ast_get_ip (struct sockaddr_in *sin, const char *value)
int ast_get_ip_or_srv (struct sockaddr_in *sin, const char *value, const char *service)
int ast_ouraddrfor (struct in_addr *them, struct in_addr *us)
int ast_str2cos (const char *value, unsigned int *cos)
int ast_str2tos (const char *value, unsigned int *tos)
const char * ast_tos2str (unsigned int tos)
static int get_local_address (struct in_addr *ourip)
static void score_address (const struct sockaddr_in *sin, struct in_addr *best_addr, int *best_score)

Variables

static struct dscp_codepoint dscp_pool1 []

Detailed Description

Various sorts of access control.

Author:
Mark Spencer <markster@digium.com>

Definition in file acl.c.


Function Documentation

struct ast_ha* ast_append_ha ( const char *  sense,
const char *  stuff,
struct ast_ha path,
int *  error 
) [read]

Append ACL entry to host access list.

Definition at line 272 of file acl.c.

References ast_debug, ast_free, ast_inet_ntoa(), ast_log(), ast_malloc, AST_SENSE_ALLOW, AST_SENSE_DENY, LOG_WARNING, ast_ha::netaddr, ast_ha::netmask, ast_ha::next, and ast_ha::sense.

Referenced by __init_manager(), add_calltoken_ignore(), build_callno_limits(), build_device(), build_gateway(), build_peer(), build_user(), config_parse_variables(), and reload_config().

00273 {
00274    struct ast_ha *ha;
00275    char *nm;
00276    struct ast_ha *prev = NULL;
00277    struct ast_ha *ret;
00278    int x;
00279    char *tmp = ast_strdupa(stuff);
00280 
00281    ret = path;
00282    while (path) {
00283       prev = path;
00284       path = path->next;
00285    }
00286 
00287    if (!(ha = ast_malloc(sizeof(*ha)))) {
00288       return ret;
00289    }
00290 
00291    if (!(nm = strchr(tmp, '/'))) {
00292       /* assume /32. Yes, htonl does not do anything for this particular mask
00293          but we better use it to show we remember about byte order */
00294       ha->netmask.s_addr = htonl(0xFFFFFFFF);
00295    } else {
00296       *nm = '\0';
00297       nm++;
00298 
00299       if (!strchr(nm, '.')) {
00300          if ((sscanf(nm, "%30d", &x) == 1) && (x >= 0) && (x <= 32)) {
00301             if (x == 0) {
00302                /* This is special-cased to prevent unpredictable
00303                 * behavior of shifting left 32 bits
00304                 */
00305                ha->netmask.s_addr = 0;
00306             } else {
00307                ha->netmask.s_addr = htonl(0xFFFFFFFF << (32 - x));
00308             }
00309          } else {
00310             ast_log(LOG_WARNING, "Invalid CIDR in %s\n", stuff);
00311             ast_free(ha);
00312             if (error) {
00313                *error = 1;
00314             }
00315             return ret;
00316          }
00317       } else if (!inet_aton(nm, &ha->netmask)) {
00318          ast_log(LOG_WARNING, "Invalid mask in %s\n", stuff);
00319          ast_free(ha);
00320          if (error) {
00321             *error = 1;
00322          }
00323          return ret;
00324       }
00325    }
00326 
00327    if (!inet_aton(tmp, &ha->netaddr)) {
00328       ast_log(LOG_WARNING, "Invalid IP address in %s\n", stuff);
00329       ast_free(ha);
00330       if (error) {
00331          *error = 1;
00332       }
00333       return ret;
00334    }
00335 
00336    ha->netaddr.s_addr &= ha->netmask.s_addr;
00337 
00338    ha->sense = strncasecmp(sense, "p", 1) ? AST_SENSE_DENY : AST_SENSE_ALLOW;
00339 
00340    ha->next = NULL;
00341    if (prev) {
00342       prev->next = ha;
00343    } else {
00344       ret = ha;
00345    }
00346 
00347    ast_debug(1, "%s/%s sense %d appended to acl for peer\n", ast_strdupa(ast_inet_ntoa(ha->netaddr)), ast_strdupa(ast_inet_ntoa(ha->netmask)), ha->sense);
00348 
00349    return ret;
00350 }

int ast_apply_ha ( struct ast_ha ha,
struct sockaddr_in *  sin 
)

Check IP address with host access list.

Definition at line 352 of file acl.c.

References ast_copy_string(), ast_debug, ast_inet_ntoa(), AST_SENSE_ALLOW, ast_ha::netaddr, ast_ha::netmask, ast_ha::next, and ast_ha::sense.

Referenced by ast_sip_ouraddrfor(), authenticate(), check_access(), check_peer_ok(), parse_register_contact(), register_verify(), and skinny_register().

00353 {
00354    /* Start optimistic */
00355    int res = AST_SENSE_ALLOW;
00356    while (ha) {
00357 #if 0 /* debugging code */
00358       char iabuf[INET_ADDRSTRLEN];
00359       char iabuf2[INET_ADDRSTRLEN];
00360       /* DEBUG */
00361       ast_copy_string(iabuf, ast_inet_ntoa(sin->sin_addr), sizeof(iabuf));
00362       ast_copy_string(iabuf2, ast_inet_ntoa(ha->netaddr), sizeof(iabuf2));
00363       ast_debug(1, "##### Testing %s with %s\n", iabuf, iabuf2);
00364 #endif
00365       /* For each rule, if this address and the netmask = the net address
00366          apply the current rule */
00367       if ((sin->sin_addr.s_addr & ha->netmask.s_addr) == ha->netaddr.s_addr) {
00368          res = ha->sense;
00369       }
00370       ha = ha->next;
00371    }
00372    return res;
00373 }

void ast_copy_ha ( const struct ast_ha from,
struct ast_ha to 
)

Copy ha structure.

Definition at line 228 of file acl.c.

References ast_ha::netaddr, ast_ha::netmask, and ast_ha::sense.

Referenced by add_calltoken_ignore(), ast_duplicate_ha(), and build_callno_limits().

00229 {
00230    memcpy(&to->netaddr, &from->netaddr, sizeof(from->netaddr));
00231    memcpy(&to->netmask, &from->netmask, sizeof(from->netmask));
00232    to->sense = from->sense;
00233 }

static struct ast_ha* ast_duplicate_ha ( struct ast_ha original  )  [static, read]

Definition at line 236 of file acl.c.

References ast_copy_ha(), and ast_malloc.

Referenced by ast_duplicate_ha_list().

00237 {
00238    struct ast_ha *new_ha;
00239 
00240    if ((new_ha = ast_malloc(sizeof(*new_ha)))) {
00241       /* Copy from original to new object */
00242       ast_copy_ha(original, new_ha);
00243    }
00244 
00245    return new_ha;
00246 }

struct ast_ha* ast_duplicate_ha_list ( struct ast_ha original  )  [read]

Copy host access list.

Definition at line 250 of file acl.c.

References ast_duplicate_ha(), and ast_ha::next.

00251 {
00252    struct ast_ha *start = original;
00253    struct ast_ha *ret = NULL;
00254    struct ast_ha *current, *prev = NULL;
00255 
00256    while (start) {
00257       current = ast_duplicate_ha(start);  /* Create copy of this object */
00258       if (prev) {
00259          prev->next = current;           /* Link previous to this object */
00260       }
00261 
00262       if (!ret) {
00263          ret = current;                  /* Save starting point */
00264       }
00265 
00266       start = start->next;                /* Go to next object */
00267       prev = current;                     /* Save pointer to this object */
00268    }
00269    return ret;                             /* Return start of list */
00270 }

int ast_find_ourip ( struct in_addr *  ourip,
struct sockaddr_in  bindaddr 
)

Definition at line 511 of file acl.c.

References ast_debug, ast_gethostbyname(), ast_log(), ast_ouraddrfor(), get_local_address(), hp, LOG_WARNING, and ourhost.

Referenced by __oh323_rtp_create(), gtalk_create_candidates(), jingle_create_candidates(), load_module(), and reload_config().

00512 {
00513    char ourhost[MAXHOSTNAMELEN] = "";
00514    struct ast_hostent ahp;
00515    struct hostent *hp;
00516    struct in_addr saddr;
00517 
00518    /* just use the bind address if it is nonzero */
00519    if (ntohl(bindaddr.sin_addr.s_addr)) {
00520       memcpy(ourip, &bindaddr.sin_addr, sizeof(*ourip));
00521       ast_debug(3, "Attached to given IP address\n");
00522       return 0;
00523    }
00524    /* try to use our hostname */
00525    if (gethostname(ourhost, sizeof(ourhost) - 1)) {
00526       ast_log(LOG_WARNING, "Unable to get hostname\n");
00527    } else {
00528       if ((hp = ast_gethostbyname(ourhost, &ahp))) {
00529          memcpy(ourip, hp->h_addr, sizeof(*ourip));
00530          ast_debug(3, "Found one IP address based on local hostname %s.\n", ourhost);
00531          return 0;
00532       }
00533    }
00534    ast_debug(3, "Trying to check A.ROOT-SERVERS.NET and get our IP address for that connection\n");
00535    /* A.ROOT-SERVERS.NET. */
00536    if (inet_aton("198.41.0.4", &saddr) && !ast_ouraddrfor(&saddr, ourip)) {
00537       return 0;
00538    }
00539    return get_local_address(ourip);
00540 }

void ast_free_ha ( struct ast_ha ha  ) 

Free host access list.

Definition at line 217 of file acl.c.

References ast_free, and ast_ha::next.

Referenced by __init_manager(), add_calltoken_ignore(), build_callno_limits(), build_peer(), build_user(), destroy_gateway(), oh323_destroy_peer(), oh323_destroy_user(), peer_destructor(), reload_config(), sip_destroy_peer(), unload_module(), and user_destructor().

00218 {
00219    struct ast_ha *hal;
00220    while (ha) {
00221       hal = ha;
00222       ha = ha->next;
00223       ast_free(hal);
00224    }
00225 }

int ast_get_ip ( struct sockaddr_in *  sin,
const char *  value 
)

Definition at line 476 of file acl.c.

References ast_get_ip_or_srv().

Referenced by build_gateway(), build_peer(), build_user(), config_parse_variables(), and peer_set_srcaddr().

00477 {
00478    return ast_get_ip_or_srv(sin, value, NULL);
00479 }

int ast_get_ip_or_srv ( struct sockaddr_in *  sin,
const char *  value,
const char *  service 
)

Definition at line 375 of file acl.c.

References ast_get_srv(), ast_gethostbyname(), ast_log(), hp, and LOG_WARNING.

Referenced by ast_dnsmgr_lookup(), ast_get_ip(), create_addr(), dnsmgr_refresh(), and proxy_update().

00376 {
00377    struct hostent *hp;
00378    struct ast_hostent ahp;
00379    char srv[256];
00380    char host[256];
00381    int tportno = ntohs(sin->sin_port);
00382    if (service) {
00383       snprintf(srv, sizeof(srv), "%s.%s", service, value);
00384       if (ast_get_srv(NULL, host, sizeof(host), &tportno, srv) > 0) {
00385          sin->sin_port = htons(tportno);
00386          value = host;
00387       }
00388    }
00389    if ((hp = ast_gethostbyname(value, &ahp))) {
00390       memcpy(&sin->sin_addr, hp->h_addr, sizeof(sin->sin_addr));
00391    } else {
00392       ast_log(LOG_WARNING, "Unable to lookup '%s'\n", value);
00393       return -1;
00394    }
00395    return 0;
00396 }

int ast_ouraddrfor ( struct in_addr *  them,
struct in_addr *  us 
)

Definition at line 481 of file acl.c.

References ast_debug, ast_log(), LOG_ERROR, LOG_WARNING, and s.

Referenced by ast_find_ourip(), ast_sip_ouraddrfor(), build_gateway(), and find_subchannel_and_lock().

00482 {
00483    int s;
00484    struct sockaddr_in sin;
00485    socklen_t slen;
00486 
00487    if ((s = socket(PF_INET, SOCK_DGRAM, 0)) < 0) {
00488       ast_log(LOG_ERROR, "Cannot create socket\n");
00489       return -1;
00490    }
00491    sin.sin_family = AF_INET;
00492    sin.sin_port = htons(5060);
00493    sin.sin_addr = *them;
00494    if (connect(s, (struct sockaddr *)&sin, sizeof(sin))) {
00495       ast_log(LOG_WARNING, "Cannot connect\n");
00496       close(s);
00497       return -1;
00498    }
00499    slen = sizeof(sin);
00500    if (getsockname(s, (struct sockaddr *)&sin, &slen)) {
00501       ast_log(LOG_WARNING, "Cannot get socket name\n");
00502       close(s);
00503       return -1;
00504    }
00505    close(s);
00506    ast_debug(3, "Found IP address for this socket\n");
00507    *us = sin.sin_addr;
00508    return 0;
00509 }

int ast_str2cos ( const char *  value,
unsigned int *  cos 
)

Definition at line 429 of file acl.c.

Referenced by config_parse_variables(), reload_config(), and set_config().

00430 {
00431    int fval;
00432 
00433    if (sscanf(value, "%30d", &fval) == 1) {
00434       if (fval < 8) {
00435           *cos = fval;
00436           return 0;
00437       }
00438    }
00439 
00440    return -1;
00441 }

int ast_str2tos ( const char *  value,
unsigned int *  tos 
)

Definition at line 443 of file acl.c.

References ARRAY_LEN, name, and dscp_codepoint::space.

Referenced by config_parse_variables(), iax_template_parse(), reload_config(), and set_config().

00444 {
00445    int fval;
00446    unsigned int x;
00447 
00448    if (sscanf(value, "%30i", &fval) == 1) {
00449       *tos = fval & 0xFF;
00450       return 0;
00451    }
00452 
00453    for (x = 0; x < ARRAY_LEN(dscp_pool1); x++) {
00454       if (!strcasecmp(value, dscp_pool1[x].name)) {
00455          *tos = dscp_pool1[x].space << 2;
00456          return 0;
00457       }
00458    }
00459 
00460    return -1;
00461 }

const char* ast_tos2str ( unsigned int  tos  ) 

Definition at line 463 of file acl.c.

References ARRAY_LEN, dscp_codepoint::name, and dscp_codepoint::space.

Referenced by sip_show_settings().

00464 {
00465    unsigned int x;
00466 
00467    for (x = 0; x < ARRAY_LEN(dscp_pool1); x++) {
00468       if (dscp_pool1[x].space == (tos >> 2)) {
00469          return dscp_pool1[x].name;
00470       }
00471    }
00472 
00473    return "unknown";
00474 }

static int get_local_address ( struct in_addr *  ourip  )  [static]

Definition at line 115 of file acl.c.

References buf, free, malloc, s, and score_address().

Referenced by ast_find_ourip().

00116 {
00117    int s, res = -1;
00118 #ifdef SOLARIS
00119    struct lifreq *ifr = NULL;
00120    struct lifnum ifn;
00121    struct lifconf ifc;
00122    struct sockaddr_in *sa;
00123    char *buf = NULL;
00124    int bufsz, x;
00125 #endif /* SOLARIS */
00126 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00127    struct ifaddrs *ifap, *ifaphead;
00128    int rtnerr;
00129    const struct sockaddr_in *sin;
00130 #endif /* BSD_OR_LINUX */
00131    struct in_addr best_addr;
00132    int best_score = -100;
00133    memset(&best_addr, 0, sizeof(best_addr));
00134 
00135 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00136    rtnerr = getifaddrs(&ifaphead);
00137    if (rtnerr) {
00138       perror(NULL);
00139       return -1;
00140    }
00141 #endif /* BSD_OR_LINUX */
00142 
00143    s = socket(AF_INET, SOCK_STREAM, 0);
00144 
00145    if (s > 0) {
00146 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00147       for (ifap = ifaphead; ifap; ifap = ifap->ifa_next) {
00148 
00149          if (ifap->ifa_addr && ifap->ifa_addr->sa_family == AF_INET) {
00150             sin = (const struct sockaddr_in *) ifap->ifa_addr;
00151             score_address(sin, &best_addr, &best_score);
00152             res = 0;
00153 
00154             if (best_score == 0) {
00155                break;
00156             }
00157          }
00158       }
00159 #endif /* BSD_OR_LINUX */
00160 
00161       /* There is no reason whatsoever that this shouldn't work on Linux or BSD also. */
00162 #ifdef SOLARIS
00163       /* Get a count of interfaces on the machine */
00164       ifn.lifn_family = AF_INET;
00165       ifn.lifn_flags = 0;
00166       ifn.lifn_count = 0;
00167       if (ioctl(s, SIOCGLIFNUM, &ifn) < 0) {
00168          close(s);
00169          return -1;
00170       }
00171 
00172       bufsz = ifn.lifn_count * sizeof(struct lifreq);
00173       if (!(buf = malloc(bufsz))) {
00174          close(s);
00175          return -1;
00176       }
00177       memset(buf, 0, bufsz);
00178 
00179       /* Get a list of interfaces on the machine */
00180       ifc.lifc_len = bufsz;
00181       ifc.lifc_buf = buf;
00182       ifc.lifc_family = AF_INET;
00183       ifc.lifc_flags = 0;
00184       if (ioctl(s, SIOCGLIFCONF, &ifc) < 0) {
00185          close(s);
00186          free(buf);
00187          return -1;
00188       }
00189 
00190       for (ifr = ifc.lifc_req, x = 0; x < ifn.lifn_count; ifr++, x++) {
00191          sa = (struct sockaddr_in *)&(ifr->lifr_addr);
00192          score_address(sa, &best_addr, &best_score);
00193          res = 0;
00194 
00195          if (best_score == 0) {
00196             break;
00197          }
00198       }
00199 
00200       free(buf);
00201 #endif /* SOLARIS */
00202 
00203       close(s);
00204    }
00205 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00206    freeifaddrs(ifaphead);
00207 #endif /* BSD_OR_LINUX */
00208 
00209    if (res == 0 && ourip) {
00210       memcpy(ourip, &best_addr, sizeof(*ourip));
00211    }
00212    return res;
00213 }

static void score_address ( const struct sockaddr_in *  sin,
struct in_addr *  best_addr,
int *  best_score 
) [static]

Note:
Better score than a test network, but not quite as good as RFC 1918 address space. The reason is that some Linux distributions automatically configure a Zeroconf address before trying DHCP, so we want to prefer a DHCP lease to a Zeroconf address.

Definition at line 56 of file acl.c.

References ast_inet_ntoa().

Referenced by get_local_address().

00057 {
00058    const char *address;
00059    int score;
00060 
00061    address = ast_inet_ntoa(sin->sin_addr);
00062 
00063    /* RFC 1700 alias for the local network */
00064    if (address[0] == '0') {
00065       score = -25;
00066    /* RFC 1700 localnet */
00067    } else if (strncmp(address, "127", 3) == 0) {
00068       score = -20;
00069    /* RFC 1918 non-public address space */
00070    } else if (strncmp(address, "10.", 3) == 0) {
00071       score = -5;
00072    /* RFC 1918 non-public address space */
00073    } else if (strncmp(address, "172", 3) == 0) {
00074       /* 172.16.0.0 - 172.19.255.255, but not 172.160.0.0 - 172.169.255.255 */
00075       if (address[4] == '1' && address[5] >= '6' && address[6] == '.') {
00076          score = -5;
00077       /* 172.20.0.0 - 172.29.255.255, but not 172.200.0.0 - 172.255.255.255 nor 172.2.0.0 - 172.2.255.255 */
00078       } else if (address[4] == '2' && address[6] == '.') {
00079          score = -5;
00080       /* 172.30.0.0 - 172.31.255.255 */
00081       } else if (address[4] == '3' && address[5] <= '1') {
00082          score = -5;
00083       /* All other 172 addresses are public */
00084       } else {
00085          score = 0;
00086       }
00087    /* RFC 2544 Benchmark test range (198.18.0.0 - 198.19.255.255, but not 198.180.0.0 - 198.199.255.255) */
00088    } else if (strncmp(address, "198.1", 5) == 0 && address[5] >= '8' && address[6] == '.') {
00089       score = -10;
00090    /* RFC 1918 non-public address space */
00091    } else if (strncmp(address, "192.168", 7) == 0) {
00092       score = -5;
00093    /* RFC 3330 Zeroconf network */
00094    } else if (strncmp(address, "169.254", 7) == 0) {
00095       /*!\note Better score than a test network, but not quite as good as RFC 1918
00096        * address space.  The reason is that some Linux distributions automatically
00097        * configure a Zeroconf address before trying DHCP, so we want to prefer a
00098        * DHCP lease to a Zeroconf address.
00099        */
00100       score = -10;
00101    /* RFC 3330 Test network */
00102    } else if (strncmp(address, "192.0.2.", 8) == 0) {
00103       score = -15;
00104    /* Every other address should be publically routable */
00105    } else {
00106       score = 0;
00107    }
00108 
00109    if (score > *best_score) {
00110       *best_score = score;
00111       memcpy(best_addr, &sin->sin_addr, sizeof(*best_addr));
00112    }
00113 }


Variable Documentation

struct dscp_codepoint dscp_pool1[] [static]

Definition at line 405 of file acl.c.


Generated by  doxygen 1.6.2