Mon Jun 18 2012 03:58:09

Asterisk developer's documentation


sdp_crypto.c File Reference

SDP Security descriptions. More...

#include "asterisk.h"
#include "asterisk/options.h"
#include "asterisk/utils.h"
#include "include/sdp_crypto.h"
Include dependency graph for sdp_crypto.c:

Go to the source code of this file.

Data Structures

struct  sdp_crypto

Defines

#define SRTP_MASTER_LEN   30
#define SRTP_MASTER_LEN64   (((SRTP_MASTER_LEN) * 8 + 5) / 6 + 1)
#define SRTP_MASTERKEY_LEN   16
#define SRTP_MASTERSALT_LEN   ((SRTP_MASTER_LEN) - (SRTP_MASTERKEY_LEN))

Functions

static int sdp_crypto_activate (struct sdp_crypto *p, int suite_val, unsigned char *remote_key, struct ast_rtp_instance *rtp)
static struct sdp_crypto * sdp_crypto_alloc (void)
const char * sdp_crypto_attrib (struct sdp_crypto *p)
void sdp_crypto_destroy (struct sdp_crypto *crypto)
int sdp_crypto_offer (struct sdp_crypto *p)
int sdp_crypto_process (struct sdp_crypto *p, const char *attr, struct ast_rtp_instance *rtp)
struct sdp_crypto * sdp_crypto_setup (void)
static int set_crypto_policy (struct ast_srtp_policy *policy, int suite_val, const unsigned char *master_key, unsigned long ssrc, int inbound)

Variables

struct ast_srtp_res * res_srtp
struct ast_srtp_policy_res * res_srtp_policy

Detailed Description

SDP Security descriptions.

Specified in RFC 4568

Author:
Mikael Magnusson <mikma@users.sourceforge.net>

Definition in file sdp_crypto.c.


Define Documentation

#define SRTP_MASTER_LEN   30

Definition at line 36 of file sdp_crypto.c.

Referenced by sdp_crypto_setup(), and sdp_crypto_process().

#define SRTP_MASTER_LEN64   (((SRTP_MASTER_LEN) * 8 + 5) / 6 + 1)

Definition at line 39 of file sdp_crypto.c.

#define SRTP_MASTERKEY_LEN   16

Definition at line 37 of file sdp_crypto.c.

Referenced by set_crypto_policy().

#define SRTP_MASTERSALT_LEN   ((SRTP_MASTER_LEN) - (SRTP_MASTERKEY_LEN))

Definition at line 38 of file sdp_crypto.c.

Referenced by set_crypto_policy().


Function Documentation

static int sdp_crypto_activate ( struct sdp_crypto *  p,
int  suite_val,
unsigned char *  remote_key,
struct ast_rtp_instance *  rtp 
) [static]

Definition at line 129 of file sdp_crypto.c.

References ast_rtp_engine_srtp_is_registered(), ast_srtp_policy_res::alloc, ast_rtp_instance_get_stats(), AST_RTP_INSTANCE_STAT_LOCAL_SSRC, set_crypto_policy(), sdp_crypto::local_key, ast_rtp_instance_stats::local_ssrc, ast_rtp_instance_add_srtp_policy(), ast_log(), LOG_WARNING, ast_debug, and ast_srtp_policy_res::destroy.

Referenced by sdp_crypto_process().

{
   struct ast_srtp_policy *local_policy = NULL;
   struct ast_srtp_policy *remote_policy = NULL;
   struct ast_rtp_instance_stats stats = {0,};
   int res = -1;

   if (!ast_rtp_engine_srtp_is_registered()) {
      return -1;
   }

   if (!p) {
      return -1;
   }

   if (!(local_policy = res_srtp_policy->alloc())) {
      return -1;
   }

   if (!(remote_policy = res_srtp_policy->alloc())) {
      goto err;
   }

   if (ast_rtp_instance_get_stats(rtp, &stats, AST_RTP_INSTANCE_STAT_LOCAL_SSRC)) {
      goto err;
   }

   if (set_crypto_policy(local_policy, suite_val, p->local_key, stats.local_ssrc, 0) < 0) {
      goto err;
   }

   if (set_crypto_policy(remote_policy, suite_val, remote_key, 0, 1) < 0) {
      goto err;
   }

   /* Add the SRTP policies */
   if (ast_rtp_instance_add_srtp_policy(rtp, remote_policy, local_policy)) {
      ast_log(LOG_WARNING, "Could not set SRTP policies\n");
      goto err;
   }

   ast_debug(1 , "SRTP policy activated\n");
   res = 0;

err:
   if (local_policy) {
      res_srtp_policy->destroy(local_policy);
   }

   if (remote_policy) {
      res_srtp_policy->destroy(remote_policy);
   }

   return res;
}
static struct sdp_crypto* sdp_crypto_alloc ( void  ) [static, read]

