Thu Mar 25 10:39:18 2010

Asterisk developer's documentation


acl.c File Reference

Various sorts of access control. More...

#include "asterisk.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/time.h>
#include <signal.h>
#include <errno.h>
#include <unistd.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#include <sys/socket.h>
#include <netdb.h>
#include <net/if.h>
#include <netinet/in_systm.h>
#include <netinet/ip.h>
#include <sys/ioctl.h>
#include <ifaddrs.h>
#include "asterisk/acl.h"
#include "asterisk/logger.h"
#include "asterisk/channel.h"
#include "asterisk/options.h"
#include "asterisk/utils.h"
#include "asterisk/lock.h"
#include "asterisk/srv.h"

Go to the source code of this file.

Data Structures

struct  dscp_codepoint
struct  my_ifreq

Defines

#define IPTOS_LOWCOST   0x02
#define IPTOS_MINCOST   IPTOS_LOWCOST

Functions

ast_haast_append_ha (char *sense, const char *stuff, struct ast_ha *path)
int ast_apply_ha (struct ast_ha *ha, struct sockaddr_in *sin)
void ast_copy_ha (const struct ast_ha *from, struct ast_ha *to)
static struct ast_haast_duplicate_ha (struct ast_ha *original)
ast_haast_duplicate_ha_list (struct ast_ha *original)
int ast_find_ourip (struct in_addr *ourip, struct sockaddr_in bindaddr)
void ast_free_ha (struct ast_ha *ha)
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_lookup_iface (char *iface, struct in_addr *address)
int ast_ouraddrfor (struct in_addr *them, struct in_addr *us)
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 in_addr __ourip = { .s_addr = 0x00000000, }
static struct dscp_codepoint dscp_pool1 []


Detailed Description

Various sorts of access control.

Author:
Mark Spencer <markster@digium.com>

Definition in file acl.c.


Define Documentation

#define IPTOS_LOWCOST   0x02

Definition at line 60 of file acl.c.

#define IPTOS_MINCOST   IPTOS_LOWCOST

Definition at line 64 of file acl.c.

Referenced by ast_str2tos(), ast_tos2str(), reload_config(), and set_config().


Function Documentation

struct ast_ha* ast_append_ha ( char *  sense,
const char *  stuff,
struct ast_ha path 
)

Definition at line 298 of file acl.c.

References ast_copy_string(), ast_log(), ast_malloc, AST_SENSE_ALLOW, AST_SENSE_DENY, free, LOG_DEBUG, LOG_WARNING, ast_ha::netaddr, ast_ha::next, and option_debug.

Referenced by add_calltoken_ignore(), authenticate(), build_callno_limits(), build_device(), build_gateway(), build_peer(), and build_user().

00299 {
00300    struct ast_ha *ha;
00301    char *nm = "255.255.255.255";
00302    char tmp[256];
00303    struct ast_ha *prev = NULL;
00304    struct ast_ha *ret;
00305    int x, z;
00306    unsigned int y;
00307 
00308    ret = path;
00309    while (path) {
00310       prev = path;
00311       path = path->next;
00312    }
00313    if ((ha = ast_malloc(sizeof(*ha)))) {
00314       ast_copy_string(tmp, stuff, sizeof(tmp));
00315       nm = strchr(tmp, '/');
00316       if (!nm) {
00317          nm = "255.255.255.255";
00318       } else {
00319          *nm = '\0';
00320          nm++;
00321       }
00322       if (!strchr(nm, '.')) {
00323          if ((sscanf(nm, "%30d", &x) == 1) && (x >= 0) && (x <= 32)) {
00324             y = 0;
00325             for (z = 0; z < x; z++) {
00326                y >>= 1;
00327                y |= 0x80000000;
00328             }
00329             ha->netmask.s_addr = htonl(y);
00330          }
00331       } else if (!inet_aton(nm, &ha->netmask)) {
00332          ast_log(LOG_WARNING, "%s is not a valid netmask\n", nm);
00333          free(ha);
00334          return ret;
00335       }
00336       if (!inet_aton(tmp, &ha->netaddr)) {
00337          ast_log(LOG_WARNING, "%s is not a valid IP\n", tmp);
00338          free(ha);
00339          return ret;
00340       }
00341       ha->netaddr.s_addr &= ha->netmask.s_addr;
00342       if (!strncasecmp(sense, "p", 1)) {
00343          ha->sense = AST_SENSE_ALLOW;
00344       } else {
00345          ha->sense = AST_SENSE_DENY;
00346       }
00347       ha->next = NULL;
00348       if (prev) {
00349          prev->next = ha;
00350       } else {
00351          ret = ha;
00352       }
00353    }
00354    if (option_debug)
00355       ast_log(LOG_DEBUG, "%s/%s appended to acl for peer\n", stuff, nm);
00356    return ret;
00357 }

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

