Fri Feb 19 17:12:48 2010

Asterisk developer's documentation


acl.h File Reference

Access Control of various sorts. More...

#include <netinet/in.h>
#include "asterisk/io.h"

Go to the source code of this file.

Data Structures

struct  ast_ha

Defines

#define AST_SENSE_ALLOW   1
#define AST_SENSE_DENY   0

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)
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)


Detailed Description

Access Control of various sorts.

Definition in file acl.h.


Define Documentation

#define AST_SENSE_ALLOW   1

Definition at line 35 of file acl.h.

Referenced by ast_append_ha(), ast_apply_ha(), and parse_register_contact().

#define AST_SENSE_DENY   0

Definition at line 34 of file acl.h.

Referenced by ast_append_ha().


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 }

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 }


Generated on Fri Feb 19 17:12:48 2010 for Asterisk - the Open Source PBX by  doxygen 1.4.7