1 /*
2  *  UDP proxy: emulate an unreliable UDP connexion for DTLS testing
3  *
4  *  Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
5  *  SPDX-License-Identifier: Apache-2.0
6  *
7  *  Licensed under the Apache License, Version 2.0 (the "License"); you may
8  *  not use this file except in compliance with the License.
9  *  You may obtain a copy of the License at
10  *
11  *  http://www.apache.org/licenses/LICENSE-2.0
12  *
13  *  Unless required by applicable law or agreed to in writing, software
14  *  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15  *  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  *  See the License for the specific language governing permissions and
17  *  limitations under the License.
18  *
19  *  This file is part of mbed TLS (https://tls.mbed.org)
20  */
21 
22 /*
23  * Warning: this is an internal utility program we use for tests.
24  * It does break some abstractions from the NET layer, and is thus NOT an
25  * example of good general usage.
26  */
27 
28 #if !defined(MBEDTLS_CONFIG_FILE)
29 #include "mbedtls/config.h"
30 #else
31 #include MBEDTLS_CONFIG_FILE
32 #endif
33 
34 #if defined(MBEDTLS_PLATFORM_C)
35 #include "mbedtls/platform.h"
36 #else
37 #include <stdio.h>
38 #include <stdlib.h>
39 #include <time.h>
40 #define mbedtls_time       time
41 #define mbedtls_time_t     time_t
42 #define mbedtls_printf     printf
43 #endif
44 
45 #if !defined(MBEDTLS_NET_C)
main(void)46 int main( void )
47 {
48     mbedtls_printf( "MBEDTLS_NET_C not defined.\n" );
49     return( 0 );
50 }
51 #else
52 
53 #include "mbedtls/net_sockets.h"
54 #include "mbedtls/error.h"
55 #include "mbedtls/ssl.h"
56 
57 #include <string.h>
58 
59 /* For select() */
60 #if (defined(_WIN32) || defined(_WIN32_WCE)) && !defined(EFIX64) && \
61     !defined(EFI32)
62 #include <winsock2.h>
63 #include <windows.h>
64 #if defined(_MSC_VER)
65 #if defined(_WIN32_WCE)
66 #pragma comment( lib, "ws2.lib" )
67 #else
68 #pragma comment( lib, "ws2_32.lib" )
69 #endif
70 #endif /* _MSC_VER */
71 #else /* ( _WIN32 || _WIN32_WCE ) && !EFIX64 && !EFI32 */
72 #include <sys/time.h>
73 #include <sys/types.h>
74 #include <unistd.h>
75 #endif /* ( _WIN32 || _WIN32_WCE ) && !EFIX64 && !EFI32 */
76 
77 /* For gettimeofday() */
78 #if !defined(_WIN32)
79 #include <sys/time.h>
80 #endif
81 
82 #define MAX_MSG_SIZE            16384 + 2048 /* max record/datagram size */
83 
84 #define DFL_SERVER_ADDR         "localhost"
85 #define DFL_SERVER_PORT         "4433"
86 #define DFL_LISTEN_ADDR         "localhost"
87 #define DFL_LISTEN_PORT         "5556"
88 
89 #define USAGE                                                               \
90     "\n usage: udp_proxy param=<>...\n"                                     \
91     "\n acceptable parameters:\n"                                           \
92     "    server_addr=%%s      default: localhost\n"                         \
93     "    server_port=%%d      default: 4433\n"                              \
94     "    listen_addr=%%s      default: localhost\n"                         \
95     "    listen_port=%%d      default: 4433\n"                              \
96     "\n"                                                                    \
97     "    duplicate=%%d        default: 0 (no duplication)\n"                \
98     "                        duplicate about 1:N packets randomly\n"        \
99     "    delay=%%d            default: 0 (no delayed packets)\n"            \
100     "                        delay about 1:N packets randomly\n"            \
101     "    delay_ccs=0/1       default: 0 (don't delay ChangeCipherSpec)\n"   \
102     "    drop=%%d             default: 0 (no dropped packets)\n"            \
103     "                        drop about 1:N packets randomly\n"             \
104     "    mtu=%%d              default: 0 (unlimited)\n"                     \
105     "                        drop packets larger than N bytes\n"            \
106     "    bad_ad=0/1          default: 0 (don't add bad ApplicationData)\n"  \
107     "    protect_hvr=0/1     default: 0 (don't protect HelloVerifyRequest)\n" \
108     "    protect_len=%%d     default: (don't protect packets of this size)\n" \
109     "\n"                                                                    \
110     "    seed=%%d             default: (use current time)\n"                \
111     "\n"
112 
113 /*
114  * global options
115  */
116 static struct options
117 {
118     const char *server_addr;    /* address to forward packets to            */
119     const char *server_port;    /* port to forward packets to               */
120     const char *listen_addr;    /* address for accepting client connections */
121     const char *listen_port;    /* port for accepting client connections    */
122 
123     int duplicate;              /* duplicate 1 in N packets (none if 0)     */
124     int delay;                  /* delay 1 packet in N (none if 0)          */
125     int delay_ccs;              /* delay ChangeCipherSpec                   */
126     int drop;                   /* drop 1 packet in N (none if 0)           */
127     int mtu;                    /* drop packets larger than this            */
128     int bad_ad;                 /* inject corrupted ApplicationData record  */
129     int protect_hvr;            /* never drop or delay HelloVerifyRequest   */
130     int protect_len;            /* never drop/delay packet of the given size*/
131 
132     unsigned int seed;          /* seed for "random" events                 */
133 } opt;
134 
exit_usage(const char * name,const char * value)135 static void exit_usage( const char *name, const char *value )
136 {
137     if( value == NULL )
138         mbedtls_printf( " unknown option or missing value: %s\n", name );
139     else
140         mbedtls_printf( " option %s: illegal value: %s\n", name, value );
141 
142     mbedtls_printf( USAGE );
143     exit( 1 );
144 }
145 
get_options(int argc,char * argv[])146 static void get_options( int argc, char *argv[] )
147 {
148     int i;
149     char *p, *q;
150 
151     opt.server_addr    = DFL_SERVER_ADDR;
152     opt.server_port    = DFL_SERVER_PORT;
153     opt.listen_addr    = DFL_LISTEN_ADDR;
154     opt.listen_port    = DFL_LISTEN_PORT;
155     /* Other members default to 0 */
156 
157     for( i = 1; i < argc; i++ )
158     {
159         p = argv[i];
160         if( ( q = strchr( p, '=' ) ) == NULL )
161             exit_usage( p, NULL );
162         *q++ = '\0';
163 
164         if( strcmp( p, "server_addr" ) == 0 )
165             opt.server_addr = q;
166         else if( strcmp( p, "server_port" ) == 0 )
167             opt.server_port = q;
168         else if( strcmp( p, "listen_addr" ) == 0 )
169             opt.listen_addr = q;
170         else if( strcmp( p, "listen_port" ) == 0 )
171             opt.listen_port = q;
172         else if( strcmp( p, "duplicate" ) == 0 )
173         {
174             opt.duplicate = atoi( q );
175             if( opt.duplicate < 0 || opt.duplicate > 20 )
176                 exit_usage( p, q );
177         }
178         else if( strcmp( p, "delay" ) == 0 )
179         {
180             opt.delay = atoi( q );
181             if( opt.delay < 0 || opt.delay > 20 || opt.delay == 1 )
182                 exit_usage( p, q );
183         }
184         else if( strcmp( p, "delay_ccs" ) == 0 )
185         {
186             opt.delay_ccs = atoi( q );
187             if( opt.delay_ccs < 0 || opt.delay_ccs > 1 )
188                 exit_usage( p, q );
189         }
190         else if( strcmp( p, "drop" ) == 0 )
191         {
192             opt.drop = atoi( q );
193             if( opt.drop < 0 || opt.drop > 20 || opt.drop == 1 )
194                 exit_usage( p, q );
195         }
196         else if( strcmp( p, "mtu" ) == 0 )
197         {
198             opt.mtu = atoi( q );
199             if( opt.mtu < 0 || opt.mtu > MAX_MSG_SIZE )
200                 exit_usage( p, q );
201         }
202         else if( strcmp( p, "bad_ad" ) == 0 )
203         {
204             opt.bad_ad = atoi( q );
205             if( opt.bad_ad < 0 || opt.bad_ad > 1 )
206                 exit_usage( p, q );
207         }
208         else if( strcmp( p, "protect_hvr" ) == 0 )
209         {
210             opt.protect_hvr = atoi( q );
211             if( opt.protect_hvr < 0 || opt.protect_hvr > 1 )
212                 exit_usage( p, q );
213         }
214         else if( strcmp( p, "protect_len" ) == 0 )
215         {
216             opt.protect_len = atoi( q );
217             if( opt.protect_len < 0 )
218                 exit_usage( p, q );
219         }
220         else if( strcmp( p, "seed" ) == 0 )
221         {
222             opt.seed = atoi( q );
223             if( opt.seed == 0 )
224                 exit_usage( p, q );
225         }
226         else
227             exit_usage( p, NULL );
228     }
229 }
230 
msg_type(unsigned char * msg,size_t len)231 static const char *msg_type( unsigned char *msg, size_t len )
232 {
233     if( len < 1 )                           return( "Invalid" );
234     switch( msg[0] )
235     {
236         case MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC:    return( "ChangeCipherSpec" );
237         case MBEDTLS_SSL_MSG_ALERT:                 return( "Alert" );
238         case MBEDTLS_SSL_MSG_APPLICATION_DATA:      return( "ApplicationData" );
239         case MBEDTLS_SSL_MSG_HANDSHAKE:             break; /* See below */
240         default:                            return( "Unknown" );
241     }
242 
243     if( len < 13 + 12 )                     return( "Invalid handshake" );
244 
245     /*
246      * Our handshake message are less than 2^16 bytes long, so they should
247      * have 0 as the first byte of length, frag_offset and frag_length.
248      * Otherwise, assume they are encrypted.
249      */
250     if( msg[14] || msg[19] || msg[22] )     return( "Encrypted handshake" );
251 
252     switch( msg[13] )
253     {
254         case MBEDTLS_SSL_HS_HELLO_REQUEST:          return( "HelloRequest" );
255         case MBEDTLS_SSL_HS_CLIENT_HELLO:           return( "ClientHello" );
256         case MBEDTLS_SSL_HS_SERVER_HELLO:           return( "ServerHello" );
257         case MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST:   return( "HelloVerifyRequest" );
258         case MBEDTLS_SSL_HS_NEW_SESSION_TICKET:     return( "NewSessionTicket" );
259         case MBEDTLS_SSL_HS_CERTIFICATE:            return( "Certificate" );
260         case MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE:    return( "ServerKeyExchange" );
261         case MBEDTLS_SSL_HS_CERTIFICATE_REQUEST:    return( "CertificateRequest" );
262         case MBEDTLS_SSL_HS_SERVER_HELLO_DONE:      return( "ServerHelloDone" );
263         case MBEDTLS_SSL_HS_CERTIFICATE_VERIFY:     return( "CertificateVerify" );
264         case MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE:    return( "ClientKeyExchange" );
265         case MBEDTLS_SSL_HS_FINISHED:               return( "Finished" );
266         default:                            return( "Unknown handshake" );
267     }
268 }
269 
270 /* Return elapsed time in milliseconds since the first call */
ellapsed_time(void)271 static unsigned long ellapsed_time( void )
272 {
273 #if defined(_WIN32)
274     return( 0 );
275 #else
276     static struct timeval ref = { 0, 0 };
277     struct timeval now;
278 
279     if( ref.tv_sec == 0 && ref.tv_usec == 0 )
280     {
281         gettimeofday( &ref, NULL );
282         return( 0 );
283     }
284 
285     gettimeofday( &now, NULL );
286     return( 1000 * ( now.tv_sec  - ref.tv_sec )
287                  + ( now.tv_usec - ref.tv_usec ) / 1000 );
288 #endif
289 }
290 
291 typedef struct
292 {
293     mbedtls_net_context *dst;
294     const char *way;
295     const char *type;
296     unsigned len;
297     unsigned char buf[MAX_MSG_SIZE];
298 } packet;
299 
300 /* Print packet. Outgoing packets come with a reason (forward, dupl, etc.) */
print_packet(const packet * p,const char * why)301 void print_packet( const packet *p, const char *why )
302 {
303     if( why == NULL )
304         mbedtls_printf( "  %05lu %s %s (%u bytes)\n",
305                 ellapsed_time(), p->way, p->type, p->len );
306     else
307         mbedtls_printf( "        %s %s (%u bytes): %s\n",
308                 p->way, p->type, p->len, why );
309     fflush( stdout );
310 }
311 
send_packet(const packet * p,const char * why)312 int send_packet( const packet *p, const char *why )
313 {
314     int ret;
315     mbedtls_net_context *dst = p->dst;
316 
317     /* insert corrupted ApplicationData record? */
318     if( opt.bad_ad &&
319         strcmp( p->type, "ApplicationData" ) == 0 )
320     {
321         unsigned char buf[MAX_MSG_SIZE];
322         memcpy( buf, p->buf, p->len );
323         ++buf[p->len - 1];
324 
325         print_packet( p, "corrupted" );
326         if( ( ret = mbedtls_net_send( dst, buf, p->len ) ) <= 0 )
327         {
328             mbedtls_printf( "  ! mbedtls_net_send returned %d\n", ret );
329             return( ret );
330         }
331     }
332 
333     print_packet( p, why );
334     if( ( ret = mbedtls_net_send( dst, p->buf, p->len ) ) <= 0 )
335     {
336         mbedtls_printf( "  ! mbedtls_net_send returned %d\n", ret );
337         return( ret );
338     }
339 
340     /* Don't duplicate Application Data, only handshake covered */
341     if( opt.duplicate != 0 &&
342         strcmp( p->type, "ApplicationData" ) != 0 &&
343         rand() % opt.duplicate == 0 )
344     {
345         print_packet( p, "duplicated" );
346 
347         if( ( ret = mbedtls_net_send( dst, p->buf, p->len ) ) <= 0 )
348         {
349             mbedtls_printf( "  ! mbedtls_net_send returned %d\n", ret );
350             return( ret );
351         }
352     }
353 
354     return( 0 );
355 }
356 
357 static packet prev;
358 
clear_pending(void)359 void clear_pending( void )
360 {
361     memset( &prev, 0, sizeof( packet ) );
362 }
363 
364 /*
365  * Avoid dropping or delaying a packet that was already dropped twice: this
366  * only results in uninteresting timeouts. We can't rely on type to identify
367  * packets, since during renegotiation they're all encrypted.  So, rely on
368  * size mod 2048 (which is usually just size).
369  */
370 static unsigned char dropped[2048] = { 0 };
371 #define DROP_MAX 2
372 
373 /*
374  * OpenSSL groups packets in a datagram the first time it sends them, but not
375  * when it resends them. Count every record as seen the first time.
376  */
update_dropped(const packet * p)377 void update_dropped( const packet *p )
378 {
379     size_t id = p->len % sizeof( dropped );
380     const unsigned char *end = p->buf + p->len;
381     const unsigned char *cur = p->buf;
382     size_t len = ( ( cur[11] << 8 ) | cur[12] ) + 13;
383 
384     ++dropped[id];
385 
386     /* Avoid counting single record twice */
387     if( len == p->len )
388         return;
389 
390     while( cur < end )
391     {
392         len = ( ( cur[11] << 8 ) | cur[12] ) + 13;
393 
394         id = len % sizeof( dropped );
395         ++dropped[id];
396 
397         cur += len;
398     }
399 }
400 
handle_message(const char * way,mbedtls_net_context * dst,mbedtls_net_context * src)401 int handle_message( const char *way,
402                     mbedtls_net_context *dst,
403                     mbedtls_net_context *src )
404 {
405     int ret;
406     packet cur;
407     size_t id;
408 
409     /* receive packet */
410     if( ( ret = mbedtls_net_recv( src, cur.buf, sizeof( cur.buf ) ) ) <= 0 )
411     {
412         mbedtls_printf( "  ! mbedtls_net_recv returned %d\n", ret );
413         return( ret );
414     }
415 
416     cur.len  = ret;
417     cur.type = msg_type( cur.buf, cur.len );
418     cur.way  = way;
419     cur.dst  = dst;
420     print_packet( &cur, NULL );
421 
422     id = cur.len % sizeof( dropped );
423 
424     /* do we want to drop, delay, or forward it? */
425     if( ( opt.mtu != 0 &&
426           cur.len > (unsigned) opt.mtu ) ||
427         ( opt.drop != 0 &&
428           strcmp( cur.type, "ApplicationData" ) != 0 &&
429           ! ( opt.protect_hvr &&
430               strcmp( cur.type, "HelloVerifyRequest" ) == 0 ) &&
431           cur.len != (size_t) opt.protect_len &&
432           dropped[id] < DROP_MAX &&
433           rand() % opt.drop == 0 ) )
434     {
435         update_dropped( &cur );
436     }
437     else if( ( opt.delay_ccs == 1 &&
438                strcmp( cur.type, "ChangeCipherSpec" ) == 0 ) ||
439              ( opt.delay != 0 &&
440                strcmp( cur.type, "ApplicationData" ) != 0 &&
441                ! ( opt.protect_hvr &&
442                    strcmp( cur.type, "HelloVerifyRequest" ) == 0 ) &&
443                prev.dst == NULL &&
444                cur.len != (size_t) opt.protect_len &&
445                dropped[id] < DROP_MAX &&
446                rand() % opt.delay == 0 ) )
447     {
448         memcpy( &prev, &cur, sizeof( packet ) );
449     }
450     else
451     {
452         /* forward and possibly duplicate */
453         if( ( ret = send_packet( &cur, "forwarded" ) ) != 0 )
454             return( ret );
455 
456         /* send previously delayed message if any */
457         if( prev.dst != NULL )
458         {
459             ret = send_packet( &prev, "delayed" );
460             memset( &prev, 0, sizeof( packet ) );
461             if( ret != 0 )
462                 return( ret );
463         }
464     }
465 
466     return( 0 );
467 }
468 
main(int argc,char * argv[])469 int main( int argc, char *argv[] )
470 {
471     int ret;
472 
473     mbedtls_net_context listen_fd, client_fd, server_fd;
474 
475     int nb_fds;
476     fd_set read_fds;
477 
478     mbedtls_net_init( &listen_fd );
479     mbedtls_net_init( &client_fd );
480     mbedtls_net_init( &server_fd );
481 
482     get_options( argc, argv );
483 
484     /*
485      * Decisions to drop/delay/duplicate packets are pseudo-random: dropping
486      * exactly 1 in N packets would lead to problems when a flight has exactly
487      * N packets: the same packet would be dropped on every resend.
488      *
489      * In order to be able to reproduce problems reliably, the seed may be
490      * specified explicitly.
491      */
492     if( opt.seed == 0 )
493     {
494         opt.seed = (unsigned int) time( NULL );
495         mbedtls_printf( "  . Pseudo-random seed: %u\n", opt.seed );
496     }
497 
498     srand( opt.seed );
499 
500     /*
501      * 0. "Connect" to the server
502      */
503     mbedtls_printf( "  . Connect to server on UDP/%s/%s ...",
504             opt.server_addr, opt.server_port );
505     fflush( stdout );
506 
507     if( ( ret = mbedtls_net_connect( &server_fd, opt.server_addr, opt.server_port,
508                              MBEDTLS_NET_PROTO_UDP ) ) != 0 )
509     {
510         mbedtls_printf( " failed\n  ! mbedtls_net_connect returned %d\n\n", ret );
511         goto exit;
512     }
513 
514     mbedtls_printf( " ok\n" );
515 
516     /*
517      * 1. Setup the "listening" UDP socket
518      */
519     mbedtls_printf( "  . Bind on UDP/%s/%s ...",
520             opt.listen_addr, opt.listen_port );
521     fflush( stdout );
522 
523     if( ( ret = mbedtls_net_bind( &listen_fd, opt.listen_addr, opt.listen_port,
524                           MBEDTLS_NET_PROTO_UDP ) ) != 0 )
525     {
526         mbedtls_printf( " failed\n  ! mbedtls_net_bind returned %d\n\n", ret );
527         goto exit;
528     }
529 
530     mbedtls_printf( " ok\n" );
531 
532     /*
533      * 2. Wait until a client connects
534      */
535 accept:
536     mbedtls_net_free( &client_fd );
537 
538     mbedtls_printf( "  . Waiting for a remote connection ..." );
539     fflush( stdout );
540 
541     if( ( ret = mbedtls_net_accept( &listen_fd, &client_fd,
542                                     NULL, 0, NULL ) ) != 0 )
543     {
544         mbedtls_printf( " failed\n  ! mbedtls_net_accept returned %d\n\n", ret );
545         goto exit;
546     }
547 
548     mbedtls_printf( " ok\n" );
549 
550     /*
551      * 3. Forward packets forever (kill the process to terminate it)
552      */
553     clear_pending();
554     memset( dropped, 0, sizeof( dropped ) );
555 
556     nb_fds = client_fd.fd;
557     if( nb_fds < server_fd.fd )
558         nb_fds = server_fd.fd;
559     if( nb_fds < listen_fd.fd )
560         nb_fds = listen_fd.fd;
561     ++nb_fds;
562 
563     while( 1 )
564     {
565         FD_ZERO( &read_fds );
566         FD_SET( server_fd.fd, &read_fds );
567         FD_SET( client_fd.fd, &read_fds );
568         FD_SET( listen_fd.fd, &read_fds );
569 
570         if( ( ret = select( nb_fds, &read_fds, NULL, NULL, NULL ) ) <= 0 )
571         {
572             perror( "select" );
573             goto exit;
574         }
575 
576         if( FD_ISSET( listen_fd.fd, &read_fds ) )
577             goto accept;
578 
579         if( FD_ISSET( client_fd.fd, &read_fds ) )
580         {
581             if( ( ret = handle_message( "S <- C",
582                                         &server_fd, &client_fd ) ) != 0 )
583                 goto accept;
584         }
585 
586         if( FD_ISSET( server_fd.fd, &read_fds ) )
587         {
588             if( ( ret = handle_message( "S -> C",
589                                         &client_fd, &server_fd ) ) != 0 )
590                 goto accept;
591         }
592     }
593 
594 exit:
595 
596 #ifdef MBEDTLS_ERROR_C
597     if( ret != 0 )
598     {
599         char error_buf[100];
600         mbedtls_strerror( ret, error_buf, 100 );
601         mbedtls_printf( "Last error was: -0x%04X - %s\n\n", - ret, error_buf );
602         fflush( stdout );
603     }
604 #endif
605 
606     mbedtls_net_free( &client_fd );
607     mbedtls_net_free( &server_fd );
608     mbedtls_net_free( &listen_fd );
609 
610 #if defined(_WIN32)
611     mbedtls_printf( "  Press Enter to exit this program.\n" );
612     fflush( stdout ); getchar();
613 #endif
614 
615     return( ret != 0 );
616 }
617 
618 #endif /* MBEDTLS_NET_C */
619