/*
* Secure RTP with libgcrypt
- * Copyright (C) 2007 Rémi Denis-Courmont <rdenis # simphalempin , com>
+ * Copyright (C) 2007 Rémi Denis-Courmont
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
+/* TODO:
+ * Useless stuff (because nothing depends on it):
+ * - non-nul key derivation rate
+ * - MKI payload
+ */
+
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif
#include <gcrypt.h>
-#define debug( ... ) (void)0
+#ifdef WIN32
+# include <winsock2.h>
+#else
+# include <netinet/in.h>
+# include <pthread.h>
+GCRY_THREAD_OPTION_PTHREAD_IMPL;
+#endif
-/* TODO:
- * Useful stuff:
- * - ROC profile thingy (multicast really needs this)
- *
- * Useless stuff (because nothing depends on it):
- * - non-nul key derivation rate
- * - MKI payload
- */
+#define debug( ... ) (void)0
typedef struct srtp_proto_t
{
};
-#ifdef WIN32
-# include <winsock2.h>
-#else
-# include <netinet/in.h>
-# include <pthread.h>
-GCRY_THREAD_OPTION_PTHREAD_IMPL;
-#endif
+static inline unsigned rcc_mode (const srtp_session_t *s)
+{
+ return (s->flags >> 4) & 3;
+}
static bool libgcrypt_usable = false;
static void initonce_libgcrypt (void)
{
- if ((gcry_check_version ("1.1.94") == NULL)
- || gcry_control (GCRYCTL_DISABLE_SECMEM, 0)
- || gcry_control (GCRYCTL_INITIALIZATION_FINISHED, 0)
#ifndef WIN32
- || gcry_control (GCRYCTL_SET_THREAD_CBS, &gcry_threads_pthread)
+ gcry_control (GCRYCTL_SET_THREAD_CBS, &gcry_threads_pthread);
#endif
- )
+
+ if ((gcry_check_version ("1.1.94") == NULL)
+ || gcry_control (GCRYCTL_DISABLE_SECMEM, 0)
+ || gcry_control (GCRYCTL_INITIALIZATION_FINISHED, 0))
return;
libgcrypt_usable = true;
{
int retval;
#ifndef WIN32
- static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
static pthread_once_t once = PTHREAD_ONCE_INIT;
- pthread_mutex_lock (&mutex);
pthread_once (&once, initonce_libgcrypt);
- retval = -libgcrypt_usable;
- pthread_mutex_unlock (&mutex);
#else
# warning FIXME: This is not thread-safe.
if (!libgcrypt_usable)
initonce_libgcrypt ();
- retval = -libgcrypt_usable;
#endif
+ retval = libgcrypt_usable ? 0 : -1;
+
return retval;
}
return NULL;
}
- if (tag_len > gcry_md_get_algo_dlen (auth))
+ if (tag_len > gcry_md_get_algo_dlen (md))
return NULL;
if (prf != SRTP_PRF_AES_CM)
memset (s, 0, sizeof (*s));
s->flags = flags;
s->tag_len = tag_len;
+ s->rtp_rcc = 1; /* Default RCC rate */
+ if (rcc_mode (s))
+ {
+ if (tag_len < 4)
+ goto error;
+ }
if (proto_create (&s->rtp, cipher, md) == 0)
{
proto_destroy (&s->rtp);
}
+error:
free (s);
return NULL;
}
|| gcry_cipher_setkey (prf, key, keylen))
return -1;
+#if 0
/* RTP key derivation */
if (s->kdr != 0)
{
}
}
else
+#endif
memset (r, 0, sizeof (r));
if (proto_derive (&s->rtp, prf, salt, saltlen, r, 6, false))
return srtp_derive (s, key, keylen, salt, saltlen) ? EINVAL : 0;
}
+static int hexdigit (char c)
+{
+ if ((c >= '0') && (c <= '9'))
+ return c - '0';
+ if ((c >= 'A') && (c <= 'F'))
+ return c - 'A' + 0xA;
+ if ((c >= 'a') && (c <= 'f'))
+ return c - 'a' + 0xa;
+ return -1;
+}
+
+static ssize_t hexstring (const char *in, uint8_t *out, size_t outlen)
+{
+ size_t inlen = strlen (in);
+
+ if ((inlen > (2 * outlen)) || (inlen & 1))
+ return -1;
+
+ for (size_t i = 0; i < inlen; i += 2)
+ {
+ int a = hexdigit (in[i]), b = hexdigit (in[i + 1]);
+ if ((a == -1) || (b == -1))
+ return -1;
+ out[i / 2] = (a << 4) | b;
+ }
+ return inlen / 2;
+}
+
+/**
+ * Sets (or resets) the master key and master salt for a SRTP session
+ * from hexadecimal strings. See also srtp_setkey().
+ *
+ * @return 0 on success, in case of error:
+ * EINVAL invalid or unsupported key/salt sizes combination
+ */
+int
+srtp_setkeystring (srtp_session_t *s, const char *key, const char *salt)
+{
+ uint8_t bkey[16]; /* TODO/NOTE: hard-coded for AES */
+ uint8_t bsalt[14]; /* TODO/NOTE: hard-coded for the PRF-AES-CM */
+ ssize_t bkeylen = hexstring (key, bkey, sizeof (bkey));
+ ssize_t bsaltlen = hexstring (salt, bsalt, sizeof (bsalt));
+
+ if ((bkeylen == -1) || (bsaltlen == -1))
+ return EINVAL;
+ return srtp_setkey (s, bkey, bkeylen, bsalt, bsaltlen) ? EINVAL : 0;
+}
/**
* Sets Roll-over-Counter Carry (RCC) rate for the SRTP session. If not
/** Message Authentication and Integrity for RTP */
static const uint8_t *
-rtp_digest (srtp_session_t *s, const uint8_t *data, size_t len)
+rtp_digest (srtp_session_t *s, const uint8_t *data, size_t len,
+ uint32_t roc)
{
const gcry_md_hd_t md = s->rtp.mac;
- uint32_t roc = htonl (srtp_compute_roc (s, rtp_seq (data)));
gcry_md_reset (md);
gcry_md_write (md, data, len);
- gcry_md_write (md, &roc, 4);
+ gcry_md_write (md, &(uint32_t){ htonl (roc) }, 4);
return gcry_md_read (md, 0);
}
*
* @param buf RTP packet to be encrypted/digested
* @param lenp pointer to the RTP packet length on entry,
- * set to the SRTP length on exit (undefined in case of error)
+ * set to the SRTP length on exit (undefined on non-ENOSPC error)
* @param bufsize size (bytes) of the packet buffer
*
* @return 0 on success, in case of error:
* EINVAL malformatted RTP packet or internal error
- * ENOSPC bufsize is too small (to add authentication tag)
+ * ENOSPC bufsize is too small to add authentication tag
+ * (<lenp> will hold the required byte size)
* EACCES packet would trigger a replay error on receiver
*/
int
srtp_send (srtp_session_t *s, uint8_t *buf, size_t *lenp, size_t bufsize)
{
size_t len = *lenp;
+ size_t tag_len = s->tag_len;
+
+ if (!(s->flags & SRTP_UNAUTHENTICATED))
+ {
+ *lenp = len + tag_len;
+ if (bufsize < (len + tag_len))
+ return ENOSPC;
+ }
+
int val = srtp_crypt (s, buf, len);
if (val)
return val;
if (!(s->flags & SRTP_UNAUTHENTICATED))
{
- if (bufsize < (len + s->tag_len))
- return ENOSPC;
-
- const uint8_t *tag = rtp_digest (s, buf, len);
- memcpy (buf + len, tag, s->tag_len);
- *lenp = len + s->tag_len;
+ uint32_t roc = srtp_compute_roc (s, rtp_seq (buf));
+ const uint8_t *tag = rtp_digest (s, buf, len, roc);
+ if (rcc_mode (s))
+ {
+ assert (s->rtp_rcc);
+ if ((rtp_seq (buf) % s->rtp_rcc) == 0)
+ {
+ memcpy (buf + len, &(uint32_t){ htonl (s->rtp_roc) }, 4);
+ len += 4;
+ if (rcc_mode (s) == 3)
+ tag_len = 0;
+ else
+ tag_len -= 4;
+ }
+ else
+ {
+ if (rcc_mode (s) & 1)
+ tag_len = 0;
+ }
+ }
+ memcpy (buf + len, tag, tag_len);
}
return 0;
srtp_recv (srtp_session_t *s, uint8_t *buf, size_t *lenp)
{
size_t len = *lenp;
+ if (len < 12u)
+ return EINVAL;
if (!(s->flags & SRTP_UNAUTHENTICATED))
{
- if (len < (12u + s->tag_len))
+ size_t tag_len = s->tag_len, roc_len = 0;
+ if (rcc_mode (s))
+ {
+ if ((rtp_seq (buf) % s->rtp_rcc) == 0)
+ {
+ roc_len = 4;
+ if (rcc_mode (s) == 3)
+ tag_len = 0;
+ else
+ tag_len -= 4;
+ }
+ else
+ {
+ if (rcc_mode (s) & 1)
+ tag_len = 0; // RCC mode 1 or 3: no auth
+ }
+ }
+
+ if (len < (12u + roc_len + tag_len))
return EINVAL;
- len -= s->tag_len;
+ len -= roc_len + tag_len;
- const uint8_t *tag = rtp_digest (s, buf, len);
- if (memcmp (buf + len, tag, s->tag_len))
+ uint32_t roc = srtp_compute_roc (s, rtp_seq (buf)), rcc;
+ if (roc_len)
+ {
+ assert (roc_len == 4);
+ memcpy (&rcc, buf + len, 4);
+ rcc = ntohl (rcc);
+ }
+ else
+ rcc = roc;
+
+ const uint8_t *tag = rtp_digest (s, buf, len, rcc);
+#if 0
+ printf ("Computed: 0x");
+ for (unsigned i = 0; i < tag_len; i++)
+ printf ("%02x", tag[i]);
+ printf ("\nReceived: 0x");
+ for (unsigned i = 0; i < tag_len; i++)
+ printf ("%02x", buf[len + roc_len + i]);
+ puts ("");
+#endif
+ if (memcmp (buf + len + roc_len, tag, tag_len))
return EACCES;
+ if (roc_len)
+ {
+ /* Authenticated packet carried a Roll-Over-Counter */
+ s->rtp_roc += rcc - roc;
+ assert (srtp_compute_roc (s, rtp_seq (buf)) == rcc);
+ }
*lenp = len;
}
projects / vlc / blobdiff