Definition at line 52 of file sdp_crypto.c.

References ast_calloc.

Referenced by sdp_crypto_setup().

{
   struct sdp_crypto *crypto;

   return crypto = ast_calloc(1, sizeof(*crypto));
}
const char* sdp_crypto_attrib ( struct sdp_crypto *  p)

Definition at line 298 of file sdp_crypto.c.

References sdp_crypto::a_crypto.

Referenced by get_crypto_attrib().

{
   return p->a_crypto;
}
void sdp_crypto_destroy ( struct sdp_crypto *  crypto)

Definition at line 59 of file sdp_crypto.c.

References ast_free, and sdp_crypto::a_crypto.

Referenced by sdp_crypto_setup(), and sip_srtp_destroy().

{
   ast_free(crypto->a_crypto);
   crypto->a_crypto = NULL;
   ast_free(crypto);
}
int sdp_crypto_offer ( struct sdp_crypto *  p)

Definition at line 278 of file sdp_crypto.c.

References sdp_crypto::a_crypto, ast_free, sdp_crypto::local_key64, and ast_strdup.

Referenced by get_crypto_attrib().

{
   char crypto_buf[128];
   const char *crypto_suite = "AES_CM_128_HMAC_SHA1_80"; /* Crypto offer */

   if (p->a_crypto) {
      ast_free(p->a_crypto);
   }

   if (snprintf(crypto_buf, sizeof(crypto_buf), "a=crypto:1 %s inline:%s\r\n",  crypto_suite, p->local_key64) < 1) {
      return -1;
   }

   if (!(p->a_crypto = ast_strdup(crypto_buf))) {
      return -1;
   }

   return 0;
}
int sdp_crypto_process ( struct sdp_crypto *  p,
const char *  attr,
struct ast_rtp_instance *  rtp 
)

Definition at line 185 of file sdp_crypto.c.

References str, SRTP_MASTER_LEN, ast_rtp_engine_srtp_is_registered(), ast_strdupa, strsep(), ast_log(), LOG_WARNING, AST_AES_CM_128_HMAC_SHA1_80, AST_AES_CM_128_HMAC_SHA1_32, LOG_NOTICE, ast_base64decode(), sdp_crypto_activate(), sdp_crypto::a_crypto, ast_calloc, LOG_ERROR, and sdp_crypto::local_key64.

Referenced by process_crypto().

{
   char *str = NULL;
   char *tag = NULL;
   char *suite = NULL;
   char *key_params = NULL;
   char *key_param = NULL;
   char *session_params = NULL;
   char *key_salt = NULL;
   char *lifetime = NULL;
   int found = 0;
   int attr_len = strlen(attr);
   int key_len = 0;
   int suite_val = 0;
   unsigned char remote_key[SRTP_MASTER_LEN];

   if (!ast_rtp_engine_srtp_is_registered()) {
      return -1;
   }

   str = ast_strdupa(attr);

   strsep(&str, ":");
   tag = strsep(&str, " ");
   suite = strsep(&str, " ");
   key_params = strsep(&str, " ");
   session_params = strsep(&str, " ");

   if (!tag || !suite) {
      ast_log(LOG_WARNING, "Unrecognized a=%s", attr);
      return -1;
   }

   if (session_params) {
      ast_log(LOG_WARNING, "Unsupported crypto parameters: %s", session_params);
      return -1;
   }

   if (!strcmp(suite, "AES_CM_128_HMAC_SHA1_80")) {
      suite_val = AST_AES_CM_128_HMAC_SHA1_80;
   } else if (!strcmp(suite, "AES_CM_128_HMAC_SHA1_32")) {
      suite_val = AST_AES_CM_128_HMAC_SHA1_32;
   } else {
      ast_log(LOG_WARNING, "Unsupported crypto suite: %s\n", suite);
      return -1;
   }

   while ((key_param = strsep(&key_params, ";"))) {
      char *method = NULL;
      char *info = NULL;

      method = strsep(&key_param, ":");
      info = strsep(&key_param, ";");

      if (!strcmp(method, "inline")) {
         key_salt = strsep(&info, "|");
         lifetime = strsep(&info, "|");

         if (lifetime) {
            ast_log(LOG_NOTICE, "Crypto life time unsupported: %s\n", attr);
            continue;
         }

         found = 1;
         break;
      }
   }

   if (!found) {
      ast_log(LOG_NOTICE, "SRTP crypto offer not acceptable\n");
      return -1;
   }


   if ((key_len = ast_base64decode(remote_key, key_salt, sizeof(remote_key))) != SRTP_MASTER_LEN) {
      ast_log(LOG_WARNING, "SRTP sdescriptions key %d != %d\n", key_len, SRTP_MASTER_LEN);
      return -1;
   }

   if (sdp_crypto_activate(p, suite_val, remote_key, rtp) < 0) {
      return -1;
   }

   if (!p->a_crypto) {
      if (!(p->a_crypto = ast_calloc(1, attr_len + 11))) {
         ast_log(LOG_ERROR, "Could not allocate memory for a_crypto\n");
         return -1;
      }
      snprintf(p->a_crypto, attr_len + 10, "a=crypto:%s %s inline:%s\r\n", tag, suite, p->local_key64);
   }
   return 0;
}
struct sdp_crypto* sdp_crypto_setup ( void  ) [read]