Definition at line 359 of file acl.c.

References ast_copy_string(), ast_inet_ntoa(), ast_log(), AST_SENSE_ALLOW, LOG_DEBUG, ast_ha::netaddr, ast_ha::netmask, ast_ha::next, option_debug, and ast_ha::sense.

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

00360 {
00361    /* Start optimistic */
00362    int res = AST_SENSE_ALLOW;
00363    while (ha) {
00364       char iabuf[INET_ADDRSTRLEN];
00365       char iabuf2[INET_ADDRSTRLEN];
00366       /* DEBUG */
00367       ast_copy_string(iabuf, ast_inet_ntoa(sin->sin_addr), sizeof(iabuf));
00368       ast_copy_string(iabuf2, ast_inet_ntoa(ha->netaddr), sizeof(iabuf2));
00369       if (option_debug)
00370          ast_log(LOG_DEBUG, "##### Testing %s with %s\n", iabuf, iabuf2);
00371       /* For each rule, if this address and the netmask = the net address
00372          apply the current rule */
00373       if ((sin->sin_addr.s_addr & ha->netmask.s_addr) == ha->netaddr.s_addr)
00374          res = ha->sense;
00375       ha = ha->next;
00376    }
00377    return res;
00378 }

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

Definition at line 256 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().

00257 {
00258    memcpy(&to->netaddr, &from->netaddr, sizeof(from->netaddr));
00259    memcpy(&to->netmask, &from->netmask, sizeof(from->netmask));
00260    to->sense = from->sense;
00261 }

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

Definition at line 264 of file acl.c.

References ast_copy_ha(), and ast_malloc.

Referenced by ast_duplicate_ha_list().

00265 {
00266    struct ast_ha *new_ha;
00267 
00268    if ((new_ha = ast_malloc(sizeof(*new_ha)))) {
00269       /* Copy from original to new object */
00270       ast_copy_ha(original, new_ha);
00271    }
00272 
00273    return new_ha;
00274 }

struct ast_ha* ast_duplicate_ha_list ( struct ast_ha original  ) 

Definition at line 278 of file acl.c.

References ast_duplicate_ha(), and ast_ha::next.

00279 {
00280    struct ast_ha *start = original;
00281    struct ast_ha *ret = NULL;
00282    struct ast_ha *link, *prev = NULL;
00283 
00284    while (start) {
00285       link = ast_duplicate_ha(start);  /* Create copy of this object */
00286       if (prev)
00287          prev->next = link;      /* Link previous to this object */
00288 
00289       if (!ret)
00290          ret = link;    /* Save starting point */
00291 
00292       start = start->next;    /* Go to next object */
00293       prev = link;         /* Save pointer to this object */
00294    }
00295    return ret;             /* Return start of list */
00296 }

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

Definition at line 555 of file acl.c.

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

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

00556 {
00557    char ourhost[MAXHOSTNAMELEN] = "";
00558    struct ast_hostent ahp;
00559    struct hostent *hp;
00560    struct in_addr saddr;
00561 
00562    /* just use the bind address if it is nonzero */
00563    if (ntohl(bindaddr.sin_addr.s_addr)) {
00564       memcpy(ourip, &bindaddr.sin_addr, sizeof(*ourip));
00565       return 0;
00566    }
00567    /* try to use our hostname */
00568    if (gethostname(ourhost, sizeof(ourhost) - 1)) {
00569       ast_log(LOG_WARNING, "Unable to get hostname\n");
00570    } else {
00571       hp = ast_gethostbyname(ourhost, &ahp);
00572       if (hp) {
00573          memcpy(ourip, hp->h_addr, sizeof(*ourip));
00574          return 0;
00575       }
00576    }
00577    /* A.ROOT-SERVERS.NET. */
00578    if (inet_aton("198.41.0.4", &saddr) && !ast_ouraddrfor(&saddr, ourip))
00579       return 0;
00580    return get_local_address(ourip);
00581 }

