1 /*****************************************************************************
3 *****************************************************************************
4 * Copyright (C) 2004-2006 Rémi Denis-Courmont
7 * Authors: Rémi Denis-Courmont <rem # videolan.org>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
32 #include <sys/types.h>
37 #ifdef HAVE_SYS_STAT_H
38 # include <sys/stat.h>
46 #include <vlc_charset.h>
49 #include <gnutls/gnutls.h>
50 #include <gnutls/x509.h>
53 #define CACHE_TIMEOUT 3600
56 /*****************************************************************************
58 *****************************************************************************/
59 static int OpenClient (vlc_object_t *);
60 static void CloseClient (vlc_object_t *);
61 static int OpenServer (vlc_object_t *);
62 static void CloseServer (vlc_object_t *);
64 #define DH_BITS_TEXT N_("Diffie-Hellman prime bits")
65 #define DH_BITS_LONGTEXT N_( \
66 "This allows you to modify the Diffie-Hellman prime's number of bits, " \
67 "used for TLS or SSL-based server-side encryption. This is generally " \
70 #define CACHE_TIMEOUT_TEXT N_("Expiration time for resumed TLS sessions")
71 #define CACHE_TIMEOUT_LONGTEXT N_( \
72 "It is possible to cache the resumed TLS sessions. This is the expiration "\
73 "time of the sessions stored in this cache, in seconds." )
75 #define CACHE_SIZE_TEXT N_("Number of resumed TLS sessions")
76 #define CACHE_SIZE_LONGTEXT N_( \
77 "This is the maximum number of resumed TLS sessions that " \
78 "the cache will hold." )
80 #define CHECK_CERT_TEXT N_("Check TLS/SSL server certificate validity")
81 #define CHECK_CERT_LONGTEXT N_( \
82 "This ensures that the server certificate is valid " \
83 "(i.e. signed by an approved Certification Authority)." )
86 set_shortname( "GnuTLS" );
87 set_description( _("GnuTLS transport layer security") );
88 set_capability( "tls client", 1 );
89 set_callbacks( OpenClient, CloseClient );
90 set_category( CAT_ADVANCED );
91 set_subcategory( SUBCAT_ADVANCED_MISC );
93 add_bool( "tls-check-cert", VLC_TRUE, NULL, CHECK_CERT_TEXT,
94 CHECK_CERT_LONGTEXT, VLC_FALSE );
95 add_obsolete_bool( "tls-check-hostname" );
98 set_description( _("GnuTLS server") );
99 set_capability( "tls server", 1 );
100 set_category( CAT_ADVANCED );
101 set_subcategory( SUBCAT_ADVANCED_MISC );
102 set_callbacks( OpenServer, CloseServer );
104 add_integer( "gnutls-dh-bits", DH_BITS, NULL, DH_BITS_TEXT,
105 DH_BITS_LONGTEXT, VLC_TRUE );
106 add_integer( "gnutls-cache-timeout", CACHE_TIMEOUT, NULL,
107 CACHE_TIMEOUT_TEXT, CACHE_TIMEOUT_LONGTEXT, VLC_TRUE );
108 add_integer( "gnutls-cache-size", CACHE_SIZE, NULL, CACHE_SIZE_TEXT,
109 CACHE_SIZE_LONGTEXT, VLC_TRUE );
114 #ifdef LIBVLC_USE_PTHREAD
115 GCRY_THREAD_OPTION_PTHREAD_IMPL;
116 # define gcry_threads_vlc gcry_threads_pthread
119 * gcrypt thread option VLC implementation
122 # define NEED_THREAD_CONTEXT 1
123 static vlc_object_t *__p_gcry_data = NULL;
125 static int gcry_vlc_mutex_init( void **p_sys )
128 vlc_mutex_t *p_lock = (vlc_mutex_t *)malloc( sizeof( vlc_mutex_t ) );
133 i_val = vlc_mutex_init( __p_gcry_data, p_lock );
141 static int gcry_vlc_mutex_destroy( void **p_sys )
144 vlc_mutex_t *p_lock = (vlc_mutex_t *)*p_sys;
146 i_val = vlc_mutex_destroy( p_lock );
151 static int gcry_vlc_mutex_lock( void **p_sys )
153 return vlc_mutex_lock( (vlc_mutex_t *)*p_sys );
156 static int gcry_vlc_mutex_unlock( void **lock )
158 return vlc_mutex_unlock( (vlc_mutex_t *)*lock );
161 static struct gcry_thread_cbs gcry_threads_vlc =
163 GCRY_THREAD_OPTION_USER,
166 gcry_vlc_mutex_destroy,
168 gcry_vlc_mutex_unlock
174 * Initializes GnuTLS with proper locking.
175 * @return VLC_SUCCESS on success, a VLC error code otherwise.
177 static int gnutls_Init (vlc_object_t *p_this)
179 int ret = VLC_EGENERIC;
181 vlc_mutex_t *lock = var_GetGlobalMutex ("gnutls_mutex");
182 vlc_mutex_lock (lock);
184 /* This should probably be removed/fixed. It will screw up with multiple
185 * LibVLC instances. */
186 #ifdef NEED_THREAD_CONTEXT
187 __p_gcry_data = VLC_OBJECT (p_this->p_libvlc);
190 gcry_control (GCRYCTL_SET_THREAD_CBS, &gcry_threads_vlc);
191 if (gnutls_global_init ())
193 msg_Err (p_this, "cannot initialize GnuTLS");
197 const char *psz_version = gnutls_check_version ("1.3.3");
198 if (psz_version == NULL)
200 msg_Err (p_this, "unsupported GnuTLS version");
201 gnutls_global_deinit ();
205 msg_Dbg (p_this, "GnuTLS v%s initialized", psz_version);
209 vlc_mutex_unlock (lock);
215 * Deinitializes GnuTLS.
217 static void gnutls_Deinit (vlc_object_t *p_this)
219 vlc_mutex_t *lock = var_GetGlobalMutex( "gnutls_mutex" );
220 vlc_mutex_lock (lock);
222 gnutls_global_deinit ();
223 msg_Dbg (p_this, "GnuTLS deinitialized");
224 vlc_mutex_unlock (lock);
228 static int gnutls_Error (vlc_object_t *obj, int val)
237 /* WinSock does not return EAGAIN, return EINTR instead */
239 case GNUTLS_E_INTERRUPTED:
241 WSASetLastError (WSAEINTR);
248 msg_Err (obj, "%s", gnutls_strerror (val));
250 if (!gnutls_error_is_fatal (val))
251 msg_Err (obj, "Error above should be handled");
254 WSASetLastError (WSAECONNRESET);
263 struct tls_session_sys_t
265 gnutls_session session;
267 vlc_bool_t b_handshaked;
272 * Sends data through a TLS session.
275 gnutls_Send( void *p_session, const void *buf, int i_length )
278 tls_session_sys_t *p_sys;
280 p_sys = (tls_session_sys_t *)(((tls_session_t *)p_session)->p_sys);
282 val = gnutls_record_send( p_sys->session, buf, i_length );
283 return (val < 0) ? gnutls_Error ((vlc_object_t *)p_session, val) : val;
288 * Receives data through a TLS session.
291 gnutls_Recv( void *p_session, void *buf, int i_length )
294 tls_session_sys_t *p_sys;
296 p_sys = (tls_session_sys_t *)(((tls_session_t *)p_session)->p_sys);
298 val = gnutls_record_recv( p_sys->session, buf, i_length );
299 return (val < 0) ? gnutls_Error ((vlc_object_t *)p_session, val) : val;
304 * @return -1 on error (you need not and must not call tls_SessionClose())
305 * 0 on succesful handshake completion, 1 if more would-be blocking recv is
306 * needed, 2 if more would-be blocking send is required.
309 gnutls_ContinueHandshake( tls_session_t *p_session)
311 tls_session_sys_t *p_sys;
314 p_sys = (tls_session_sys_t *)(p_session->p_sys);
317 WSASetLastError( 0 );
319 val = gnutls_handshake( p_sys->session );
320 if( ( val == GNUTLS_E_AGAIN ) || ( val == GNUTLS_E_INTERRUPTED ) )
321 return 1 + gnutls_record_get_direction( p_sys->session );
326 msg_Dbg( p_session, "Winsock error %d", WSAGetLastError( ) );
328 msg_Err( p_session, "TLS handshake error: %s",
329 gnutls_strerror( val ) );
330 p_session->pf_close( p_session );
334 p_sys->b_handshaked = VLC_TRUE;
345 static const error_msg_t cert_errors[] =
347 { GNUTLS_CERT_INVALID,
348 "Certificate could not be verified" },
349 { GNUTLS_CERT_REVOKED,
350 "Certificate was revoked" },
351 { GNUTLS_CERT_SIGNER_NOT_FOUND,
352 "Certificate's signer was not found" },
353 { GNUTLS_CERT_SIGNER_NOT_CA,
354 "Certificate's signer is not a CA" },
355 { GNUTLS_CERT_INSECURE_ALGORITHM,
356 "Insecure certificate signature algorithm" },
362 gnutls_HandshakeAndValidate( tls_session_t *session )
364 int val = gnutls_ContinueHandshake( session );
368 tls_session_sys_t *p_sys = (tls_session_sys_t *)(session->p_sys);
370 /* certificates chain verification */
372 val = gnutls_certificate_verify_peers2( p_sys->session, &status );
376 msg_Err( session, "Certificate verification failed: %s",
377 gnutls_strerror( val ) );
383 msg_Err( session, "TLS session: access denied" );
384 for( const error_msg_t *e = cert_errors; e->flag; e++ )
386 if( status & e->flag )
388 msg_Err( session, "%s", e->msg );
395 "unknown certificate error (you found a bug in VLC)" );
400 /* certificate (host)name verification */
401 const gnutls_datum *data = gnutls_certificate_get_peers( p_sys->session,
405 msg_Err( session, "Peer certificate not available" );
409 gnutls_x509_crt cert;
410 val = gnutls_x509_crt_init( &cert );
413 msg_Err( session, "x509 fatal error: %s", gnutls_strerror( val ) );
417 val = gnutls_x509_crt_import( cert, data, GNUTLS_X509_FMT_DER );
420 msg_Err( session, "Certificate import error: %s",
421 gnutls_strerror( val ) );
425 if( p_sys->psz_hostname != NULL )
427 if ( !gnutls_x509_crt_check_hostname( cert, p_sys->psz_hostname ) )
429 msg_Err( session, "Certificate does not match \"%s\"",
430 p_sys->psz_hostname );
435 msg_Warn( session, "Certificate and hostname were not verified" );
437 if( gnutls_x509_crt_get_expiration_time( cert ) < time( NULL ) )
439 msg_Err( session, "Certificate expired" );
443 if( gnutls_x509_crt_get_activation_time( cert ) > time ( NULL ) )
445 msg_Err( session, "Certificate not yet valid" );
449 gnutls_x509_crt_deinit( cert );
450 msg_Dbg( session, "TLS/x509 certificate verified" );
454 gnutls_x509_crt_deinit( cert );
456 session->pf_close( session );
461 * Starts negociation of a TLS session.
463 * @param fd stream socket already connected with the peer.
464 * @param psz_hostname if not NULL, hostname to mention as a Server Name,
465 * and to be found in the server's certificate.
467 * @return -1 on error (you need not and must not call tls_SessionClose),
468 * 0 on succesful handshake completion, 1 if more would-be blocking recv is
469 * needed, 2 if more would-be blocking send is required.
472 gnutls_BeginHandshake( tls_session_t *p_session, int fd,
473 const char *psz_hostname )
475 tls_session_sys_t *p_sys = p_session->p_sys;
477 gnutls_transport_set_ptr (p_sys->session, (gnutls_transport_ptr)(intptr_t)fd);
479 if( psz_hostname != NULL )
481 gnutls_server_name_set (p_sys->session, GNUTLS_NAME_DNS, psz_hostname,
482 strlen (psz_hostname));
483 p_sys->psz_hostname = strdup (psz_hostname);
484 if (p_sys->psz_hostname == NULL)
486 p_session->pf_close (p_session);
491 return p_session->pf_handshake2( p_session );
494 typedef int (*tls_prio_func) (gnutls_session_t, const int *);
497 gnutls_SetPriority (vlc_object_t *restrict obj, const char *restrict name,
498 tls_prio_func func, gnutls_session_t session,
499 const int *restrict values)
501 int val = func (session, values);
504 msg_Err (obj, "cannot set %s priorities: %s", name,
505 gnutls_strerror (val));
513 gnutls_SessionPrioritize (vlc_object_t *obj, gnutls_session_t session)
515 /* Note that ordering matters (on the client side) */
516 static const int protos[] =
523 static const int comps[] =
529 static const int macs[] =
532 GNUTLS_MAC_RMD160, // RIPEMD
538 static const int ciphers[] =
540 GNUTLS_CIPHER_AES_256_CBC,
541 GNUTLS_CIPHER_AES_128_CBC,
542 GNUTLS_CIPHER_3DES_CBC,
543 GNUTLS_CIPHER_ARCFOUR_128,
544 //GNUTLS_CIPHER_DES_CBC,
545 //GNUTLS_CIPHER_ARCFOUR_40,
546 //GNUTLS_CIPHER_RC2_40_CBC,
547 //GNUTLS_CIPHER_NULL,
550 static const int kx[] =
555 //GNUTLS_KX_RSA_EXPORT,
556 //GNUTLS_KX_DHE_PSK, TODO
557 //GNUTLS_KX_PSK, TODO
558 //GNUTLS_KX_SRP_RSA, TODO
559 //GNUTLS_KX_SRP_DSS, TODO
560 //GNUTLS_KX_SRP, TODO
564 static const int cert_types[] =
567 //GNUTLS_CRT_OPENPGP, TODO
571 int val = gnutls_set_default_priority (session);
574 msg_Err (obj, "cannot set default TLS priorities: %s",
575 gnutls_strerror (val));
579 if (gnutls_SetPriority (obj, "protocols",
580 gnutls_protocol_set_priority, session, protos)
581 || gnutls_SetPriority (obj, "compression algorithms",
582 gnutls_compression_set_priority, session, comps)
583 || gnutls_SetPriority (obj, "MAC algorithms",
584 gnutls_mac_set_priority, session, macs)
585 || gnutls_SetPriority (obj, "ciphers",
586 gnutls_cipher_set_priority, session, ciphers)
587 || gnutls_SetPriority (obj, "key exchange algorithms",
588 gnutls_kx_set_priority, session, kx)
589 || gnutls_SetPriority (obj, "certificate types",
590 gnutls_certificate_type_set_priority, session,
599 gnutls_Addx509File( vlc_object_t *p_this,
600 gnutls_certificate_credentials cred,
601 const char *psz_path, vlc_bool_t b_priv );
604 gnutls_Addx509Directory( vlc_object_t *p_this,
605 gnutls_certificate_credentials cred,
606 const char *psz_dirname,
611 if( *psz_dirname == '\0' )
614 dir = utf8_opendir( psz_dirname );
617 msg_Warn( p_this, "cannot open directory (%s): %m", psz_dirname );
623 struct stat st1, st2;
624 int fd = dirfd( dir );
627 * Gets stats for the directory path, checks that it is not a
628 * symbolic link (to avoid possibly infinite recursion), and verifies
629 * that the inode is still the same, to avoid TOCTOU race condition.
632 || fstat( fd, &st1 ) || utf8_lstat( psz_dirname, &st2 )
633 || S_ISLNK( st2.st_mode ) || ( st1.st_ino != st2.st_ino ) )
643 char *ent = utf8_readdir (dir);
647 if ((strcmp (ent, ".") == 0) || (strcmp (ent, "..") == 0))
650 char path[strlen (psz_dirname) + strlen (ent) + 2];
651 sprintf (path, "%s"DIR_SEP"%s", psz_dirname, ent);
654 gnutls_Addx509File( p_this, cred, path, b_priv );
663 gnutls_Addx509File( vlc_object_t *p_this,
664 gnutls_certificate_credentials cred,
665 const char *psz_path, vlc_bool_t b_priv )
669 if( utf8_stat( psz_path, &st ) == 0 )
671 if( S_ISREG( st.st_mode ) )
673 char *psz_localname = ToLocale( psz_path );
675 ? gnutls_certificate_set_x509_key_file( cred,
676 psz_localname, psz_localname, GNUTLS_X509_FMT_PEM )
677 : gnutls_certificate_set_x509_trust_file( cred,
678 psz_localname, GNUTLS_X509_FMT_PEM );
679 LocaleFree( psz_localname );
683 msg_Warn( p_this, "cannot add x509 credentials (%s): %s",
684 psz_path, gnutls_strerror( i ) );
689 msg_Dbg( p_this, "added x509 credentials (%s)",
694 else if( S_ISDIR( st.st_mode ) )
697 "looking recursively for x509 credentials in %s",
699 return gnutls_Addx509Directory( p_this, cred, psz_path, b_priv);
703 msg_Warn( p_this, "cannot add x509 credentials (%s): %m", psz_path );
708 /** TLS client session data */
709 typedef struct tls_client_sys_t
711 struct tls_session_sys_t session;
712 gnutls_certificate_credentials x509_cred;
717 * Initializes a client-side TLS session.
719 static int OpenClient (vlc_object_t *obj)
721 tls_session_t *p_session = (tls_session_t *)obj;
724 if (gnutls_Init (obj))
727 tls_client_sys_t *p_sys = malloc (sizeof (*p_sys));
734 p_session->p_sys = &p_sys->session;
735 p_session->sock.p_sys = p_session;
736 p_session->sock.pf_send = gnutls_Send;
737 p_session->sock.pf_recv = gnutls_Recv;
738 p_session->pf_handshake = gnutls_BeginHandshake;
739 p_session->pf_close = NULL;
741 p_sys->session.b_handshaked = VLC_FALSE;
742 p_sys->session.psz_hostname = NULL;
744 const char *homedir = obj->p_libvlc->psz_datadir,
745 *datadir = config_GetDataDir ();
746 size_t l1 = strlen (homedir), l2 = strlen (datadir);
747 char path[((l1 > l2) ? l1 : l2) + sizeof ("/ssl/private")];
748 // > sizeof ("/ssl/certs")
749 // > sizeof ("/ca-certificates.crt")
751 i_val = gnutls_certificate_allocate_credentials (&p_sys->x509_cred);
754 msg_Err (obj, "cannot allocate X509 credentials: %s",
755 gnutls_strerror (i_val));
759 if (var_CreateGetBool (obj, "tls-check-cert"))
761 sprintf (path, "%s/ssl/certs", homedir);
762 gnutls_Addx509Directory (VLC_OBJECT (p_session),
763 p_sys->x509_cred, path, VLC_FALSE);
765 sprintf (path, "%s/ca-certificates.crt", datadir);
766 gnutls_Addx509File (VLC_OBJECT (p_session),
767 p_sys->x509_cred, path, VLC_FALSE);
768 p_session->pf_handshake2 = gnutls_HandshakeAndValidate;
771 p_session->pf_handshake2 = gnutls_ContinueHandshake;
773 sprintf (path, "%s/ssl/private", homedir);
774 gnutls_Addx509Directory (VLC_OBJECT (p_session), p_sys->x509_cred,
777 i_val = gnutls_init( &p_sys->session.session, GNUTLS_CLIENT );
780 msg_Err (obj, "cannot initialize TLS session: %s",
781 gnutls_strerror (i_val));
782 gnutls_certificate_free_credentials (p_sys->x509_cred);
786 if (gnutls_SessionPrioritize (VLC_OBJECT (p_session),
787 p_sys->session.session))
790 i_val = gnutls_credentials_set (p_sys->session.session,
791 GNUTLS_CRD_CERTIFICATE,
795 msg_Err (obj, "cannot set TLS session credentials: %s",
796 gnutls_strerror (i_val));
803 gnutls_deinit (p_sys->session.session);
804 gnutls_certificate_free_credentials (p_sys->x509_cred);
812 static void CloseClient (vlc_object_t *obj)
814 tls_session_t *client = (tls_session_t *)obj;
815 tls_client_sys_t *p_sys = (tls_client_sys_t *)(client->p_sys);
817 if (p_sys->session.b_handshaked == VLC_TRUE)
818 gnutls_bye (p_sys->session.session, GNUTLS_SHUT_WR);
819 gnutls_deinit (p_sys->session.session);
820 /* credentials must be free'd *after* gnutls_deinit() */
821 gnutls_certificate_free_credentials (p_sys->x509_cred);
824 free (p_sys->session.psz_hostname);
832 struct tls_server_sys_t
834 gnutls_certificate_credentials x509_cred;
835 gnutls_dh_params dh_params;
837 struct saved_session_t *p_cache;
838 struct saved_session_t *p_store;
840 vlc_mutex_t cache_lock;
842 int (*pf_handshake2)( tls_session_t * );
847 * TLS session resumption callbacks (server-side)
849 #define MAX_SESSION_ID 32
850 #define MAX_SESSION_DATA 1024
852 typedef struct saved_session_t
854 char id[MAX_SESSION_ID];
855 char data[MAX_SESSION_DATA];
862 static int cb_store( void *p_server, gnutls_datum key, gnutls_datum data )
864 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
866 if( ( p_sys->i_cache_size == 0 )
867 || ( key.size > MAX_SESSION_ID )
868 || ( data.size > MAX_SESSION_DATA ) )
871 vlc_mutex_lock( &p_sys->cache_lock );
873 memcpy( p_sys->p_store->id, key.data, key.size);
874 memcpy( p_sys->p_store->data, data.data, data.size );
875 p_sys->p_store->i_idlen = key.size;
876 p_sys->p_store->i_datalen = data.size;
879 if( ( p_sys->p_store - p_sys->p_cache ) == p_sys->i_cache_size )
880 p_sys->p_store = p_sys->p_cache;
882 vlc_mutex_unlock( &p_sys->cache_lock );
888 static gnutls_datum cb_fetch( void *p_server, gnutls_datum key )
890 static const gnutls_datum err_datum = { NULL, 0 };
891 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
892 saved_session_t *p_session, *p_end;
894 p_session = p_sys->p_cache;
895 p_end = p_session + p_sys->i_cache_size;
897 vlc_mutex_lock( &p_sys->cache_lock );
899 while( p_session < p_end )
901 if( ( p_session->i_idlen == key.size )
902 && !memcmp( p_session->id, key.data, key.size ) )
906 data.size = p_session->i_datalen;
908 data.data = gnutls_malloc( data.size );
909 if( data.data == NULL )
911 vlc_mutex_unlock( &p_sys->cache_lock );
915 memcpy( data.data, p_session->data, data.size );
916 vlc_mutex_unlock( &p_sys->cache_lock );
922 vlc_mutex_unlock( &p_sys->cache_lock );
928 static int cb_delete( void *p_server, gnutls_datum key )
930 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
931 saved_session_t *p_session, *p_end;
933 p_session = p_sys->p_cache;
934 p_end = p_session + p_sys->i_cache_size;
936 vlc_mutex_lock( &p_sys->cache_lock );
938 while( p_session < p_end )
940 if( ( p_session->i_idlen == key.size )
941 && !memcmp( p_session->id, key.data, key.size ) )
943 p_session->i_datalen = p_session->i_idlen = 0;
944 vlc_mutex_unlock( &p_sys->cache_lock );
950 vlc_mutex_unlock( &p_sys->cache_lock );
957 * Terminates TLS session and releases session data.
958 * You still have to close the socket yourself.
961 gnutls_SessionClose( tls_session_t *p_session )
963 tls_session_sys_t *p_sys = p_session->p_sys;
965 if( p_sys->b_handshaked == VLC_TRUE )
966 gnutls_bye( p_sys->session, GNUTLS_SHUT_WR );
967 gnutls_deinit( p_sys->session );
969 vlc_object_detach( p_session );
970 vlc_object_destroy( p_session );
977 * Initializes a server-side TLS session.
979 static tls_session_t *
980 gnutls_ServerSessionPrepare( tls_server_t *p_server )
982 tls_session_t *p_session;
983 tls_server_sys_t *p_server_sys;
984 gnutls_session session;
987 p_session = vlc_object_create( p_server, sizeof (struct tls_session_t) );
988 if( p_session == NULL )
991 p_session->p_sys = malloc( sizeof(struct tls_session_sys_t) );
992 if( p_session->p_sys == NULL )
994 vlc_object_destroy( p_session );
998 vlc_object_attach( p_session, p_server );
1000 p_server_sys = p_server->p_sys;
1001 p_session->sock.p_sys = p_session;
1002 p_session->sock.pf_send = gnutls_Send;
1003 p_session->sock.pf_recv = gnutls_Recv;
1004 p_session->pf_handshake = gnutls_BeginHandshake;
1005 p_session->pf_handshake2 = p_server_sys->pf_handshake2;
1006 p_session->pf_close = gnutls_SessionClose;
1008 p_session->p_sys->b_handshaked = VLC_FALSE;
1009 p_session->p_sys->psz_hostname = NULL;
1011 i_val = gnutls_init( &session, GNUTLS_SERVER );
1014 msg_Err( p_server, "cannot initialize TLS session: %s",
1015 gnutls_strerror( i_val ) );
1019 p_session->p_sys->session = session;
1021 if (gnutls_SessionPrioritize (VLC_OBJECT (p_session), session))
1023 gnutls_deinit( session );
1027 i_val = gnutls_credentials_set( session, GNUTLS_CRD_CERTIFICATE,
1028 p_server_sys->x509_cred );
1031 msg_Err( p_server, "cannot set TLS session credentials: %s",
1032 gnutls_strerror( i_val ) );
1033 gnutls_deinit( session );
1037 if( p_session->pf_handshake2 == gnutls_HandshakeAndValidate )
1038 gnutls_certificate_server_set_request( session, GNUTLS_CERT_REQUIRE );
1040 i_val = config_GetInt (p_server, "gnutls-dh-bits");
1041 gnutls_dh_set_prime_bits (session, i_val);
1043 /* Session resumption support */
1044 i_val = config_GetInt (p_server, "gnutls-cache-expiration");
1045 gnutls_db_set_cache_expiration (session, i_val);
1046 gnutls_db_set_retrieve_function( session, cb_fetch );
1047 gnutls_db_set_remove_function( session, cb_delete );
1048 gnutls_db_set_store_function( session, cb_store );
1049 gnutls_db_set_ptr( session, p_server );
1054 free( p_session->p_sys );
1055 vlc_object_detach( p_session );
1056 vlc_object_destroy( p_session );
1062 * Adds one or more certificate authorities.
1064 * @param psz_ca_path (Unicode) path to an x509 certificates list.
1066 * @return -1 on error, 0 on success.
1069 gnutls_ServerAddCA( tls_server_t *p_server, const char *psz_ca_path )
1071 tls_server_sys_t *p_sys;
1072 char *psz_local_path;
1075 p_sys = (tls_server_sys_t *)(p_server->p_sys);
1077 psz_local_path = ToLocale( psz_ca_path );
1078 val = gnutls_certificate_set_x509_trust_file( p_sys->x509_cred,
1080 GNUTLS_X509_FMT_PEM );
1081 LocaleFree( psz_local_path );
1084 msg_Err( p_server, "cannot add trusted CA (%s): %s", psz_ca_path,
1085 gnutls_strerror( val ) );
1086 return VLC_EGENERIC;
1088 msg_Dbg( p_server, " %d trusted CA added (%s)", val, psz_ca_path );
1090 /* enables peer's certificate verification */
1091 p_sys->pf_handshake2 = gnutls_HandshakeAndValidate;
1098 * Adds a certificates revocation list to be sent to TLS clients.
1100 * @param psz_crl_path (Unicode) path of the CRL file.
1102 * @return -1 on error, 0 on success.
1105 gnutls_ServerAddCRL( tls_server_t *p_server, const char *psz_crl_path )
1108 char *psz_local_path = ToLocale( psz_crl_path );
1110 val = gnutls_certificate_set_x509_crl_file( ((tls_server_sys_t *)
1111 (p_server->p_sys))->x509_cred,
1113 GNUTLS_X509_FMT_PEM );
1114 LocaleFree( psz_crl_path );
1117 msg_Err( p_server, "cannot add CRL (%s): %s", psz_crl_path,
1118 gnutls_strerror( val ) );
1119 return VLC_EGENERIC;
1121 msg_Dbg( p_server, "%d CRL added (%s)", val, psz_crl_path );
1127 * Allocates a whole server's TLS credentials.
1129 static int OpenServer (vlc_object_t *obj)
1131 tls_server_t *p_server = (tls_server_t *)obj;
1132 tls_server_sys_t *p_sys;
1135 if (gnutls_Init (obj))
1136 return VLC_EGENERIC;
1138 msg_Dbg (obj, "creating TLS server");
1140 p_sys = (tls_server_sys_t *)malloc( sizeof(struct tls_server_sys_t) );
1144 p_sys->i_cache_size = config_GetInt (obj, "gnutls-cache-size");
1145 p_sys->p_cache = calloc (p_sys->i_cache_size,
1146 sizeof (struct saved_session_t));
1147 if (p_sys->p_cache == NULL)
1153 p_sys->p_store = p_sys->p_cache;
1154 p_server->p_sys = p_sys;
1155 p_server->pf_add_CA = gnutls_ServerAddCA;
1156 p_server->pf_add_CRL = gnutls_ServerAddCRL;
1157 p_server->pf_session_prepare = gnutls_ServerSessionPrepare;
1159 /* No certificate validation by default */
1160 p_sys->pf_handshake2 = gnutls_ContinueHandshake;
1162 vlc_mutex_init( p_server, &p_sys->cache_lock );
1164 /* Sets server's credentials */
1165 val = gnutls_certificate_allocate_credentials( &p_sys->x509_cred );
1168 msg_Err( p_server, "cannot allocate X509 credentials: %s",
1169 gnutls_strerror( val ) );
1173 char *psz_cert_path = var_GetNonEmptyString (obj, "tls-x509-cert");
1174 char *psz_key_path = var_GetNonEmptyString (obj, "tls-x509-key");
1175 const char *psz_local_cert = ToLocale (psz_cert_path);
1176 const char *psz_local_key = ToLocale (psz_key_path);
1177 val = gnutls_certificate_set_x509_key_file (p_sys->x509_cred,
1178 psz_local_cert, psz_local_key,
1179 GNUTLS_X509_FMT_PEM );
1180 LocaleFree (psz_key_path);
1181 free (psz_key_path);
1182 LocaleFree (psz_cert_path);
1183 free (psz_cert_path);
1187 msg_Err( p_server, "cannot set certificate chain or private key: %s",
1188 gnutls_strerror( val ) );
1189 gnutls_certificate_free_credentials( p_sys->x509_cred );
1194 * - regenerate these regularly
1195 * - support other ciper suites
1197 val = gnutls_dh_params_init( &p_sys->dh_params );
1200 msg_Dbg( p_server, "computing Diffie Hellman ciphers parameters" );
1201 val = gnutls_dh_params_generate2 (p_sys->dh_params,
1202 config_GetInt (obj, "gnutls-dh-bits"));
1206 msg_Err( p_server, "cannot initialize DH cipher suites: %s",
1207 gnutls_strerror( val ) );
1208 gnutls_certificate_free_credentials( p_sys->x509_cred );
1211 msg_Dbg( p_server, "ciphers parameters computed" );
1213 gnutls_certificate_set_dh_params( p_sys->x509_cred, p_sys->dh_params);
1218 vlc_mutex_destroy (&p_sys->cache_lock);
1219 free (p_sys->p_cache);
1221 return VLC_EGENERIC;
1225 * Destroys a TLS server object.
1227 static void CloseServer (vlc_object_t *p_server)
1229 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
1231 vlc_mutex_destroy (&p_sys->cache_lock);
1232 free (p_sys->p_cache);
1234 /* all sessions depending on the server are now deinitialized */
1235 gnutls_certificate_free_credentials (p_sys->x509_cred);
1236 gnutls_dh_params_deinit (p_sys->dh_params);
1239 gnutls_Deinit (p_server);