History

lavf: Add functions for SRTP decryption/encryption

This supports the AES_CM_128_HMAC_SHA1_80 and AES_CM_128_HMAC_SHA1_32 cipher suites (from RFC 4568) at the moment. The main missing features are replay protection (which can be added later without changing the internal API), and the F8 and null ciphers.

Martin Storsjö committed 14 years ago

Commit ab2ad8b1 parent 8ee288d2 files · +345 −0Browse files

Unified · Split

2 files
  1. libavformat/srtp.c +293 −0
  2. libavformat/srtp.h +52 −0
libavformat/srtp.c+293−0
@@ -0,0 +1,293 @@
1/*
2 * SRTP encryption/decryption
3 * Copyright (c) 2012 Martin Storsjo
4 *
5 * This file is part of Libav.
6 *
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22#include "libavutil/base64.h"
23#include "libavutil/aes.h"
24#include "libavutil/hmac.h"
25#include "libavutil/intreadwrite.h"
26#include "libavutil/log.h"
27#include "rtp.h"
28#include "srtp.h"
29
30void ff_srtp_free(struct SRTPContext *s)
31{
32 if (!s)
33 return;
34 av_freep(&s->aes);
35 if (s->hmac)
36 av_hmac_free(s->hmac);
37 s->hmac = NULL;
38}
39
40static void encrypt_counter(struct AVAES *aes, uint8_t *iv, uint8_t *outbuf,
41 int outlen)
42{
43 int i, j, outpos;
44 for (i = 0, outpos = 0; outpos < outlen; i++) {
45 uint8_t keystream[16];
46 AV_WB16(&iv[14], i);
47 av_aes_crypt(aes, keystream, iv, 1, NULL, 0);
48 for (j = 0; j < 16 && outpos < outlen; j++, outpos++)
49 outbuf[outpos] ^= keystream[j];
50 }
51}
52
53static void derive_key(struct AVAES *aes, const uint8_t *salt, int label,
54 uint8_t *out, int outlen)
55{
56 uint8_t input[16] = { 0 };
57 memcpy(input, salt, 14);
58 // Key derivation rate assumed to be zero
59 input[14 - 7] ^= label;
60 memset(out, 0, outlen);
61 encrypt_counter(aes, input, out, outlen);
62}
63
64int ff_srtp_set_crypto(struct SRTPContext *s, const char *suite,
65 const char *params)
66{
67 uint8_t buf[30];
68
69 ff_srtp_free(s);
70
71 // RFC 4568
72 if (!strcmp(suite, "AES_CM_128_HMAC_SHA1_80")) {
73 s->hmac_size = 10;
74 } else if (!strcmp(suite, "AES_CM_128_HMAC_SHA1_32")) {
75 s->hmac_size = 4;
76 } else {
77 av_log(NULL, AV_LOG_WARNING, "SRTP Crypto suite %s not supported\n",
78 suite);
79 return AVERROR(EINVAL);
80 }
81 if (av_base64_decode(buf, params, sizeof(buf)) != sizeof(buf)) {
82 av_log(NULL, AV_LOG_WARNING, "Incorrect amount of SRTP params\n");
83 return AVERROR(EINVAL);
84 }
85 // MKI and lifetime not handled yet
86 s->aes = av_aes_alloc();
87 s->hmac = av_hmac_alloc(AV_HMAC_SHA1);
88 if (!s->aes || !s->hmac)
89 return AVERROR(ENOMEM);
90 memcpy(s->master_key, buf, 16);
91 memcpy(s->master_salt, buf + 16, 14);
92
93 // RFC 3711
94 av_aes_init(s->aes, s->master_key, 128, 0);
95
96 derive_key(s->aes, s->master_salt, 0x00, s->rtp_key, sizeof(s->rtp_key));
97 derive_key(s->aes, s->master_salt, 0x02, s->rtp_salt, sizeof(s->rtp_salt));
98 derive_key(s->aes, s->master_salt, 0x01, s->rtp_auth, sizeof(s->rtp_auth));
99
100 derive_key(s->aes, s->master_salt, 0x03, s->rtcp_key, sizeof(s->rtcp_key));
101 derive_key(s->aes, s->master_salt, 0x05, s->rtcp_salt, sizeof(s->rtcp_salt));
102 derive_key(s->aes, s->master_salt, 0x04, s->rtcp_auth, sizeof(s->rtcp_auth));
103 return 0;
104}
105
106static void create_iv(uint8_t *iv, const uint8_t *salt, uint64_t index,
107 uint32_t ssrc)
108{
109 uint8_t indexbuf[8];
110 int i;
111 memset(iv, 0, 16);
112 AV_WB32(&iv[4], ssrc);
113 AV_WB64(indexbuf, index);
114 for (i = 0; i < 8; i++) // index << 16
115 iv[6 + i] ^= indexbuf[i];
116 for (i = 0; i < 14; i++)
117 iv[i] ^= salt[i];
118}
119
120int ff_srtp_decrypt(struct SRTPContext *s, uint8_t *buf, int *lenptr)
121{
122 uint8_t iv[16] = { 0 }, hmac[20];
123 int len = *lenptr;
124 int ext, seq_largest;
125 uint32_t ssrc, roc;
126 uint64_t index;
127 int rtcp;
128
129 // TODO: Missing replay protection
130
131 if (len < s->hmac_size)
132 return AVERROR_INVALIDDATA;
133
134 rtcp = RTP_PT_IS_RTCP(buf[1]);
135
136 // Authentication HMAC
137 av_hmac_init(s->hmac, rtcp ? s->rtcp_auth : s->rtp_auth, sizeof(s->rtp_auth));
138 // If MKI is used, this should exclude the MKI as well
139 av_hmac_update(s->hmac, buf, len - s->hmac_size);
140
141 if (!rtcp) {
142 int seq = AV_RB16(buf + 2);
143 uint32_t v;
144 uint8_t rocbuf[4];
145
146 // RFC 3711 section 3.3.1, appendix A
147 seq_largest = s->seq_initialized ? s->seq_largest : seq;
148 v = roc = s->roc;
149 if (seq_largest < 32768) {
150 if (seq - seq_largest > 32768)
151 v = roc - 1;
152 } else {
153 if (seq_largest - 32768 > seq)
154 v = roc + 1;
155 }
156 if (v == roc) {
157 seq_largest = FFMAX(seq_largest, seq);
158 } else if (v == roc + 1) {
159 seq_largest = seq;
160 roc = v;
161 }
162 index = seq + (((uint64_t)v) << 16);
163
164 AV_WB32(rocbuf, roc);
165 av_hmac_update(s->hmac, rocbuf, 4);
166 }
167
168 av_hmac_final(s->hmac, hmac, sizeof(hmac));
169 if (memcmp(hmac, buf + len - s->hmac_size, s->hmac_size)) {
170 av_log(NULL, AV_LOG_WARNING, "HMAC mismatch\n");
171 return AVERROR_INVALIDDATA;
172 }
173
174 len -= s->hmac_size;
175 *lenptr = len;
176
177 if (len < 12)
178 return AVERROR_INVALIDDATA;
179
180 if (rtcp) {
181 uint32_t srtcp_index = AV_RB32(buf + len - 4);
182 len -= 4;
183 *lenptr = len;
184
185 ssrc = AV_RB32(buf + 4);
186 index = srtcp_index & 0x7fffffff;
187
188 buf += 8;
189 len -= 8;
190 if (!(srtcp_index & 0x80000000))
191 return 0;
192 } else {
193 s->seq_initialized = 1;
194 s->seq_largest = seq_largest;
195 s->roc = roc;
196
197 ext = buf[0] & 0x10;
198 ssrc = AV_RB32(buf + 8);
199
200 buf += 12;
201 len -= 12;
202
203 if (ext) {
204 if (len < 4)
205 return AVERROR_INVALIDDATA;
206 ext = (AV_RB16(buf + 2) + 1) * 4;
207 if (len < ext)
208 return AVERROR_INVALIDDATA;
209 len -= ext;
210 buf += ext;
211 }
212 }
213
214 create_iv(iv, rtcp ? s->rtcp_salt : s->rtp_salt, index, ssrc);
215 av_aes_init(s->aes, rtcp ? s->rtcp_key : s->rtp_key, 128, 0);
216 encrypt_counter(s->aes, iv, buf, len);
217
218 return 0;
219}
220
221int ff_srtp_encrypt(struct SRTPContext *s, const uint8_t *in, int len,
222 uint8_t *out, int outlen)
223{
224 uint8_t iv[16] = { 0 }, hmac[20];
225 uint64_t index;
226 uint32_t ssrc;
227 int rtcp;
228 uint8_t *buf;
229
230 if (len + 14 > outlen)
231 return 0;
232 if (len < 12)
233 return 0;
234
235 memcpy(out, in, len);
236 buf = out;
237
238 rtcp = RTP_PT_IS_RTCP(buf[1]);
239
240 if (rtcp) {
241 ssrc = AV_RB32(buf + 4);
242 index = s->rtcp_index++;
243
244 buf += 8;
245 len -= 8;
246 } else {
247 int ext;
248 int seq = AV_RB16(buf + 2);
249 ssrc = AV_RB32(buf + 8);
250
251 if (seq < s->seq_largest)
252 s->roc++;
253 s->seq_largest = seq;
254 index = seq + (((uint64_t)s->roc) << 16);
255
256 ext = buf[0] & 0x10;
257
258 buf += 12;
259 len -= 12;
260
261 if (ext) {
262 if (len < 4)
263 return AVERROR_INVALIDDATA;
264 ext = (AV_RB16(buf + 2) + 1) * 4;
265 if (len < ext)
266 return AVERROR_INVALIDDATA;
267 len -= ext;
268 buf += ext;
269 }
270 }
271
272 create_iv(iv, rtcp ? s->rtcp_salt : s->rtp_salt, index, ssrc);
273 av_aes_init(s->aes, rtcp ? s->rtcp_key : s->rtp_key, 128, 0);
274 encrypt_counter(s->aes, iv, buf, len);
275
276 if (rtcp) {
277 AV_WB32(buf + len, 0x80000000 | index);
278 len += 4;
279 }
280
281 av_hmac_init(s->hmac, rtcp ? s->rtcp_auth : s->rtp_auth, sizeof(s->rtp_auth));
282 av_hmac_update(s->hmac, out, buf + len - out);
283 if (!rtcp) {
284 uint8_t rocbuf[4];
285 AV_WB32(rocbuf, s->roc);
286 av_hmac_update(s->hmac, rocbuf, 4);
287 }
288 av_hmac_final(s->hmac, hmac, sizeof(hmac));
289
290 memcpy(buf + len, hmac, s->hmac_size);
291 len += s->hmac_size;
292 return buf + len - out;
293}
libavformat/srtp.h+52−0
@@ -0,0 +1,52 @@
1/*
2 * SRTP encryption/decryption
3 * Copyright (c) 2012 Martin Storsjo
4 *
5 * This file is part of Libav.
6 *
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22#ifndef AVFORMAT_SRTP_H
23#define AVFORMAT_SRTP_H
24
25#include <stdint.h>
26
27struct AVAES;
28struct AVHMAC;
29
30struct SRTPContext {
31 struct AVAES *aes;
32 struct AVHMAC *hmac;
33 int hmac_size;
34 uint8_t master_key[16];
35 uint8_t master_salt[14];
36 uint8_t rtp_key[16], rtcp_key[16];
37 uint8_t rtp_salt[14], rtcp_salt[14];
38 uint8_t rtp_auth[20], rtcp_auth[20];
39 int seq_largest, seq_initialized;
40 uint32_t roc;
41
42 uint32_t rtcp_index;
43};
44
45int ff_srtp_set_crypto(struct SRTPContext *s, const char *suite,
46 const char *params);
47void ff_srtp_free(struct SRTPContext *s);
48int ff_srtp_decrypt(struct SRTPContext *s, uint8_t *buf, int *lenptr);
49int ff_srtp_encrypt(struct SRTPContext *s, const uint8_t *in, int len,
50 uint8_t *out, int outlen);
51
52#endif /* AVFORMAT_SRTP_H */

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t