void ast_free_ha ( struct ast_ha ha  ) 

Definition at line 245 of file acl.c.

References free, and ast_ha::next.

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

00246 {
00247    struct ast_ha *hal;
00248    while (ha) {
00249       hal = ha;
00250       ha = ha->next;
00251       free(hal);
00252    }
00253 }

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

Definition at line 497 of file acl.c.

References ast_get_ip_or_srv().

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

00498 {
00499    return ast_get_ip_or_srv(sin, value, NULL);
00500 }

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

Definition at line 380 of file acl.c.

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

Referenced by ast_get_ip(), and build_peer().

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

int ast_lookup_iface ( char *  iface,
struct in_addr *  address 
)

Definition at line 503 of file acl.c.

References ast_copy_string(), ast_log(), errno, and LOG_WARNING.

00504 {
00505    int mysock, res = 0;
00506    struct my_ifreq ifreq;
00507 
00508    memset(&ifreq, 0, sizeof(ifreq));
00509    ast_copy_string(ifreq.ifrn_name, iface, sizeof(ifreq.ifrn_name));
00510 
00511    mysock = socket(PF_INET, SOCK_DGRAM, IPPROTO_IP);
00512    res = ioctl(mysock, SIOCGIFADDR, &ifreq);
00513 
00514    close(mysock);
00515    if (res < 0) {
00516       ast_log(LOG_WARNING, "Unable to get IP of %s: %s\n", iface, strerror(errno));
00517       memcpy((char *)address, (char *)&__ourip, sizeof(__ourip));
00518       return -1;
00519    } else {
00520       memcpy((char *)address, (char *)&ifreq.ifru_addr.sin_addr, sizeof(ifreq.ifru_addr.sin_addr));
00521       return 0;
00522    }
00523 }

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

Definition at line 525 of file acl.c.

References ast_log(), LOG_WARNING, and s.

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

00526 {
00527    int s;
00528    struct sockaddr_in sin;
00529    socklen_t slen;
00530 
00531    s = socket(PF_INET, SOCK_DGRAM, 0);
00532    if (s < 0) {
00533       ast_log(LOG_WARNING, "Cannot create socket\n");
00534       return -1;
00535    }
00536    sin.sin_family = AF_INET;
00537    sin.sin_port = htons(5060);
00538    sin.sin_addr = *them;
00539    if (connect(s, (struct sockaddr *)&sin, sizeof(sin))) {
00540       ast_log(LOG_WARNING, "Cannot connect\n");
00541       close(s);
00542       return -1;
00543    }
00544    slen = sizeof(sin);
00545    if (getsockname(s, (struct sockaddr *)&sin, &slen)) {
00546       ast_log(LOG_WARNING, "Cannot get socket name\n");
00547       close(s);
00548       return -1;
00549    }
00550    close(s);
00551    *us = sin.sin_addr;
00552    return 0;
00553 }

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

Definition at line 437 of file acl.c.

References ast_log(), dscp_pool1, IPTOS_MINCOST, LOG_WARNING, name, and dscp_codepoint::space.

Referenced by iax_template_parse(), and set_config().