Definition at line 66 of file sdp_crypto.c.

References SRTP_MASTER_LEN, ast_rtp_engine_srtp_is_registered(), sdp_crypto_alloc(), ast_srtp_res::get_random, sdp_crypto::local_key, sdp_crypto_destroy(), ast_base64encode(), sdp_crypto::local_key64, ast_base64decode(), ast_log(), LOG_ERROR, ast_free, and ast_debug.

Referenced by get_crypto_attrib(), and process_crypto().

{
   struct sdp_crypto *p;
   int key_len;
   unsigned char remote_key[SRTP_MASTER_LEN];

   if (!ast_rtp_engine_srtp_is_registered()) {
      return NULL;
   }

   if (!(p = sdp_crypto_alloc())) {
      return NULL;
   }

   if (res_srtp->get_random(p->local_key, sizeof(p->local_key)) < 0) {
      sdp_crypto_destroy(p);
      return NULL;
   }

   ast_base64encode(p->local_key64, p->local_key, SRTP_MASTER_LEN, sizeof(p->local_key64));

   key_len = ast_base64decode(remote_key, p->local_key64, sizeof(remote_key));

   if (key_len != SRTP_MASTER_LEN) {
      ast_log(LOG_ERROR, "base64 encode/decode bad len %d != %d\n", key_len, SRTP_MASTER_LEN);
      ast_free(p);
      return NULL;
   }

   if (memcmp(remote_key, p->local_key, SRTP_MASTER_LEN)) {
      ast_log(LOG_ERROR, "base64 encode/decode bad key\n");
      ast_free(p);
      return NULL;
   }

   ast_debug(1 , "local_key64 %s len %zu\n", p->local_key64, strlen(p->local_key64));

   return p;
}
static int set_crypto_policy ( struct ast_srtp_policy *  policy,
int  suite_val,
const unsigned char *  master_key,
unsigned long  ssrc,
int  inbound 
) [static]

Definition at line 106 of file sdp_crypto.c.

References ast_rtp_engine_srtp_is_registered(), SRTP_MASTERKEY_LEN, ast_srtp_policy_res::set_master_key, SRTP_MASTERSALT_LEN, ast_srtp_policy_res::set_suite, ast_log(), LOG_WARNING, and ast_srtp_policy_res::set_ssrc.

Referenced by sdp_crypto_activate().

{
   const unsigned char *master_salt = NULL;

   if (!ast_rtp_engine_srtp_is_registered()) {
      return -1;
   }

   master_salt = master_key + SRTP_MASTERKEY_LEN;
   if (res_srtp_policy->set_master_key(policy, master_key, SRTP_MASTERKEY_LEN, master_salt, SRTP_MASTERSALT_LEN) < 0) {
      return -1;
   }

   if (res_srtp_policy->set_suite(policy, suite_val)) {
      ast_log(LOG_WARNING, "Could not set remote SRTP suite\n");
      return -1;
   }

   res_srtp_policy->set_ssrc(policy, ssrc, inbound);

   return 0;
}

Variable Documentation

Definition at line 44 of file rtp_engine.c.

Definition at line 45 of file rtp_engine.c.

Referenced by ast_rtp_engine_srtp_is_registered().