2 * Copyright (c) 2015 Hendrik Leppkes
4 * This file is part of FFmpeg.
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 /** Based on the CURL SChannel module */
26 #include "os_support.h"
30 #define SECURITY_WIN32
35 #define SCHANNEL_INITIAL_BUFFER_SIZE 4096
36 #define SCHANNEL_FREE_BUFFER_SIZE 1024
38 /* mingw does not define this symbol */
39 #ifndef SECBUFFER_ALERT
40 #define SECBUFFER_ALERT 17
43 typedef struct TLSContext {
47 CredHandle cred_handle;
48 TimeStamp cred_timestamp;
50 CtxtHandle ctxt_handle;
51 TimeStamp ctxt_timestamp;
64 SecPkgContext_StreamSizes sizes;
67 int connection_closed;
68 int sspi_close_notify;
71 static void init_sec_buffer(SecBuffer *buffer, unsigned long type,
72 void *data, unsigned long size)
74 buffer->cbBuffer = size;
75 buffer->BufferType = type;
76 buffer->pvBuffer = data;
79 static void init_sec_buffer_desc(SecBufferDesc *desc, SecBuffer *buffers,
80 unsigned long buffer_count)
82 desc->ulVersion = SECBUFFER_VERSION;
83 desc->pBuffers = buffers;
84 desc->cBuffers = buffer_count;
87 static int tls_shutdown_client(URLContext *h)
89 TLSContext *c = h->priv_data;
90 TLSShared *s = &c->tls_shared;
94 SecBufferDesc BuffDesc;
96 SECURITY_STATUS sspi_ret;
98 SecBufferDesc outbuf_desc;
100 DWORD dwshut = SCHANNEL_SHUTDOWN;
101 init_sec_buffer(&Buffer, SECBUFFER_TOKEN, &dwshut, sizeof(dwshut));
102 init_sec_buffer_desc(&BuffDesc, &Buffer, 1);
104 sspi_ret = ApplyControlToken(&c->ctxt_handle, &BuffDesc);
105 if (sspi_ret != SEC_E_OK)
106 av_log(h, AV_LOG_ERROR, "ApplyControlToken failed\n");
108 init_sec_buffer(&outbuf, SECBUFFER_EMPTY, NULL, 0);
109 init_sec_buffer_desc(&outbuf_desc, &outbuf, 1);
111 sspi_ret = InitializeSecurityContext(&c->cred_handle, &c->ctxt_handle, s->host,
112 c->request_flags, 0, 0, NULL, 0, &c->ctxt_handle,
113 &outbuf_desc, &c->context_flags, &c->ctxt_timestamp);
114 if (sspi_ret == SEC_E_OK || sspi_ret == SEC_I_CONTEXT_EXPIRED) {
115 ret = ffurl_write(s->tcp, outbuf.pvBuffer, outbuf.cbBuffer);
116 FreeContextBuffer(outbuf.pvBuffer);
117 if (ret < 0 || ret != outbuf.cbBuffer)
118 av_log(h, AV_LOG_ERROR, "Failed to send close message\n");
126 static int tls_close(URLContext *h)
128 TLSContext *c = h->priv_data;
130 tls_shutdown_client(h);
132 DeleteSecurityContext(&c->ctxt_handle);
133 FreeCredentialsHandle(&c->cred_handle);
135 av_freep(&c->enc_buf);
136 c->enc_buf_size = c->enc_buf_offset = 0;
138 av_freep(&c->dec_buf);
139 c->dec_buf_size = c->dec_buf_offset = 0;
141 ffurl_closep(&c->tls_shared.tcp);
145 static int tls_client_handshake_loop(URLContext *h, int initial)
147 TLSContext *c = h->priv_data;
148 TLSShared *s = &c->tls_shared;
149 SECURITY_STATUS sspi_ret;
150 SecBuffer outbuf[3] = { 0 };
151 SecBufferDesc outbuf_desc;
153 SecBufferDesc inbuf_desc;
154 int i, ret = 0, read_data = initial;
156 if (c->enc_buf == NULL) {
157 c->enc_buf_offset = 0;
158 ret = av_reallocp(&c->enc_buf, SCHANNEL_INITIAL_BUFFER_SIZE);
161 c->enc_buf_size = SCHANNEL_INITIAL_BUFFER_SIZE;
164 if (c->dec_buf == NULL) {
165 c->dec_buf_offset = 0;
166 ret = av_reallocp(&c->dec_buf, SCHANNEL_INITIAL_BUFFER_SIZE);
169 c->dec_buf_size = SCHANNEL_INITIAL_BUFFER_SIZE;
173 if (c->enc_buf_size - c->enc_buf_offset < SCHANNEL_FREE_BUFFER_SIZE) {
174 c->enc_buf_size = c->enc_buf_offset + SCHANNEL_FREE_BUFFER_SIZE;
175 ret = av_reallocp(&c->enc_buf, c->enc_buf_size);
177 c->enc_buf_size = c->enc_buf_offset = 0;
183 ret = ffurl_read(c->tls_shared.tcp, c->enc_buf + c->enc_buf_offset,
184 c->enc_buf_size - c->enc_buf_offset);
186 av_log(h, AV_LOG_ERROR, "Failed to read handshake response\n");
189 c->enc_buf_offset += ret;
193 init_sec_buffer(&inbuf[0], SECBUFFER_TOKEN, av_malloc(c->enc_buf_offset), c->enc_buf_offset);
194 init_sec_buffer(&inbuf[1], SECBUFFER_EMPTY, NULL, 0);
195 init_sec_buffer_desc(&inbuf_desc, inbuf, 2);
197 if (inbuf[0].pvBuffer == NULL) {
198 av_log(h, AV_LOG_ERROR, "Failed to allocate input buffer\n");
199 ret = AVERROR(ENOMEM);
203 memcpy(inbuf[0].pvBuffer, c->enc_buf, c->enc_buf_offset);
206 init_sec_buffer(&outbuf[0], SECBUFFER_TOKEN, NULL, 0);
207 init_sec_buffer(&outbuf[1], SECBUFFER_ALERT, NULL, 0);
208 init_sec_buffer(&outbuf[2], SECBUFFER_EMPTY, NULL, 0);
209 init_sec_buffer_desc(&outbuf_desc, outbuf, 3);
211 sspi_ret = InitializeSecurityContext(&c->cred_handle, &c->ctxt_handle, s->host, c->request_flags,
212 0, 0, &inbuf_desc, 0, NULL, &outbuf_desc, &c->context_flags,
214 av_freep(&inbuf[0].pvBuffer);
216 if (sspi_ret == SEC_E_INCOMPLETE_MESSAGE) {
217 av_log(h, AV_LOG_DEBUG, "Received incomplete handshake, need more data\n");
222 /* remote requests a client certificate - attempt to continue without one anyway */
223 if (sspi_ret == SEC_I_INCOMPLETE_CREDENTIALS &&
224 !(c->request_flags & ISC_REQ_USE_SUPPLIED_CREDS)) {
225 av_log(h, AV_LOG_VERBOSE, "Client certificate has been requested, ignoring\n");
226 c->request_flags |= ISC_REQ_USE_SUPPLIED_CREDS;
231 /* continue handshake */
232 if (sspi_ret == SEC_I_CONTINUE_NEEDED || sspi_ret == SEC_E_OK) {
233 for (i = 0; i < 3; i++) {
234 if (outbuf[i].BufferType == SECBUFFER_TOKEN && outbuf[i].cbBuffer > 0) {
235 ret = ffurl_write(c->tls_shared.tcp, outbuf[i].pvBuffer, outbuf[i].cbBuffer);
236 if (ret < 0 || ret != outbuf[i].cbBuffer) {
237 av_log(h, AV_LOG_VERBOSE, "Failed to send handshake data\n");
243 if (outbuf[i].pvBuffer != NULL) {
244 FreeContextBuffer(outbuf[i].pvBuffer);
245 outbuf[i].pvBuffer = NULL;
249 if (sspi_ret == SEC_E_WRONG_PRINCIPAL)
250 av_log(h, AV_LOG_ERROR, "SNI or certificate check failed\n");
252 av_log(h, AV_LOG_ERROR, "Creating security context failed (0x%lx)\n", sspi_ret);
253 ret = AVERROR_UNKNOWN;
257 if (inbuf[1].BufferType == SECBUFFER_EXTRA && inbuf[1].cbBuffer > 0) {
258 if (c->enc_buf_offset > inbuf[1].cbBuffer) {
259 memmove(c->enc_buf, (c->enc_buf + c->enc_buf_offset) - inbuf[1].cbBuffer,
261 c->enc_buf_offset = inbuf[1].cbBuffer;
262 if (sspi_ret == SEC_I_CONTINUE_NEEDED) {
268 c->enc_buf_offset = 0;
271 if (sspi_ret == SEC_I_CONTINUE_NEEDED) {
282 /* free any remaining output data */
283 for (i = 0; i < 3; i++) {
284 if (outbuf[i].pvBuffer != NULL) {
285 FreeContextBuffer(outbuf[i].pvBuffer);
286 outbuf[i].pvBuffer = NULL;
293 static int tls_client_handshake(URLContext *h)
295 TLSContext *c = h->priv_data;
296 TLSShared *s = &c->tls_shared;
298 SecBufferDesc outbuf_desc;
299 SECURITY_STATUS sspi_ret;
302 init_sec_buffer(&outbuf, SECBUFFER_EMPTY, NULL, 0);
303 init_sec_buffer_desc(&outbuf_desc, &outbuf, 1);
305 c->request_flags = ISC_REQ_SEQUENCE_DETECT | ISC_REQ_REPLAY_DETECT |
306 ISC_REQ_CONFIDENTIALITY | ISC_REQ_ALLOCATE_MEMORY |
309 sspi_ret = InitializeSecurityContext(&c->cred_handle, NULL, s->host, c->request_flags, 0, 0,
310 NULL, 0, &c->ctxt_handle, &outbuf_desc, &c->context_flags,
312 if (sspi_ret != SEC_I_CONTINUE_NEEDED) {
313 av_log(h, AV_LOG_ERROR, "Unable to create initial security context (0x%lx)\n", sspi_ret);
314 ret = AVERROR_UNKNOWN;
318 ret = ffurl_write(s->tcp, outbuf.pvBuffer, outbuf.cbBuffer);
319 FreeContextBuffer(outbuf.pvBuffer);
320 if (ret < 0 || ret != outbuf.cbBuffer) {
321 av_log(h, AV_LOG_ERROR, "Failed to send initial handshake data\n");
326 return tls_client_handshake_loop(h, 1);
329 DeleteSecurityContext(&c->ctxt_handle);
333 static int tls_open(URLContext *h, const char *uri, int flags, AVDictionary **options)
335 TLSContext *c = h->priv_data;
336 TLSShared *s = &c->tls_shared;
337 SECURITY_STATUS sspi_ret;
338 SCHANNEL_CRED schannel_cred = { 0 };
341 if ((ret = ff_tls_open_underlying(s, h, uri, options)) < 0)
345 av_log(h, AV_LOG_ERROR, "TLS Listen Sockets with SChannel is not implemented.\n");
346 ret = AVERROR(EINVAL);
350 /* SChannel Options */
351 schannel_cred.dwVersion = SCHANNEL_CRED_VERSION;
354 schannel_cred.dwFlags = SCH_CRED_AUTO_CRED_VALIDATION |
355 SCH_CRED_REVOCATION_CHECK_CHAIN;
357 schannel_cred.dwFlags = SCH_CRED_MANUAL_CRED_VALIDATION |
358 SCH_CRED_IGNORE_NO_REVOCATION_CHECK |
359 SCH_CRED_IGNORE_REVOCATION_OFFLINE;
361 /* Get credential handle */
362 sspi_ret = AcquireCredentialsHandle(NULL, (TCHAR *)UNISP_NAME, SECPKG_CRED_OUTBOUND,
363 NULL, &schannel_cred, NULL, NULL, &c->cred_handle,
365 if (sspi_ret != SEC_E_OK) {
366 av_log(h, AV_LOG_ERROR, "Unable to acquire security credentials (0x%lx)\n", sspi_ret);
367 ret = AVERROR_UNKNOWN;
371 ret = tls_client_handshake(h);
384 static int tls_read(URLContext *h, uint8_t *buf, int len)
386 TLSContext *c = h->priv_data;
387 TLSShared *s = &c->tls_shared;
388 SECURITY_STATUS sspi_ret = SEC_E_OK;
390 SecBufferDesc inbuf_desc;
392 int min_enc_buf_size = len + SCHANNEL_FREE_BUFFER_SIZE;
394 /* If we have some left-over data from previous network activity,
395 * return it first in case it is enough. It may contain
396 * data that is required to know whether this connection
397 * is still required or not, esp. in case of HTTP keep-alive
399 if (c->dec_buf_offset > 0)
402 if (c->sspi_close_notify)
405 if (!c->connection_closed) {
406 size = c->enc_buf_size - c->enc_buf_offset;
407 if (size < SCHANNEL_FREE_BUFFER_SIZE || c->enc_buf_size < min_enc_buf_size) {
408 c->enc_buf_size = c->enc_buf_offset + SCHANNEL_FREE_BUFFER_SIZE;
409 if (c->enc_buf_size < min_enc_buf_size)
410 c->enc_buf_size = min_enc_buf_size;
411 ret = av_reallocp(&c->enc_buf, c->enc_buf_size);
413 c->enc_buf_size = c->enc_buf_offset = 0;
418 ret = ffurl_read(s->tcp, c->enc_buf + c->enc_buf_offset,
419 c->enc_buf_size - c->enc_buf_offset);
420 if (ret == AVERROR_EOF) {
421 c->connection_closed = 1;
423 } else if (ret < 0) {
424 av_log(h, AV_LOG_ERROR, "Unable to read from socket\n");
428 c->enc_buf_offset += ret;
431 while (c->enc_buf_offset > 0 && sspi_ret == SEC_E_OK) {
433 init_sec_buffer(&inbuf[0], SECBUFFER_DATA, c->enc_buf, c->enc_buf_offset);
435 /* additional buffers for possible output */
436 init_sec_buffer(&inbuf[1], SECBUFFER_EMPTY, NULL, 0);
437 init_sec_buffer(&inbuf[2], SECBUFFER_EMPTY, NULL, 0);
438 init_sec_buffer(&inbuf[3], SECBUFFER_EMPTY, NULL, 0);
439 init_sec_buffer_desc(&inbuf_desc, inbuf, 4);
441 sspi_ret = DecryptMessage(&c->ctxt_handle, &inbuf_desc, 0, NULL);
442 if (sspi_ret == SEC_E_OK || sspi_ret == SEC_I_RENEGOTIATE ||
443 sspi_ret == SEC_I_CONTEXT_EXPIRED) {
444 /* handle decrypted data */
445 if (inbuf[1].BufferType == SECBUFFER_DATA) {
446 /* grow buffer if needed */
447 size = inbuf[1].cbBuffer > SCHANNEL_FREE_BUFFER_SIZE ?
448 inbuf[1].cbBuffer : SCHANNEL_FREE_BUFFER_SIZE;
449 if (c->dec_buf_size - c->dec_buf_offset < size || c->dec_buf_size < len) {
450 c->dec_buf_size = c->dec_buf_offset + size;
451 if (c->dec_buf_size < len)
452 c->dec_buf_size = len;
453 ret = av_reallocp(&c->dec_buf, c->dec_buf_size);
455 c->dec_buf_size = c->dec_buf_offset = 0;
460 /* copy decrypted data to buffer */
461 size = inbuf[1].cbBuffer;
463 memcpy(c->dec_buf + c->dec_buf_offset, inbuf[1].pvBuffer, size);
464 c->dec_buf_offset += size;
467 if (inbuf[3].BufferType == SECBUFFER_EXTRA && inbuf[3].cbBuffer > 0) {
468 if (c->enc_buf_offset > inbuf[3].cbBuffer) {
469 memmove(c->enc_buf, (c->enc_buf + c->enc_buf_offset) - inbuf[3].cbBuffer,
471 c->enc_buf_offset = inbuf[3].cbBuffer;
474 c->enc_buf_offset = 0;
476 if (sspi_ret == SEC_I_RENEGOTIATE) {
477 if (c->enc_buf_offset) {
478 av_log(h, AV_LOG_ERROR, "Cannot renegotiate, encrypted data buffer not empty\n");
479 ret = AVERROR_UNKNOWN;
483 av_log(h, AV_LOG_VERBOSE, "Re-negotiating security context\n");
484 ret = tls_client_handshake_loop(h, 0);
490 } else if (sspi_ret == SEC_I_CONTEXT_EXPIRED) {
491 c->sspi_close_notify = 1;
492 if (!c->connection_closed) {
493 c->connection_closed = 1;
494 av_log(h, AV_LOG_VERBOSE, "Server closed the connection\n");
499 } else if (sspi_ret == SEC_E_INCOMPLETE_MESSAGE) {
500 ret = AVERROR(EAGAIN);
503 av_log(h, AV_LOG_ERROR, "Unable to decrypt message (error 0x%x)\n", (unsigned)sspi_ret);
512 size = FFMIN(len, c->dec_buf_offset);
514 memcpy(buf, c->dec_buf, size);
515 memmove(c->dec_buf, c->dec_buf + size, c->dec_buf_offset - size);
516 c->dec_buf_offset -= size;
521 if (ret == 0 && !c->connection_closed)
522 ret = AVERROR(EAGAIN);
524 return ret < 0 ? ret : AVERROR_EOF;
527 static int tls_write(URLContext *h, const uint8_t *buf, int len)
529 TLSContext *c = h->priv_data;
530 TLSShared *s = &c->tls_shared;
531 SECURITY_STATUS sspi_ret;
532 int ret = 0, data_size;
533 uint8_t *data = NULL;
535 SecBufferDesc outbuf_desc;
537 if (c->sizes.cbMaximumMessage == 0) {
538 sspi_ret = QueryContextAttributes(&c->ctxt_handle, SECPKG_ATTR_STREAM_SIZES, &c->sizes);
539 if (sspi_ret != SEC_E_OK)
540 return AVERROR_UNKNOWN;
543 /* limit how much data we can consume */
544 len = FFMIN(len, c->sizes.cbMaximumMessage);
546 data_size = c->sizes.cbHeader + len + c->sizes.cbTrailer;
547 data = av_malloc(data_size);
549 return AVERROR(ENOMEM);
551 init_sec_buffer(&outbuf[0], SECBUFFER_STREAM_HEADER,
552 data, c->sizes.cbHeader);
553 init_sec_buffer(&outbuf[1], SECBUFFER_DATA,
554 data + c->sizes.cbHeader, len);
555 init_sec_buffer(&outbuf[2], SECBUFFER_STREAM_TRAILER,
556 data + c->sizes.cbHeader + len,
558 init_sec_buffer(&outbuf[3], SECBUFFER_EMPTY, NULL, 0);
559 init_sec_buffer_desc(&outbuf_desc, outbuf, 4);
561 memcpy(outbuf[1].pvBuffer, buf, len);
563 sspi_ret = EncryptMessage(&c->ctxt_handle, 0, &outbuf_desc, 0);
564 if (sspi_ret == SEC_E_OK) {
565 len = outbuf[0].cbBuffer + outbuf[1].cbBuffer + outbuf[2].cbBuffer;
566 ret = ffurl_write(s->tcp, data, len);
567 if (ret < 0 || ret != len) {
569 av_log(h, AV_LOG_ERROR, "Writing encrypted data to socket failed\n");
573 av_log(h, AV_LOG_ERROR, "Encrypting data failed\n");
574 if (sspi_ret == SEC_E_INSUFFICIENT_MEMORY)
575 ret = AVERROR(ENOMEM);
583 return ret < 0 ? ret : outbuf[1].cbBuffer;
586 static int tls_get_file_handle(URLContext *h)
588 TLSContext *c = h->priv_data;
589 return ffurl_get_file_handle(c->tls_shared.tcp);
592 static const AVOption options[] = {
593 TLS_COMMON_OPTIONS(TLSContext, tls_shared),
597 static const AVClass tls_class = {
599 .item_name = av_default_item_name,
601 .version = LIBAVUTIL_VERSION_INT,
604 const URLProtocol ff_tls_protocol = {
606 .url_open2 = tls_open,
607 .url_read = tls_read,
608 .url_write = tls_write,
609 .url_close = tls_close,
610 .url_get_file_handle = tls_get_file_handle,
611 .priv_data_size = sizeof(TLSContext),
612 .flags = URL_PROTOCOL_FLAG_NETWORK,
613 .priv_data_class = &tls_class,