sdp_srtp.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 2006 - 2007, Mikael Magnusson
 *
 * Mikael Magnusson <[email protected]>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*! \file
 *
 * \brief SRTP and SDP Security descriptions
 *
 * Specified in RFC 3711, 6188, 7714, and 4568
 *
 * \author Mikael Magnusson <[email protected]>
 */

/*** MODULEINFO
 <support_level>core</support_level>
 ***/

#include "asterisk.h"

#include "asterisk/linkedlists.h" /* for AST_LIST_NEXT, etc */
#include "asterisk/logger.h" /* for ast_log, LOG_ERROR, etc */
#include "asterisk/sdp_srtp.h" /* for ast_sdp_srtp, etc */

/*! Registered SDP crypto API */
static struct ast_sdp_crypto_api *sdp_crypto_api;

struct ast_sdp_srtp *ast_sdp_srtp_alloc(void)
{
 if (!ast_rtp_engine_srtp_is_registered()) {
 ast_debug(1, "No SRTP module loaded, can't setup SRTP session.\n");
 return NULL;
 }

 return ast_calloc(1, sizeof(struct ast_sdp_srtp));
}

void ast_sdp_srtp_destroy(struct ast_sdp_srtp *srtp)
{
 struct ast_sdp_srtp *next;

 for (next = AST_LIST_NEXT(srtp, sdp_srtp_list);
 srtp;
 srtp = next, next = srtp ? AST_LIST_NEXT(srtp, sdp_srtp_list) : NULL) {
 ast_sdp_crypto_destroy(srtp->crypto);
 srtp->crypto = NULL;
 ast_free(srtp);
 }
}

void ast_sdp_crypto_destroy(struct ast_sdp_crypto *crypto)
{
 if (sdp_crypto_api) {
 sdp_crypto_api->dtor(crypto);
 }
}

struct ast_sdp_crypto *ast_sdp_crypto_alloc(void)
{
 if (!sdp_crypto_api) {
 return NULL;
 }
 return sdp_crypto_api->alloc();
}

int ast_sdp_crypto_process(struct ast_rtp_instance *rtp, struct ast_sdp_srtp *srtp, const char *attr)
{
 if (!sdp_crypto_api) {
 return -1;
 }
 return sdp_crypto_api->parse_offer(rtp, srtp, attr);
}

int ast_sdp_crypto_build_offer(struct ast_sdp_crypto *p, int taglen)
{
 if (!sdp_crypto_api) {
 return -1;
 }
 return sdp_crypto_api->build_offer(p, taglen);
}

const char *ast_sdp_srtp_get_attrib(struct ast_sdp_srtp *srtp, int dtls_enabled, int default_taglen_32)
{
 if (!sdp_crypto_api) {
 return NULL;
 }
 return sdp_crypto_api->get_attr(srtp, dtls_enabled, default_taglen_32);
}

char *ast_sdp_get_rtp_profile(unsigned int sdes_active, struct ast_rtp_instance *instance, unsigned int using_avpf,
 unsigned int force_avp)
{
 struct ast_rtp_engine_dtls *dtls;

 if ((dtls = ast_rtp_instance_get_dtls(instance)) && dtls->active(instance)) {
 if (force_avp) {
 return using_avpf ? "RTP/SAVPF" : "RTP/SAVP";
 } else {
 return using_avpf ? "UDP/TLS/RTP/SAVPF" : "UDP/TLS/RTP/SAVP";
 }
 } else {
 if (using_avpf) {
 return sdes_active ? "RTP/SAVPF" : "RTP/AVPF";
 } else {
 return sdes_active ? "RTP/SAVP" : "RTP/AVP";
 }
 }
}

int ast_sdp_crypto_register(struct ast_sdp_crypto_api *api)
{
 if (sdp_crypto_api) {
 return -1;
 }
 sdp_crypto_api = api;
 return 0;
}

void ast_sdp_crypto_unregister(struct ast_sdp_crypto_api *api)
{
 if (sdp_crypto_api == api) {
 sdp_crypto_api = NULL;
 }
}