auth_api.h File Reference

---

Detailed Description

Interrogating-CSCF - Digest Authorization API.

Note:

Taken from the auth_db SER module

Definition in file auth_api.h.

#include "../../parser/msg_parser.h"
#include "../../parser/hf.h"
#include "../../str.h"

Go to the source code of this file.

Functions
int	find_credentials (struct sip_msg *_m, str *_realm, hdr_types_t _hftype, struct hdr_field **_h)
	Find credentials with given realm in a SIP message header.

---

Function Documentation

int find_credentials	(	struct sip_msg *	_m,
		str *	_realm,
		hdr_types_t	_hftype,
		struct hdr_field **	_h
	)			[inline]

Find credentials with given realm in a SIP message header.

Parameters:

	_m	- the SIP message to look into
	_realm	- the realm to match in the authorization header
	_hftype	- the header type (HDR_AUTHORIZATION_T,HDR_PROXYAUTH_T)
	_h	- header pointer to fill with the match

Returns:

0 on success, 1 if not found

Note:

This function is taken from the auth module

Definition at line 59 of file auth_api.c.

{
    struct hdr_field** hook, *ptr, *prev;
    hdr_flags_t hdr_flags;
    int res;
    str* r;

         /*
          * Determine if we should use WWW-Authorization or
          * Proxy-Authorization header fields, this parameter
          * is set in www_authorize and proxy_authorize
          */
    switch(_hftype) {
    case HDR_AUTHORIZATION_T: 
                            hook = &(_m->authorization);
                            hdr_flags=HDR_AUTHORIZATION_F;
                            break;
    case HDR_PROXYAUTH_T:
                            hook = &(_m->proxy_auth);
                            hdr_flags=HDR_PROXYAUTH_F;
                            break;
    default:                
                            hook = &(_m->authorization);
                            hdr_flags=HDR_T2F(_hftype);
                            break;
    }

         /*
          * If the credentials haven't been parsed yet, do it now
          */
    if (*hook == 0) {
             /* No credentials parsed yet */
        if (parse_headers(_m, hdr_flags, 0) == -1) {
            LOG(L_ERR, "find_credentials(): Error while parsing headers\n");
            return -1;
        }
    }

    ptr = *hook;

         /*
          * Iterate through the credentials in the message and
          * find credentials with given realm
          */
    while(ptr) {
        res = parse_credentials(ptr);
        
        if (res < 0) {
            LOG(L_ERR, "find_credentials(): Error while parsing credentials [%d]\n",res);
            return (res == -1) ? -2 : -3;
        } else if (res == 0) {
            if (_realm->len) {
                r = &(((auth_body_t*)(ptr->parsed))->digest.realm);
    
                if (r->len == _realm->len) {
                    if (!strncasecmp(_realm->s, r->s, r->len)) {
                        *_h = ptr;
                        return 0;
                    }
                }
            }
            else {
                *_h = ptr;
                return 0;
            }
            
        }

        prev = ptr;
        if (parse_headers(_m, hdr_flags, 1) == -1) {
            LOG(L_ERR, "find_credentials(): Error while parsing headers\n");
            return -4;
        } else {
            if (prev != _m->last_header) {
                if (_m->last_header->type == _hftype) ptr = _m->last_header;
                else break;
            } else break;
        }
    }
    
         /*
          * Credentials with given realm not found
          */
    return 1;
}

---