00438 {
00439    int fval;
00440    unsigned int x;
00441 
00442    if (sscanf(value, "%30i", &fval) == 1) {
00443       *tos = fval & 0xFF;
00444       return 0;
00445    }
00446 
00447    for (x = 0; x < sizeof(dscp_pool1) / sizeof(dscp_pool1[0]); x++) {
00448       if (!strcasecmp(value, dscp_pool1[x].name)) {
00449          *tos = dscp_pool1[x].space << 2;
00450          return 0;
00451       }
00452    }
00453 
00454    if (!strcasecmp(value, "lowdelay"))
00455       *tos = IPTOS_LOWDELAY;
00456    else if (!strcasecmp(value, "throughput"))
00457       *tos = IPTOS_THROUGHPUT;
00458    else if (!strcasecmp(value, "reliability"))
00459       *tos = IPTOS_RELIABILITY;
00460    else if (!strcasecmp(value, "mincost"))
00461       *tos = IPTOS_MINCOST;
00462    else if (!strcasecmp(value, "none"))
00463       *tos = 0;
00464    else
00465       return -1;
00466 
00467    ast_log(LOG_WARNING, "TOS value %s is deprecated. Please see doc/ip-tos.txt for more information.\n", value);
00468 
00469    return 0;
00470 }

const char* ast_tos2str ( unsigned int  tos  ) 

Definition at line 472 of file acl.c.

References dscp_pool1, IPTOS_MINCOST, name, and dscp_codepoint::space.

Referenced by sip_show_settings().

00473 {
00474    unsigned int x;
00475 
00476    switch (tos) {
00477    case 0:
00478       return "none";
00479    case IPTOS_LOWDELAY:
00480       return "lowdelay";
00481    case IPTOS_THROUGHPUT:
00482       return "throughput";
00483    case IPTOS_RELIABILITY:
00484       return "reliability";
00485    case IPTOS_MINCOST:
00486       return "mincost";
00487    default:
00488       for (x = 0; x < sizeof(dscp_pool1) / sizeof(dscp_pool1[0]); x++) {
00489          if (dscp_pool1[x].space == (tos >> 2))
00490             return dscp_pool1[x].name;
00491       }
00492    }
00493 
00494    return "unknown";
00495 }

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

Definition at line 146 of file acl.c.

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

Referenced by ast_find_ourip().

00147 {
00148    int s, res = -1;
00149 #ifdef SOLARIS
00150    struct lifreq *ifr = NULL;
00151    struct lifnum ifn;
00152    struct lifconf ifc;
00153    struct sockaddr_in *sa;
00154    char *buf = NULL;
00155    int bufsz, x;
00156 #endif /* SOLARIS */
00157 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00158    struct ifaddrs *ifap, *ifaphead;
00159    int rtnerr;
00160    const struct sockaddr_in *sin;
00161 #endif /* BSD_OR_LINUX */
00162    struct in_addr best_addr;
00163    int best_score = -100;
00164    memset(&best_addr, 0, sizeof(best_addr));
00165 
00166 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00167    rtnerr = getifaddrs(&ifaphead);
00168    if (rtnerr) {
00169       perror(NULL);
00170       return -1;
00171    }
00172 #endif /* BSD_OR_LINUX */
00173 
00174    s = socket(AF_INET, SOCK_STREAM, 0);
00175 
00176    if (s > 0) {
00177 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00178       for (ifap = ifaphead; ifap; ifap = ifap->ifa_next) {
00179 
00180          if (ifap->ifa_addr && ifap->ifa_addr->sa_family == AF_INET) {
00181             sin = (const struct sockaddr_in *) ifap->ifa_addr;
00182             score_address(sin, &best_addr, &best_score);
00183             res = 0;
00184 
00185             if (best_score == 0)
00186                break;
00187          }
00188       }
00189 #endif /* BSD_OR_LINUX */
00190 
00191       /* There is no reason whatsoever that this shouldn't work on Linux or BSD also. */
00192 #ifdef SOLARIS
00193       /* Get a count of interfaces on the machine */
00194       ifn.lifn_family = AF_INET;
00195       ifn.lifn_flags = 0;
00196       ifn.lifn_count = 0;
00197       if (ioctl(s, SIOCGLIFNUM, &ifn) < 0) {
00198          close(s);
00199          return -1;
00200       }
00201 
00202       bufsz = ifn.lifn_count * sizeof(struct lifreq);
00203       if (!(buf = malloc(bufsz))) {
00204          close(s);
00205          return -1;
00206       }
00207       memset(buf, 0, bufsz);
00208 
00209       /* Get a list of interfaces on the machine */
00210       ifc.lifc_len = bufsz;
00211       ifc.lifc_buf = buf;
00212       ifc.lifc_family = AF_INET;
00213       ifc.lifc_flags = 0;
00214       if (ioctl(s, SIOCGLIFCONF, &ifc) < 0) {
00215          close(s);
00216          free(buf);
00217          return -1;
00218       }
00219 
00220       for (ifr = ifc.lifc_req, x = 0; x < ifn.lifn_count; ifr++, x++) {
00221          sa = (struct sockaddr_in *)&(ifr->lifr_addr);
00222          score_address(sa, &best_addr, &best_score);
00223          res = 0;
00224 
00225          if (best_score == 0)
00226             break;
00227       }
00228 
00229       free(buf);
00230 #endif /* SOLARIS */
00231       
00232       close(s);
00233    }
00234 #if defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__) || defined(__linux__) || defined(__Darwin__)
00235    freeifaddrs(ifaphead);
00236 #endif /* BSD_OR_LINUX */
00237 
00238    if (res == 0 && ourip)
00239       memcpy(ourip, &best_addr, sizeof(*ourip));
00240    return res;
00241 }

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

