d1_lib.c 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973
  1. /*
  2. * Copyright 2005-2021 The OpenSSL Project Authors. All Rights Reserved.
  3. *
  4. * Licensed under the OpenSSL license (the "License"). You may not use
  5. * this file except in compliance with the License. You can obtain a copy
  6. * in the file LICENSE in the source distribution or at
  7. * https://www.openssl.org/source/license.html
  8. */
  9. #include "e_os.h"
  10. #include <stdio.h>
  11. #include <openssl/objects.h>
  12. #include <openssl/rand.h>
  13. #include "ssl_local.h"
  14. static void get_current_time(struct timeval *t);
  15. static int dtls1_handshake_write(SSL *s);
  16. static size_t dtls1_link_min_mtu(void);
  17. /* XDTLS: figure out the right values */
  18. static const size_t g_probable_mtu[] = { 1500, 512, 256 };
  19. const SSL3_ENC_METHOD DTLSv1_enc_data = {
  20. tls1_enc,
  21. tls1_mac,
  22. tls1_setup_key_block,
  23. tls1_generate_master_secret,
  24. tls1_change_cipher_state,
  25. tls1_final_finish_mac,
  26. TLS_MD_CLIENT_FINISH_CONST, TLS_MD_CLIENT_FINISH_CONST_SIZE,
  27. TLS_MD_SERVER_FINISH_CONST, TLS_MD_SERVER_FINISH_CONST_SIZE,
  28. tls1_alert_code,
  29. tls1_export_keying_material,
  30. SSL_ENC_FLAG_DTLS | SSL_ENC_FLAG_EXPLICIT_IV,
  31. dtls1_set_handshake_header,
  32. dtls1_close_construct_packet,
  33. dtls1_handshake_write
  34. };
  35. const SSL3_ENC_METHOD DTLSv1_2_enc_data = {
  36. tls1_enc,
  37. tls1_mac,
  38. tls1_setup_key_block,
  39. tls1_generate_master_secret,
  40. tls1_change_cipher_state,
  41. tls1_final_finish_mac,
  42. TLS_MD_CLIENT_FINISH_CONST, TLS_MD_CLIENT_FINISH_CONST_SIZE,
  43. TLS_MD_SERVER_FINISH_CONST, TLS_MD_SERVER_FINISH_CONST_SIZE,
  44. tls1_alert_code,
  45. tls1_export_keying_material,
  46. SSL_ENC_FLAG_DTLS | SSL_ENC_FLAG_EXPLICIT_IV | SSL_ENC_FLAG_SIGALGS
  47. | SSL_ENC_FLAG_SHA256_PRF | SSL_ENC_FLAG_TLS1_2_CIPHERS,
  48. dtls1_set_handshake_header,
  49. dtls1_close_construct_packet,
  50. dtls1_handshake_write
  51. };
  52. long dtls1_default_timeout(void)
  53. {
  54. /*
  55. * 2 hours, the 24 hours mentioned in the DTLSv1 spec is way too long for
  56. * http, the cache would over fill
  57. */
  58. return (60 * 60 * 2);
  59. }
  60. int dtls1_new(SSL *s)
  61. {
  62. DTLS1_STATE *d1;
  63. if (!DTLS_RECORD_LAYER_new(&s->rlayer)) {
  64. return 0;
  65. }
  66. if (!ssl3_new(s))
  67. return 0;
  68. if ((d1 = OPENSSL_zalloc(sizeof(*d1))) == NULL) {
  69. ssl3_free(s);
  70. return 0;
  71. }
  72. d1->buffered_messages = pqueue_new();
  73. d1->sent_messages = pqueue_new();
  74. if (s->server) {
  75. d1->cookie_len = sizeof(s->d1->cookie);
  76. }
  77. d1->link_mtu = 0;
  78. d1->mtu = 0;
  79. if (d1->buffered_messages == NULL || d1->sent_messages == NULL) {
  80. pqueue_free(d1->buffered_messages);
  81. pqueue_free(d1->sent_messages);
  82. OPENSSL_free(d1);
  83. ssl3_free(s);
  84. return 0;
  85. }
  86. s->d1 = d1;
  87. if (!s->method->ssl_clear(s))
  88. return 0;
  89. return 1;
  90. }
  91. static void dtls1_clear_queues(SSL *s)
  92. {
  93. dtls1_clear_received_buffer(s);
  94. dtls1_clear_sent_buffer(s);
  95. }
  96. void dtls1_clear_received_buffer(SSL *s)
  97. {
  98. pitem *item = NULL;
  99. hm_fragment *frag = NULL;
  100. while ((item = pqueue_pop(s->d1->buffered_messages)) != NULL) {
  101. frag = (hm_fragment *)item->data;
  102. dtls1_hm_fragment_free(frag);
  103. pitem_free(item);
  104. }
  105. }
  106. void dtls1_clear_sent_buffer(SSL *s)
  107. {
  108. pitem *item = NULL;
  109. hm_fragment *frag = NULL;
  110. while ((item = pqueue_pop(s->d1->sent_messages)) != NULL) {
  111. frag = (hm_fragment *)item->data;
  112. dtls1_hm_fragment_free(frag);
  113. pitem_free(item);
  114. }
  115. }
  116. void dtls1_free(SSL *s)
  117. {
  118. DTLS_RECORD_LAYER_free(&s->rlayer);
  119. ssl3_free(s);
  120. if (s->d1 != NULL) {
  121. dtls1_clear_queues(s);
  122. pqueue_free(s->d1->buffered_messages);
  123. pqueue_free(s->d1->sent_messages);
  124. }
  125. OPENSSL_free(s->d1);
  126. s->d1 = NULL;
  127. }
  128. int dtls1_clear(SSL *s)
  129. {
  130. pqueue *buffered_messages;
  131. pqueue *sent_messages;
  132. size_t mtu;
  133. size_t link_mtu;
  134. DTLS_RECORD_LAYER_clear(&s->rlayer);
  135. if (s->d1) {
  136. DTLS_timer_cb timer_cb = s->d1->timer_cb;
  137. buffered_messages = s->d1->buffered_messages;
  138. sent_messages = s->d1->sent_messages;
  139. mtu = s->d1->mtu;
  140. link_mtu = s->d1->link_mtu;
  141. dtls1_clear_queues(s);
  142. memset(s->d1, 0, sizeof(*s->d1));
  143. /* Restore the timer callback from previous state */
  144. s->d1->timer_cb = timer_cb;
  145. if (s->server) {
  146. s->d1->cookie_len = sizeof(s->d1->cookie);
  147. }
  148. if (SSL_get_options(s) & SSL_OP_NO_QUERY_MTU) {
  149. s->d1->mtu = mtu;
  150. s->d1->link_mtu = link_mtu;
  151. }
  152. s->d1->buffered_messages = buffered_messages;
  153. s->d1->sent_messages = sent_messages;
  154. }
  155. if (!ssl3_clear(s))
  156. return 0;
  157. if (s->method->version == DTLS_ANY_VERSION)
  158. s->version = DTLS_MAX_VERSION;
  159. #ifndef OPENSSL_NO_DTLS1_METHOD
  160. else if (s->options & SSL_OP_CISCO_ANYCONNECT)
  161. s->client_version = s->version = DTLS1_BAD_VER;
  162. #endif
  163. else
  164. s->version = s->method->version;
  165. return 1;
  166. }
  167. long dtls1_ctrl(SSL *s, int cmd, long larg, void *parg)
  168. {
  169. int ret = 0;
  170. switch (cmd) {
  171. case DTLS_CTRL_GET_TIMEOUT:
  172. if (dtls1_get_timeout(s, (struct timeval *)parg) != NULL) {
  173. ret = 1;
  174. }
  175. break;
  176. case DTLS_CTRL_HANDLE_TIMEOUT:
  177. ret = dtls1_handle_timeout(s);
  178. break;
  179. case DTLS_CTRL_SET_LINK_MTU:
  180. if (larg < (long)dtls1_link_min_mtu())
  181. return 0;
  182. s->d1->link_mtu = larg;
  183. return 1;
  184. case DTLS_CTRL_GET_LINK_MIN_MTU:
  185. return (long)dtls1_link_min_mtu();
  186. case SSL_CTRL_SET_MTU:
  187. /*
  188. * We may not have a BIO set yet so can't call dtls1_min_mtu()
  189. * We'll have to make do with dtls1_link_min_mtu() and max overhead
  190. */
  191. if (larg < (long)dtls1_link_min_mtu() - DTLS1_MAX_MTU_OVERHEAD)
  192. return 0;
  193. s->d1->mtu = larg;
  194. return larg;
  195. default:
  196. ret = ssl3_ctrl(s, cmd, larg, parg);
  197. break;
  198. }
  199. return ret;
  200. }
  201. void dtls1_start_timer(SSL *s)
  202. {
  203. unsigned int sec, usec;
  204. #ifndef OPENSSL_NO_SCTP
  205. /* Disable timer for SCTP */
  206. if (BIO_dgram_is_sctp(SSL_get_wbio(s))) {
  207. memset(&s->d1->next_timeout, 0, sizeof(s->d1->next_timeout));
  208. return;
  209. }
  210. #endif
  211. /*
  212. * If timer is not set, initialize duration with 1 second or
  213. * a user-specified value if the timer callback is installed.
  214. */
  215. if (s->d1->next_timeout.tv_sec == 0 && s->d1->next_timeout.tv_usec == 0) {
  216. if (s->d1->timer_cb != NULL)
  217. s->d1->timeout_duration_us = s->d1->timer_cb(s, 0);
  218. else
  219. s->d1->timeout_duration_us = 1000000;
  220. }
  221. /* Set timeout to current time */
  222. get_current_time(&(s->d1->next_timeout));
  223. /* Add duration to current time */
  224. sec = s->d1->timeout_duration_us / 1000000;
  225. usec = s->d1->timeout_duration_us - (sec * 1000000);
  226. s->d1->next_timeout.tv_sec += sec;
  227. s->d1->next_timeout.tv_usec += usec;
  228. if (s->d1->next_timeout.tv_usec >= 1000000) {
  229. s->d1->next_timeout.tv_sec++;
  230. s->d1->next_timeout.tv_usec -= 1000000;
  231. }
  232. BIO_ctrl(SSL_get_rbio(s), BIO_CTRL_DGRAM_SET_NEXT_TIMEOUT, 0,
  233. &(s->d1->next_timeout));
  234. }
  235. struct timeval *dtls1_get_timeout(SSL *s, struct timeval *timeleft)
  236. {
  237. struct timeval timenow;
  238. /* If no timeout is set, just return NULL */
  239. if (s->d1->next_timeout.tv_sec == 0 && s->d1->next_timeout.tv_usec == 0) {
  240. return NULL;
  241. }
  242. /* Get current time */
  243. get_current_time(&timenow);
  244. /* If timer already expired, set remaining time to 0 */
  245. if (s->d1->next_timeout.tv_sec < timenow.tv_sec ||
  246. (s->d1->next_timeout.tv_sec == timenow.tv_sec &&
  247. s->d1->next_timeout.tv_usec <= timenow.tv_usec)) {
  248. memset(timeleft, 0, sizeof(*timeleft));
  249. return timeleft;
  250. }
  251. /* Calculate time left until timer expires */
  252. memcpy(timeleft, &(s->d1->next_timeout), sizeof(struct timeval));
  253. timeleft->tv_sec -= timenow.tv_sec;
  254. timeleft->tv_usec -= timenow.tv_usec;
  255. if (timeleft->tv_usec < 0) {
  256. timeleft->tv_sec--;
  257. timeleft->tv_usec += 1000000;
  258. }
  259. /*
  260. * If remaining time is less than 15 ms, set it to 0 to prevent issues
  261. * because of small divergences with socket timeouts.
  262. */
  263. if (timeleft->tv_sec == 0 && timeleft->tv_usec < 15000) {
  264. memset(timeleft, 0, sizeof(*timeleft));
  265. }
  266. return timeleft;
  267. }
  268. int dtls1_is_timer_expired(SSL *s)
  269. {
  270. struct timeval timeleft;
  271. /* Get time left until timeout, return false if no timer running */
  272. if (dtls1_get_timeout(s, &timeleft) == NULL) {
  273. return 0;
  274. }
  275. /* Return false if timer is not expired yet */
  276. if (timeleft.tv_sec > 0 || timeleft.tv_usec > 0) {
  277. return 0;
  278. }
  279. /* Timer expired, so return true */
  280. return 1;
  281. }
  282. void dtls1_double_timeout(SSL *s)
  283. {
  284. s->d1->timeout_duration_us *= 2;
  285. if (s->d1->timeout_duration_us > 60000000)
  286. s->d1->timeout_duration_us = 60000000;
  287. dtls1_start_timer(s);
  288. }
  289. void dtls1_stop_timer(SSL *s)
  290. {
  291. /* Reset everything */
  292. memset(&s->d1->timeout, 0, sizeof(s->d1->timeout));
  293. memset(&s->d1->next_timeout, 0, sizeof(s->d1->next_timeout));
  294. s->d1->timeout_duration_us = 1000000;
  295. BIO_ctrl(SSL_get_rbio(s), BIO_CTRL_DGRAM_SET_NEXT_TIMEOUT, 0,
  296. &(s->d1->next_timeout));
  297. /* Clear retransmission buffer */
  298. dtls1_clear_sent_buffer(s);
  299. }
  300. int dtls1_check_timeout_num(SSL *s)
  301. {
  302. size_t mtu;
  303. s->d1->timeout.num_alerts++;
  304. /* Reduce MTU after 2 unsuccessful retransmissions */
  305. if (s->d1->timeout.num_alerts > 2
  306. && !(SSL_get_options(s) & SSL_OP_NO_QUERY_MTU)) {
  307. mtu =
  308. BIO_ctrl(SSL_get_wbio(s), BIO_CTRL_DGRAM_GET_FALLBACK_MTU, 0, NULL);
  309. if (mtu < s->d1->mtu)
  310. s->d1->mtu = mtu;
  311. }
  312. if (s->d1->timeout.num_alerts > DTLS1_TMO_ALERT_COUNT) {
  313. /* fail the connection, enough alerts have been sent */
  314. SSLfatal(s, SSL_AD_NO_ALERT, SSL_F_DTLS1_CHECK_TIMEOUT_NUM,
  315. SSL_R_READ_TIMEOUT_EXPIRED);
  316. return -1;
  317. }
  318. return 0;
  319. }
  320. int dtls1_handle_timeout(SSL *s)
  321. {
  322. /* if no timer is expired, don't do anything */
  323. if (!dtls1_is_timer_expired(s)) {
  324. return 0;
  325. }
  326. if (s->d1->timer_cb != NULL)
  327. s->d1->timeout_duration_us = s->d1->timer_cb(s, s->d1->timeout_duration_us);
  328. else
  329. dtls1_double_timeout(s);
  330. if (dtls1_check_timeout_num(s) < 0) {
  331. /* SSLfatal() already called */
  332. return -1;
  333. }
  334. s->d1->timeout.read_timeouts++;
  335. if (s->d1->timeout.read_timeouts > DTLS1_TMO_READ_COUNT) {
  336. s->d1->timeout.read_timeouts = 1;
  337. }
  338. dtls1_start_timer(s);
  339. /* Calls SSLfatal() if required */
  340. return dtls1_retransmit_buffered_messages(s);
  341. }
  342. static void get_current_time(struct timeval *t)
  343. {
  344. #if defined(_WIN32)
  345. SYSTEMTIME st;
  346. union {
  347. unsigned __int64 ul;
  348. FILETIME ft;
  349. } now;
  350. GetSystemTime(&st);
  351. SystemTimeToFileTime(&st, &now.ft);
  352. /* re-bias to 1/1/1970 */
  353. # ifdef __MINGW32__
  354. now.ul -= 116444736000000000ULL;
  355. # else
  356. /* *INDENT-OFF* */
  357. now.ul -= 116444736000000000UI64;
  358. /* *INDENT-ON* */
  359. # endif
  360. t->tv_sec = (long)(now.ul / 10000000);
  361. t->tv_usec = ((int)(now.ul % 10000000)) / 10;
  362. #else
  363. gettimeofday(t, NULL);
  364. #endif
  365. }
  366. #define LISTEN_SUCCESS 2
  367. #define LISTEN_SEND_VERIFY_REQUEST 1
  368. #ifndef OPENSSL_NO_SOCK
  369. int DTLSv1_listen(SSL *s, BIO_ADDR *client)
  370. {
  371. int next, n, ret = 0;
  372. unsigned char cookie[DTLS1_COOKIE_LENGTH];
  373. unsigned char seq[SEQ_NUM_SIZE];
  374. const unsigned char *data;
  375. unsigned char *buf, *wbuf;
  376. size_t fragoff, fraglen, msglen, reclen, align = 0;
  377. unsigned int rectype, versmajor, msgseq, msgtype, clientvers, cookielen;
  378. BIO *rbio, *wbio;
  379. BIO_ADDR *tmpclient = NULL;
  380. PACKET pkt, msgpkt, msgpayload, session, cookiepkt;
  381. if (s->handshake_func == NULL) {
  382. /* Not properly initialized yet */
  383. SSL_set_accept_state(s);
  384. }
  385. /* Ensure there is no state left over from a previous invocation */
  386. if (!SSL_clear(s))
  387. return -1;
  388. ERR_clear_error();
  389. rbio = SSL_get_rbio(s);
  390. wbio = SSL_get_wbio(s);
  391. if (!rbio || !wbio) {
  392. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_BIO_NOT_SET);
  393. return -1;
  394. }
  395. /*
  396. * Note: This check deliberately excludes DTLS1_BAD_VER because that version
  397. * requires the MAC to be calculated *including* the first ClientHello
  398. * (without the cookie). Since DTLSv1_listen is stateless that cannot be
  399. * supported. DTLS1_BAD_VER must use cookies in a stateful manner (e.g. via
  400. * SSL_accept)
  401. */
  402. if ((s->version & 0xff00) != (DTLS1_VERSION & 0xff00)) {
  403. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_UNSUPPORTED_SSL_VERSION);
  404. return -1;
  405. }
  406. if (!ssl3_setup_buffers(s)) {
  407. /* SSLerr already called */
  408. return -1;
  409. }
  410. buf = RECORD_LAYER_get_rbuf(&s->rlayer)->buf;
  411. wbuf = RECORD_LAYER_get_wbuf(&s->rlayer)[0].buf;
  412. #if defined(SSL3_ALIGN_PAYLOAD)
  413. # if SSL3_ALIGN_PAYLOAD != 0
  414. /*
  415. * Using SSL3_RT_HEADER_LENGTH here instead of DTLS1_RT_HEADER_LENGTH for
  416. * consistency with ssl3_read_n. In practice it should make no difference
  417. * for sensible values of SSL3_ALIGN_PAYLOAD because the difference between
  418. * SSL3_RT_HEADER_LENGTH and DTLS1_RT_HEADER_LENGTH is exactly 8
  419. */
  420. align = (size_t)buf + SSL3_RT_HEADER_LENGTH;
  421. align = SSL3_ALIGN_PAYLOAD - 1 - ((align - 1) % SSL3_ALIGN_PAYLOAD);
  422. # endif
  423. #endif
  424. buf += align;
  425. do {
  426. /* Get a packet */
  427. clear_sys_error();
  428. n = BIO_read(rbio, buf, SSL3_RT_MAX_PLAIN_LENGTH
  429. + DTLS1_RT_HEADER_LENGTH);
  430. if (n <= 0) {
  431. if (BIO_should_retry(rbio)) {
  432. /* Non-blocking IO */
  433. goto end;
  434. }
  435. return -1;
  436. }
  437. if (!PACKET_buf_init(&pkt, buf, n)) {
  438. SSLerr(SSL_F_DTLSV1_LISTEN, ERR_R_INTERNAL_ERROR);
  439. return -1;
  440. }
  441. /*
  442. * Parse the received record. If there are any problems with it we just
  443. * dump it - with no alert. RFC6347 says this "Unlike TLS, DTLS is
  444. * resilient in the face of invalid records (e.g., invalid formatting,
  445. * length, MAC, etc.). In general, invalid records SHOULD be silently
  446. * discarded, thus preserving the association; however, an error MAY be
  447. * logged for diagnostic purposes."
  448. */
  449. /* this packet contained a partial record, dump it */
  450. if (n < DTLS1_RT_HEADER_LENGTH) {
  451. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_RECORD_TOO_SMALL);
  452. goto end;
  453. }
  454. if (s->msg_callback)
  455. s->msg_callback(0, 0, SSL3_RT_HEADER, buf,
  456. DTLS1_RT_HEADER_LENGTH, s, s->msg_callback_arg);
  457. /* Get the record header */
  458. if (!PACKET_get_1(&pkt, &rectype)
  459. || !PACKET_get_1(&pkt, &versmajor)) {
  460. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_LENGTH_MISMATCH);
  461. goto end;
  462. }
  463. if (rectype != SSL3_RT_HANDSHAKE) {
  464. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_UNEXPECTED_MESSAGE);
  465. goto end;
  466. }
  467. /*
  468. * Check record version number. We only check that the major version is
  469. * the same.
  470. */
  471. if (versmajor != DTLS1_VERSION_MAJOR) {
  472. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_BAD_PROTOCOL_VERSION_NUMBER);
  473. goto end;
  474. }
  475. if (!PACKET_forward(&pkt, 1)
  476. /* Save the sequence number: 64 bits, with top 2 bytes = epoch */
  477. || !PACKET_copy_bytes(&pkt, seq, SEQ_NUM_SIZE)
  478. || !PACKET_get_length_prefixed_2(&pkt, &msgpkt)) {
  479. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_LENGTH_MISMATCH);
  480. goto end;
  481. }
  482. reclen = PACKET_remaining(&msgpkt);
  483. /*
  484. * We allow data remaining at the end of the packet because there could
  485. * be a second record (but we ignore it)
  486. */
  487. /* This is an initial ClientHello so the epoch has to be 0 */
  488. if (seq[0] != 0 || seq[1] != 0) {
  489. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_UNEXPECTED_MESSAGE);
  490. goto end;
  491. }
  492. /* Get a pointer to the raw message for the later callback */
  493. data = PACKET_data(&msgpkt);
  494. /* Finished processing the record header, now process the message */
  495. if (!PACKET_get_1(&msgpkt, &msgtype)
  496. || !PACKET_get_net_3_len(&msgpkt, &msglen)
  497. || !PACKET_get_net_2(&msgpkt, &msgseq)
  498. || !PACKET_get_net_3_len(&msgpkt, &fragoff)
  499. || !PACKET_get_net_3_len(&msgpkt, &fraglen)
  500. || !PACKET_get_sub_packet(&msgpkt, &msgpayload, fraglen)
  501. || PACKET_remaining(&msgpkt) != 0) {
  502. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_LENGTH_MISMATCH);
  503. goto end;
  504. }
  505. if (msgtype != SSL3_MT_CLIENT_HELLO) {
  506. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_UNEXPECTED_MESSAGE);
  507. goto end;
  508. }
  509. /* Message sequence number can only be 0 or 1 */
  510. if (msgseq > 2) {
  511. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_INVALID_SEQUENCE_NUMBER);
  512. goto end;
  513. }
  514. /*
  515. * We don't support fragment reassembly for ClientHellos whilst
  516. * listening because that would require server side state (which is
  517. * against the whole point of the ClientHello/HelloVerifyRequest
  518. * mechanism). Instead we only look at the first ClientHello fragment
  519. * and require that the cookie must be contained within it.
  520. */
  521. if (fragoff != 0 || fraglen > msglen) {
  522. /* Non initial ClientHello fragment (or bad fragment) */
  523. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_FRAGMENTED_CLIENT_HELLO);
  524. goto end;
  525. }
  526. if (s->msg_callback)
  527. s->msg_callback(0, s->version, SSL3_RT_HANDSHAKE, data,
  528. fraglen + DTLS1_HM_HEADER_LENGTH, s,
  529. s->msg_callback_arg);
  530. if (!PACKET_get_net_2(&msgpayload, &clientvers)) {
  531. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_LENGTH_MISMATCH);
  532. goto end;
  533. }
  534. /*
  535. * Verify client version is supported
  536. */
  537. if (DTLS_VERSION_LT(clientvers, (unsigned int)s->method->version) &&
  538. s->method->version != DTLS_ANY_VERSION) {
  539. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_WRONG_VERSION_NUMBER);
  540. goto end;
  541. }
  542. if (!PACKET_forward(&msgpayload, SSL3_RANDOM_SIZE)
  543. || !PACKET_get_length_prefixed_1(&msgpayload, &session)
  544. || !PACKET_get_length_prefixed_1(&msgpayload, &cookiepkt)) {
  545. /*
  546. * Could be malformed or the cookie does not fit within the initial
  547. * ClientHello fragment. Either way we can't handle it.
  548. */
  549. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_LENGTH_MISMATCH);
  550. goto end;
  551. }
  552. /*
  553. * Check if we have a cookie or not. If not we need to send a
  554. * HelloVerifyRequest.
  555. */
  556. if (PACKET_remaining(&cookiepkt) == 0) {
  557. next = LISTEN_SEND_VERIFY_REQUEST;
  558. } else {
  559. /*
  560. * We have a cookie, so lets check it.
  561. */
  562. if (s->ctx->app_verify_cookie_cb == NULL) {
  563. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_NO_VERIFY_COOKIE_CALLBACK);
  564. /* This is fatal */
  565. return -1;
  566. }
  567. if (s->ctx->app_verify_cookie_cb(s, PACKET_data(&cookiepkt),
  568. (unsigned int)PACKET_remaining(&cookiepkt)) == 0) {
  569. /*
  570. * We treat invalid cookies in the same was as no cookie as
  571. * per RFC6347
  572. */
  573. next = LISTEN_SEND_VERIFY_REQUEST;
  574. } else {
  575. /* Cookie verification succeeded */
  576. next = LISTEN_SUCCESS;
  577. }
  578. }
  579. if (next == LISTEN_SEND_VERIFY_REQUEST) {
  580. WPACKET wpkt;
  581. unsigned int version;
  582. size_t wreclen;
  583. /*
  584. * There was no cookie in the ClientHello so we need to send a
  585. * HelloVerifyRequest. If this fails we do not worry about trying
  586. * to resend, we just drop it.
  587. */
  588. /* Generate the cookie */
  589. if (s->ctx->app_gen_cookie_cb == NULL ||
  590. s->ctx->app_gen_cookie_cb(s, cookie, &cookielen) == 0 ||
  591. cookielen > 255) {
  592. SSLerr(SSL_F_DTLSV1_LISTEN, SSL_R_COOKIE_GEN_CALLBACK_FAILURE);
  593. /* This is fatal */
  594. return -1;
  595. }
  596. /*
  597. * Special case: for hello verify request, client version 1.0 and we
  598. * haven't decided which version to use yet send back using version
  599. * 1.0 header: otherwise some clients will ignore it.
  600. */
  601. version = (s->method->version == DTLS_ANY_VERSION) ? DTLS1_VERSION
  602. : s->version;
  603. /* Construct the record and message headers */
  604. if (!WPACKET_init_static_len(&wpkt,
  605. wbuf,
  606. ssl_get_max_send_fragment(s)
  607. + DTLS1_RT_HEADER_LENGTH,
  608. 0)
  609. || !WPACKET_put_bytes_u8(&wpkt, SSL3_RT_HANDSHAKE)
  610. || !WPACKET_put_bytes_u16(&wpkt, version)
  611. /*
  612. * Record sequence number is always the same as in the
  613. * received ClientHello
  614. */
  615. || !WPACKET_memcpy(&wpkt, seq, SEQ_NUM_SIZE)
  616. /* End of record, start sub packet for message */
  617. || !WPACKET_start_sub_packet_u16(&wpkt)
  618. /* Message type */
  619. || !WPACKET_put_bytes_u8(&wpkt,
  620. DTLS1_MT_HELLO_VERIFY_REQUEST)
  621. /*
  622. * Message length - doesn't follow normal TLS convention:
  623. * the length isn't the last thing in the message header.
  624. * We'll need to fill this in later when we know the
  625. * length. Set it to zero for now
  626. */
  627. || !WPACKET_put_bytes_u24(&wpkt, 0)
  628. /*
  629. * Message sequence number is always 0 for a
  630. * HelloVerifyRequest
  631. */
  632. || !WPACKET_put_bytes_u16(&wpkt, 0)
  633. /*
  634. * We never fragment a HelloVerifyRequest, so fragment
  635. * offset is 0
  636. */
  637. || !WPACKET_put_bytes_u24(&wpkt, 0)
  638. /*
  639. * Fragment length is the same as message length, but
  640. * this *is* the last thing in the message header so we
  641. * can just start a sub-packet. No need to come back
  642. * later for this one.
  643. */
  644. || !WPACKET_start_sub_packet_u24(&wpkt)
  645. /* Create the actual HelloVerifyRequest body */
  646. || !dtls_raw_hello_verify_request(&wpkt, cookie, cookielen)
  647. /* Close message body */
  648. || !WPACKET_close(&wpkt)
  649. /* Close record body */
  650. || !WPACKET_close(&wpkt)
  651. || !WPACKET_get_total_written(&wpkt, &wreclen)
  652. || !WPACKET_finish(&wpkt)) {
  653. SSLerr(SSL_F_DTLSV1_LISTEN, ERR_R_INTERNAL_ERROR);
  654. WPACKET_cleanup(&wpkt);
  655. /* This is fatal */
  656. return -1;
  657. }
  658. /*
  659. * Fix up the message len in the message header. Its the same as the
  660. * fragment len which has been filled in by WPACKET, so just copy
  661. * that. Destination for the message len is after the record header
  662. * plus one byte for the message content type. The source is the
  663. * last 3 bytes of the message header
  664. */
  665. memcpy(&wbuf[DTLS1_RT_HEADER_LENGTH + 1],
  666. &wbuf[DTLS1_RT_HEADER_LENGTH + DTLS1_HM_HEADER_LENGTH - 3],
  667. 3);
  668. if (s->msg_callback)
  669. s->msg_callback(1, 0, SSL3_RT_HEADER, buf,
  670. DTLS1_RT_HEADER_LENGTH, s, s->msg_callback_arg);
  671. if ((tmpclient = BIO_ADDR_new()) == NULL) {
  672. SSLerr(SSL_F_DTLSV1_LISTEN, ERR_R_MALLOC_FAILURE);
  673. goto end;
  674. }
  675. /*
  676. * This is unnecessary if rbio and wbio are one and the same - but
  677. * maybe they're not. We ignore errors here - some BIOs do not
  678. * support this.
  679. */
  680. if (BIO_dgram_get_peer(rbio, tmpclient) > 0) {
  681. (void)BIO_dgram_set_peer(wbio, tmpclient);
  682. }
  683. BIO_ADDR_free(tmpclient);
  684. tmpclient = NULL;
  685. /* TODO(size_t): convert this call */
  686. if (BIO_write(wbio, wbuf, wreclen) < (int)wreclen) {
  687. if (BIO_should_retry(wbio)) {
  688. /*
  689. * Non-blocking IO...but we're stateless, so we're just
  690. * going to drop this packet.
  691. */
  692. goto end;
  693. }
  694. return -1;
  695. }
  696. if (BIO_flush(wbio) <= 0) {
  697. if (BIO_should_retry(wbio)) {
  698. /*
  699. * Non-blocking IO...but we're stateless, so we're just
  700. * going to drop this packet.
  701. */
  702. goto end;
  703. }
  704. return -1;
  705. }
  706. }
  707. } while (next != LISTEN_SUCCESS);
  708. /*
  709. * Set expected sequence numbers to continue the handshake.
  710. */
  711. s->d1->handshake_read_seq = 1;
  712. s->d1->handshake_write_seq = 1;
  713. s->d1->next_handshake_write_seq = 1;
  714. DTLS_RECORD_LAYER_set_write_sequence(&s->rlayer, seq);
  715. /*
  716. * We are doing cookie exchange, so make sure we set that option in the
  717. * SSL object
  718. */
  719. SSL_set_options(s, SSL_OP_COOKIE_EXCHANGE);
  720. /*
  721. * Tell the state machine that we've done the initial hello verify
  722. * exchange
  723. */
  724. ossl_statem_set_hello_verify_done(s);
  725. /*
  726. * Some BIOs may not support this. If we fail we clear the client address
  727. */
  728. if (BIO_dgram_get_peer(rbio, client) <= 0)
  729. BIO_ADDR_clear(client);
  730. /* Buffer the record in the processed_rcds queue */
  731. if (!dtls_buffer_listen_record(s, reclen, seq, align))
  732. return -1;
  733. ret = 1;
  734. end:
  735. BIO_ADDR_free(tmpclient);
  736. return ret;
  737. }
  738. #endif
  739. static int dtls1_handshake_write(SSL *s)
  740. {
  741. return dtls1_do_write(s, SSL3_RT_HANDSHAKE);
  742. }
  743. int dtls1_shutdown(SSL *s)
  744. {
  745. int ret;
  746. #ifndef OPENSSL_NO_SCTP
  747. BIO *wbio;
  748. wbio = SSL_get_wbio(s);
  749. if (wbio != NULL && BIO_dgram_is_sctp(wbio) &&
  750. !(s->shutdown & SSL_SENT_SHUTDOWN)) {
  751. ret = BIO_dgram_sctp_wait_for_dry(wbio);
  752. if (ret < 0)
  753. return -1;
  754. if (ret == 0)
  755. BIO_ctrl(SSL_get_wbio(s), BIO_CTRL_DGRAM_SCTP_SAVE_SHUTDOWN, 1,
  756. NULL);
  757. }
  758. #endif
  759. ret = ssl3_shutdown(s);
  760. #ifndef OPENSSL_NO_SCTP
  761. BIO_ctrl(SSL_get_wbio(s), BIO_CTRL_DGRAM_SCTP_SAVE_SHUTDOWN, 0, NULL);
  762. #endif
  763. return ret;
  764. }
  765. int dtls1_query_mtu(SSL *s)
  766. {
  767. if (s->d1->link_mtu) {
  768. s->d1->mtu =
  769. s->d1->link_mtu - BIO_dgram_get_mtu_overhead(SSL_get_wbio(s));
  770. s->d1->link_mtu = 0;
  771. }
  772. /* AHA! Figure out the MTU, and stick to the right size */
  773. if (s->d1->mtu < dtls1_min_mtu(s)) {
  774. if (!(SSL_get_options(s) & SSL_OP_NO_QUERY_MTU)) {
  775. s->d1->mtu =
  776. BIO_ctrl(SSL_get_wbio(s), BIO_CTRL_DGRAM_QUERY_MTU, 0, NULL);
  777. /*
  778. * I've seen the kernel return bogus numbers when it doesn't know
  779. * (initial write), so just make sure we have a reasonable number
  780. */
  781. if (s->d1->mtu < dtls1_min_mtu(s)) {
  782. /* Set to min mtu */
  783. s->d1->mtu = dtls1_min_mtu(s);
  784. BIO_ctrl(SSL_get_wbio(s), BIO_CTRL_DGRAM_SET_MTU,
  785. (long)s->d1->mtu, NULL);
  786. }
  787. } else
  788. return 0;
  789. }
  790. return 1;
  791. }
  792. static size_t dtls1_link_min_mtu(void)
  793. {
  794. return (g_probable_mtu[(sizeof(g_probable_mtu) /
  795. sizeof(g_probable_mtu[0])) - 1]);
  796. }
  797. size_t dtls1_min_mtu(SSL *s)
  798. {
  799. return dtls1_link_min_mtu() - BIO_dgram_get_mtu_overhead(SSL_get_wbio(s));
  800. }
  801. size_t DTLS_get_data_mtu(const SSL *s)
  802. {
  803. size_t mac_overhead, int_overhead, blocksize, ext_overhead;
  804. const SSL_CIPHER *ciph = SSL_get_current_cipher(s);
  805. size_t mtu = s->d1->mtu;
  806. if (ciph == NULL)
  807. return 0;
  808. if (!ssl_cipher_get_overhead(ciph, &mac_overhead, &int_overhead,
  809. &blocksize, &ext_overhead))
  810. return 0;
  811. if (SSL_READ_ETM(s))
  812. ext_overhead += mac_overhead;
  813. else
  814. int_overhead += mac_overhead;
  815. /* Subtract external overhead (e.g. IV/nonce, separate MAC) */
  816. if (ext_overhead + DTLS1_RT_HEADER_LENGTH >= mtu)
  817. return 0;
  818. mtu -= ext_overhead + DTLS1_RT_HEADER_LENGTH;
  819. /* Round encrypted payload down to cipher block size (for CBC etc.)
  820. * No check for overflow since 'mtu % blocksize' cannot exceed mtu. */
  821. if (blocksize)
  822. mtu -= (mtu % blocksize);
  823. /* Subtract internal overhead (e.g. CBC padding len byte) */
  824. if (int_overhead >= mtu)
  825. return 0;
  826. mtu -= int_overhead;
  827. return mtu;
  828. }
  829. void DTLS_set_timer_cb(SSL *s, DTLS_timer_cb cb)
  830. {
  831. s->d1->timer_cb = cb;
  832. }