d1_lib.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511
  1. /* ssl/d1_lib.c */
  2. /*
  3. * DTLS implementation written by Nagendra Modadugu
  4. * ([email protected]) for the OpenSSL project 2005.
  5. */
  6. /* ====================================================================
  7. * Copyright (c) 1999-2005 The OpenSSL Project. All rights reserved.
  8. *
  9. * Redistribution and use in source and binary forms, with or without
  10. * modification, are permitted provided that the following conditions
  11. * are met:
  12. *
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions and the following disclaimer.
  15. *
  16. * 2. Redistributions in binary form must reproduce the above copyright
  17. * notice, this list of conditions and the following disclaimer in
  18. * the documentation and/or other materials provided with the
  19. * distribution.
  20. *
  21. * 3. All advertising materials mentioning features or use of this
  22. * software must display the following acknowledgment:
  23. * "This product includes software developed by the OpenSSL Project
  24. * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  25. *
  26. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  27. * endorse or promote products derived from this software without
  28. * prior written permission. For written permission, please contact
  29. * [email protected].
  30. *
  31. * 5. Products derived from this software may not be called "OpenSSL"
  32. * nor may "OpenSSL" appear in their names without prior written
  33. * permission of the OpenSSL Project.
  34. *
  35. * 6. Redistributions of any form whatsoever must retain the following
  36. * acknowledgment:
  37. * "This product includes software developed by the OpenSSL Project
  38. * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  39. *
  40. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  41. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  42. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  43. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  44. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  45. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  46. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  47. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  49. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  50. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  51. * OF THE POSSIBILITY OF SUCH DAMAGE.
  52. * ====================================================================
  53. *
  54. * This product includes cryptographic software written by Eric Young
  55. * ([email protected]). This product includes software written by Tim
  56. * Hudson ([email protected]).
  57. *
  58. */
  59. #include <stdio.h>
  60. #define USE_SOCKETS
  61. #include <openssl/objects.h>
  62. #include "ssl_locl.h"
  63. #if defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS)
  64. # include <sys/timeb.h>
  65. #endif
  66. static void get_current_time(struct timeval *t);
  67. const char dtls1_version_str[] = "DTLSv1" OPENSSL_VERSION_PTEXT;
  68. int dtls1_listen(SSL *s, struct sockaddr *client);
  69. SSL3_ENC_METHOD DTLSv1_enc_data = {
  70. dtls1_enc,
  71. tls1_mac,
  72. tls1_setup_key_block,
  73. tls1_generate_master_secret,
  74. tls1_change_cipher_state,
  75. tls1_final_finish_mac,
  76. TLS1_FINISH_MAC_LENGTH,
  77. tls1_cert_verify_mac,
  78. TLS_MD_CLIENT_FINISH_CONST, TLS_MD_CLIENT_FINISH_CONST_SIZE,
  79. TLS_MD_SERVER_FINISH_CONST, TLS_MD_SERVER_FINISH_CONST_SIZE,
  80. tls1_alert_code,
  81. tls1_export_keying_material,
  82. };
  83. long dtls1_default_timeout(void)
  84. {
  85. /*
  86. * 2 hours, the 24 hours mentioned in the DTLSv1 spec is way too long for
  87. * http, the cache would over fill
  88. */
  89. return (60 * 60 * 2);
  90. }
  91. int dtls1_new(SSL *s)
  92. {
  93. DTLS1_STATE *d1;
  94. if (!ssl3_new(s))
  95. return (0);
  96. if ((d1 = OPENSSL_malloc(sizeof *d1)) == NULL)
  97. return (0);
  98. memset(d1, 0, sizeof *d1);
  99. /* d1->handshake_epoch=0; */
  100. d1->unprocessed_rcds.q = pqueue_new();
  101. d1->processed_rcds.q = pqueue_new();
  102. d1->buffered_messages = pqueue_new();
  103. d1->sent_messages = pqueue_new();
  104. d1->buffered_app_data.q = pqueue_new();
  105. if (s->server) {
  106. d1->cookie_len = sizeof(s->d1->cookie);
  107. }
  108. d1->link_mtu = 0;
  109. d1->mtu = 0;
  110. if (!d1->unprocessed_rcds.q || !d1->processed_rcds.q
  111. || !d1->buffered_messages || !d1->sent_messages
  112. || !d1->buffered_app_data.q) {
  113. if (d1->unprocessed_rcds.q)
  114. pqueue_free(d1->unprocessed_rcds.q);
  115. if (d1->processed_rcds.q)
  116. pqueue_free(d1->processed_rcds.q);
  117. if (d1->buffered_messages)
  118. pqueue_free(d1->buffered_messages);
  119. if (d1->sent_messages)
  120. pqueue_free(d1->sent_messages);
  121. if (d1->buffered_app_data.q)
  122. pqueue_free(d1->buffered_app_data.q);
  123. OPENSSL_free(d1);
  124. return (0);
  125. }
  126. s->d1 = d1;
  127. s->method->ssl_clear(s);
  128. return (1);
  129. }
  130. static void dtls1_clear_queues(SSL *s)
  131. {
  132. pitem *item = NULL;
  133. hm_fragment *frag = NULL;
  134. DTLS1_RECORD_DATA *rdata;
  135. while ((item = pqueue_pop(s->d1->unprocessed_rcds.q)) != NULL) {
  136. rdata = (DTLS1_RECORD_DATA *)item->data;
  137. if (rdata->rbuf.buf) {
  138. OPENSSL_free(rdata->rbuf.buf);
  139. }
  140. OPENSSL_free(item->data);
  141. pitem_free(item);
  142. }
  143. while ((item = pqueue_pop(s->d1->processed_rcds.q)) != NULL) {
  144. rdata = (DTLS1_RECORD_DATA *)item->data;
  145. if (rdata->rbuf.buf) {
  146. OPENSSL_free(rdata->rbuf.buf);
  147. }
  148. OPENSSL_free(item->data);
  149. pitem_free(item);
  150. }
  151. while ((item = pqueue_pop(s->d1->buffered_messages)) != NULL) {
  152. frag = (hm_fragment *)item->data;
  153. dtls1_hm_fragment_free(frag);
  154. pitem_free(item);
  155. }
  156. while ((item = pqueue_pop(s->d1->sent_messages)) != NULL) {
  157. frag = (hm_fragment *)item->data;
  158. dtls1_hm_fragment_free(frag);
  159. pitem_free(item);
  160. }
  161. while ((item = pqueue_pop(s->d1->buffered_app_data.q)) != NULL) {
  162. rdata = (DTLS1_RECORD_DATA *)item->data;
  163. if (rdata->rbuf.buf) {
  164. OPENSSL_free(rdata->rbuf.buf);
  165. }
  166. OPENSSL_free(item->data);
  167. pitem_free(item);
  168. }
  169. }
  170. void dtls1_free(SSL *s)
  171. {
  172. ssl3_free(s);
  173. dtls1_clear_queues(s);
  174. pqueue_free(s->d1->unprocessed_rcds.q);
  175. pqueue_free(s->d1->processed_rcds.q);
  176. pqueue_free(s->d1->buffered_messages);
  177. pqueue_free(s->d1->sent_messages);
  178. pqueue_free(s->d1->buffered_app_data.q);
  179. OPENSSL_free(s->d1);
  180. s->d1 = NULL;
  181. }
  182. void dtls1_clear(SSL *s)
  183. {
  184. pqueue unprocessed_rcds;
  185. pqueue processed_rcds;
  186. pqueue buffered_messages;
  187. pqueue sent_messages;
  188. pqueue buffered_app_data;
  189. unsigned int mtu;
  190. unsigned int link_mtu;
  191. if (s->d1) {
  192. unprocessed_rcds = s->d1->unprocessed_rcds.q;
  193. processed_rcds = s->d1->processed_rcds.q;
  194. buffered_messages = s->d1->buffered_messages;
  195. sent_messages = s->d1->sent_messages;
  196. buffered_app_data = s->d1->buffered_app_data.q;
  197. mtu = s->d1->mtu;
  198. link_mtu = s->d1->link_mtu;
  199. dtls1_clear_queues(s);
  200. memset(s->d1, 0, sizeof(*(s->d1)));
  201. if (s->server) {
  202. s->d1->cookie_len = sizeof(s->d1->cookie);
  203. }
  204. if (SSL_get_options(s) & SSL_OP_NO_QUERY_MTU) {
  205. s->d1->mtu = mtu;
  206. s->d1->link_mtu = link_mtu;
  207. }
  208. s->d1->unprocessed_rcds.q = unprocessed_rcds;
  209. s->d1->processed_rcds.q = processed_rcds;
  210. s->d1->buffered_messages = buffered_messages;
  211. s->d1->sent_messages = sent_messages;
  212. s->d1->buffered_app_data.q = buffered_app_data;
  213. }
  214. ssl3_clear(s);
  215. if (s->options & SSL_OP_CISCO_ANYCONNECT)
  216. s->version = DTLS1_BAD_VER;
  217. else
  218. s->version = DTLS1_VERSION;
  219. }
  220. long dtls1_ctrl(SSL *s, int cmd, long larg, void *parg)
  221. {
  222. int ret = 0;
  223. switch (cmd) {
  224. case DTLS_CTRL_GET_TIMEOUT:
  225. if (dtls1_get_timeout(s, (struct timeval *)parg) != NULL) {
  226. ret = 1;
  227. }
  228. break;
  229. case DTLS_CTRL_HANDLE_TIMEOUT:
  230. ret = dtls1_handle_timeout(s);
  231. break;
  232. case DTLS_CTRL_LISTEN:
  233. ret = dtls1_listen(s, parg);
  234. break;
  235. case SSL_CTRL_CHECK_PROTO_VERSION:
  236. /*
  237. * For library-internal use; checks that the current protocol is the
  238. * highest enabled version (according to s->ctx->method, as version
  239. * negotiation may have changed s->method).
  240. */
  241. #if DTLS_MAX_VERSION != DTLS1_VERSION
  242. # error Code needs update for DTLS_method() support beyond DTLS1_VERSION.
  243. #endif
  244. /*
  245. * Just one protocol version is supported so far; fail closed if the
  246. * version is not as expected.
  247. */
  248. return s->version == DTLS_MAX_VERSION;
  249. case DTLS_CTRL_SET_LINK_MTU:
  250. if (larg < (long)dtls1_link_min_mtu())
  251. return 0;
  252. s->d1->link_mtu = larg;
  253. return 1;
  254. case DTLS_CTRL_GET_LINK_MIN_MTU:
  255. return (long)dtls1_link_min_mtu();
  256. case SSL_CTRL_SET_MTU:
  257. /*
  258. * We may not have a BIO set yet so can't call dtls1_min_mtu()
  259. * We'll have to make do with dtls1_link_min_mtu() and max overhead
  260. */
  261. if (larg < (long)dtls1_link_min_mtu() - DTLS1_MAX_MTU_OVERHEAD)
  262. return 0;
  263. s->d1->mtu = larg;
  264. return larg;
  265. default:
  266. ret = ssl3_ctrl(s, cmd, larg, parg);
  267. break;
  268. }
  269. return (ret);
  270. }
  271. /*
  272. * As it's impossible to use stream ciphers in "datagram" mode, this
  273. * simple filter is designed to disengage them in DTLS. Unfortunately
  274. * there is no universal way to identify stream SSL_CIPHER, so we have
  275. * to explicitly list their SSL_* codes. Currently RC4 is the only one
  276. * available, but if new ones emerge, they will have to be added...
  277. */
  278. const SSL_CIPHER *dtls1_get_cipher(unsigned int u)
  279. {
  280. const SSL_CIPHER *ciph = ssl3_get_cipher(u);
  281. if (ciph != NULL) {
  282. if (ciph->algorithm_enc == SSL_RC4)
  283. return NULL;
  284. }
  285. return ciph;
  286. }
  287. void dtls1_start_timer(SSL *s)
  288. {
  289. #ifndef OPENSSL_NO_SCTP
  290. /* Disable timer for SCTP */
  291. if (BIO_dgram_is_sctp(SSL_get_wbio(s))) {
  292. memset(&(s->d1->next_timeout), 0, sizeof(struct timeval));
  293. return;
  294. }
  295. #endif
  296. /* If timer is not set, initialize duration with 1 second */
  297. if (s->d1->next_timeout.tv_sec == 0 && s->d1->next_timeout.tv_usec == 0) {
  298. s->d1->timeout_duration = 1;
  299. }
  300. /* Set timeout to current time */
  301. get_current_time(&(s->d1->next_timeout));
  302. /* Add duration to current time */
  303. s->d1->next_timeout.tv_sec += s->d1->timeout_duration;
  304. BIO_ctrl(SSL_get_rbio(s), BIO_CTRL_DGRAM_SET_NEXT_TIMEOUT, 0,
  305. &(s->d1->next_timeout));
  306. }
  307. struct timeval *dtls1_get_timeout(SSL *s, struct timeval *timeleft)
  308. {
  309. struct timeval timenow;
  310. /* If no timeout is set, just return NULL */
  311. if (s->d1->next_timeout.tv_sec == 0 && s->d1->next_timeout.tv_usec == 0) {
  312. return NULL;
  313. }
  314. /* Get current time */
  315. get_current_time(&timenow);
  316. /* If timer already expired, set remaining time to 0 */
  317. if (s->d1->next_timeout.tv_sec < timenow.tv_sec ||
  318. (s->d1->next_timeout.tv_sec == timenow.tv_sec &&
  319. s->d1->next_timeout.tv_usec <= timenow.tv_usec)) {
  320. memset(timeleft, 0, sizeof(struct timeval));
  321. return timeleft;
  322. }
  323. /* Calculate time left until timer expires */
  324. memcpy(timeleft, &(s->d1->next_timeout), sizeof(struct timeval));
  325. timeleft->tv_sec -= timenow.tv_sec;
  326. timeleft->tv_usec -= timenow.tv_usec;
  327. if (timeleft->tv_usec < 0) {
  328. timeleft->tv_sec--;
  329. timeleft->tv_usec += 1000000;
  330. }
  331. /*
  332. * If remaining time is less than 15 ms, set it to 0 to prevent issues
  333. * because of small devergences with socket timeouts.
  334. */
  335. if (timeleft->tv_sec == 0 && timeleft->tv_usec < 15000) {
  336. memset(timeleft, 0, sizeof(struct timeval));
  337. }
  338. return timeleft;
  339. }
  340. int dtls1_is_timer_expired(SSL *s)
  341. {
  342. struct timeval timeleft;
  343. /* Get time left until timeout, return false if no timer running */
  344. if (dtls1_get_timeout(s, &timeleft) == NULL) {
  345. return 0;
  346. }
  347. /* Return false if timer is not expired yet */
  348. if (timeleft.tv_sec > 0 || timeleft.tv_usec > 0) {
  349. return 0;
  350. }
  351. /* Timer expired, so return true */
  352. return 1;
  353. }
  354. void dtls1_double_timeout(SSL *s)
  355. {
  356. s->d1->timeout_duration *= 2;
  357. if (s->d1->timeout_duration > 60)
  358. s->d1->timeout_duration = 60;
  359. dtls1_start_timer(s);
  360. }
  361. void dtls1_stop_timer(SSL *s)
  362. {
  363. /* Reset everything */
  364. memset(&(s->d1->timeout), 0, sizeof(struct dtls1_timeout_st));
  365. memset(&(s->d1->next_timeout), 0, sizeof(struct timeval));
  366. s->d1->timeout_duration = 1;
  367. BIO_ctrl(SSL_get_rbio(s), BIO_CTRL_DGRAM_SET_NEXT_TIMEOUT, 0,
  368. &(s->d1->next_timeout));
  369. /* Clear retransmission buffer */
  370. dtls1_clear_record_buffer(s);
  371. }
  372. int dtls1_check_timeout_num(SSL *s)
  373. {
  374. unsigned int mtu;
  375. s->d1->timeout.num_alerts++;
  376. /* Reduce MTU after 2 unsuccessful retransmissions */
  377. if (s->d1->timeout.num_alerts > 2
  378. && !(SSL_get_options(s) & SSL_OP_NO_QUERY_MTU)) {
  379. mtu =
  380. BIO_ctrl(SSL_get_wbio(s), BIO_CTRL_DGRAM_GET_FALLBACK_MTU, 0,
  381. NULL);
  382. if (mtu < s->d1->mtu)
  383. s->d1->mtu = mtu;
  384. }
  385. if (s->d1->timeout.num_alerts > DTLS1_TMO_ALERT_COUNT) {
  386. /* fail the connection, enough alerts have been sent */
  387. SSLerr(SSL_F_DTLS1_CHECK_TIMEOUT_NUM, SSL_R_READ_TIMEOUT_EXPIRED);
  388. return -1;
  389. }
  390. return 0;
  391. }
  392. int dtls1_handle_timeout(SSL *s)
  393. {
  394. /* if no timer is expired, don't do anything */
  395. if (!dtls1_is_timer_expired(s)) {
  396. return 0;
  397. }
  398. dtls1_double_timeout(s);
  399. if (dtls1_check_timeout_num(s) < 0)
  400. return -1;
  401. s->d1->timeout.read_timeouts++;
  402. if (s->d1->timeout.read_timeouts > DTLS1_TMO_READ_COUNT) {
  403. s->d1->timeout.read_timeouts = 1;
  404. }
  405. #ifndef OPENSSL_NO_HEARTBEATS
  406. if (s->tlsext_hb_pending) {
  407. s->tlsext_hb_pending = 0;
  408. return dtls1_heartbeat(s);
  409. }
  410. #endif
  411. dtls1_start_timer(s);
  412. return dtls1_retransmit_buffered_messages(s);
  413. }
  414. static void get_current_time(struct timeval *t)
  415. {
  416. #ifdef OPENSSL_SYS_WIN32
  417. struct _timeb tb;
  418. _ftime(&tb);
  419. t->tv_sec = (long)tb.time;
  420. t->tv_usec = (long)tb.millitm * 1000;
  421. #elif defined(OPENSSL_SYS_VMS)
  422. struct timeb tb;
  423. ftime(&tb);
  424. t->tv_sec = (long)tb.time;
  425. t->tv_usec = (long)tb.millitm * 1000;
  426. #else
  427. gettimeofday(t, NULL);
  428. #endif
  429. }
  430. int dtls1_listen(SSL *s, struct sockaddr *client)
  431. {
  432. int ret;
  433. /* Ensure there is no state left over from a previous invocation */
  434. SSL_clear(s);
  435. SSL_set_options(s, SSL_OP_COOKIE_EXCHANGE);
  436. s->d1->listen = 1;
  437. ret = SSL_accept(s);
  438. if (ret <= 0)
  439. return ret;
  440. (void)BIO_dgram_get_peer(SSL_get_rbio(s), client);
  441. return 1;
  442. }