Definition at line 89 of file acl.c.

References ast_inet_ntoa().

Referenced by get_local_address().

00090 {
00091    const char *address;
00092    int score;
00093 
00094    address = ast_inet_ntoa(sin->sin_addr);
00095 
00096    /* RFC 1700 alias for the local network */
00097    if (address[0] == '0')
00098       score = -25;
00099    /* RFC 1700 localnet */
00100    else if (strncmp(address, "127", 3) == 0)
00101       score = -20;
00102    /* RFC 1918 non-public address space */
00103    else if (strncmp(address, "10.", 3) == 0)
00104       score = -5;
00105    /* RFC 1918 non-public address space */
00106    else if (strncmp(address, "172", 3) == 0) {
00107       /* 172.16.0.0 - 172.19.255.255, but not 172.160.0.0 - 172.169.255.255 */
00108       if (address[4] == '1' && address[5] >= '6' && address[6] == '.')
00109          score = -5;
00110       /* 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 */
00111       else if (address[4] == '2' && address[6] == '.')
00112          score = -5;
00113       /* 172.30.0.0 - 172.31.255.255 */
00114       else if (address[4] == '3' && address[5] <= '1')
00115          score = -5;
00116       /* All other 172 addresses are public */
00117       else
00118          score = 0;
00119    /* RFC 2544 Benchmark test range */
00120    } else if (strncmp(address, "198.1", 5) == 0 && address[5] >= '8' && address[6] == '.')
00121       score = -10;
00122    /* RFC 1918 non-public address space */
00123    else if (strncmp(address, "192.168", 7) == 0)
00124       score = -5;
00125    /* RFC 3330 Zeroconf network */
00126    else if (strncmp(address, "169.254", 7) == 0)
00127       /*!\note Better score than a test network, but not quite as good as RFC 1918
00128        * address space.  The reason is that some Linux distributions automatically
00129        * configure a Zeroconf address before trying DHCP, so we want to prefer a
00130        * DHCP lease to a Zeroconf address.
00131        */
00132       score = -10;
00133    /* RFC 3330 Test network */
00134    else if (strncmp(address, "192.0.2.", 8) == 0)
00135       score = -15;
00136    /* Every other address should be publically routable */
00137    else
00138       score = 0;
00139 
00140    if (score > *best_score) {
00141       *best_score = score;
00142       memcpy(best_addr, &sin->sin_addr, sizeof(*best_addr));
00143    }
00144 }


Variable Documentation

struct in_addr __ourip = { .s_addr = 0x00000000, } [static]

Definition at line 76 of file acl.c.

Referenced by build_device(), build_gateway(), find_subchannel_and_lock(), gtalk_create_candidates(), load_module(), reload_config(), sip_alloc(), sip_notify(), sip_poke_peer(), sip_request_call(), sip_send_mwi_to_peer(), skinny_register(), transmit_register(), and transmit_response_using_temp().

struct dscp_codepoint dscp_pool1[] [static]

Definition at line 413 of file acl.c.

Referenced by ast_str2tos(), and ast_tos2str().


Generated on Thu Mar 25 10:39:18 2010 for Asterisk - the Open Source PBX by  doxygen 1.4.7