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 *****************************************************************************/
33 #include <sys/types.h>
38 #ifdef HAVE_SYS_STAT_H
39 # include <sys/stat.h>
47 #include <vlc_charset.h>
50 #include <gnutls/gnutls.h>
51 #include <gnutls/x509.h>
54 #define CACHE_EXPIRATION 3600
57 /*****************************************************************************
59 *****************************************************************************/
60 static int Open ( vlc_object_t * );
61 static void Close( vlc_object_t * );
63 #define DH_BITS_TEXT N_("Diffie-Hellman prime bits")
64 #define DH_BITS_LONGTEXT N_( \
65 "This allows you to modify the Diffie-Hellman prime's number of bits, " \
66 "used for TLS or SSL-based server-side encryption. This is generally " \
69 #define CACHE_EXPIRATION_TEXT N_("Expiration time for resumed TLS sessions")
70 #define CACHE_EXPIRATION_LONGTEXT N_( \
71 "It is possible to cache the resumed TLS sessions. This is the expiration "\
72 "time of the sessions stored in this cache, in seconds." )
74 #define CACHE_SIZE_TEXT N_("Number of resumed TLS sessions")
75 #define CACHE_SIZE_LONGTEXT N_( \
76 "This is the maximum number of resumed TLS sessions that " \
77 "the cache will hold." )
79 #define CHECK_CERT_TEXT N_("Check TLS/SSL server certificate validity")
80 #define CHECK_CERT_LONGTEXT N_( \
81 "This ensures that the server certificate is valid " \
82 "(i.e. signed by an approved Certification Authority)." )
84 #define CHECK_HOSTNAME_TEXT N_("Check TLS/SSL server hostname in certificate")
85 #define CHECK_HOSTNAME_LONGTEXT N_( \
86 "This ensures that the server hostname in certificate matches the " \
87 "requested host name." )
90 set_shortname( "GnuTLS" );
91 set_description( _("GnuTLS TLS encryption layer") );
92 set_capability( "tls", 1 );
93 set_callbacks( Open, Close );
94 set_category( CAT_ADVANCED );
95 set_subcategory( SUBCAT_ADVANCED_MISC );
97 add_bool( "tls-check-cert", VLC_TRUE, NULL, CHECK_CERT_TEXT,
98 CHECK_CERT_LONGTEXT, VLC_FALSE );
99 add_bool( "tls-check-hostname", VLC_TRUE, NULL, CHECK_HOSTNAME_TEXT,
100 CHECK_HOSTNAME_LONGTEXT, VLC_FALSE );
102 add_integer( "gnutls-dh-bits", DH_BITS, NULL, DH_BITS_TEXT,
103 DH_BITS_LONGTEXT, VLC_TRUE );
104 add_integer( "gnutls-cache-expiration", CACHE_EXPIRATION, NULL,
105 CACHE_EXPIRATION_TEXT, CACHE_EXPIRATION_LONGTEXT, VLC_TRUE );
106 add_integer( "gnutls-cache-size", CACHE_SIZE, NULL, CACHE_SIZE_TEXT,
107 CACHE_SIZE_LONGTEXT, VLC_TRUE );
111 #define MAX_SESSION_ID 32
112 #define MAX_SESSION_DATA 1024
114 typedef struct saved_session_t
116 char id[MAX_SESSION_ID];
117 char data[MAX_SESSION_DATA];
124 typedef struct tls_server_sys_t
126 gnutls_certificate_credentials x509_cred;
127 gnutls_dh_params dh_params;
129 struct saved_session_t *p_cache;
130 struct saved_session_t *p_store;
132 vlc_mutex_t cache_lock;
134 int (*pf_handshake2)( tls_session_t * );
138 typedef struct tls_session_sys_t
140 gnutls_session session;
142 vlc_bool_t b_handshaked;
146 typedef struct tls_client_sys_t
148 struct tls_session_sys_t session;
149 gnutls_certificate_credentials x509_cred;
153 static int gnutls_Error (vlc_object_t *obj, int val)
161 case GNUTLS_E_INTERRUPTED:
166 msg_Err (obj, "%s", gnutls_strerror (val));
168 if (!gnutls_error_is_fatal (val))
169 msg_Err (obj, "Error above should be handled");
178 * Sends data through a TLS session.
181 gnutls_Send( void *p_session, const void *buf, int i_length )
184 tls_session_sys_t *p_sys;
186 p_sys = (tls_session_sys_t *)(((tls_session_t *)p_session)->p_sys);
188 val = gnutls_record_send( p_sys->session, buf, i_length );
189 return (val < 0) ? gnutls_Error ((vlc_object_t *)p_session, val) : val;
194 * Receives data through a TLS session.
197 gnutls_Recv( void *p_session, void *buf, int i_length )
200 tls_session_sys_t *p_sys;
202 p_sys = (tls_session_sys_t *)(((tls_session_t *)p_session)->p_sys);
204 val = gnutls_record_recv( p_sys->session, buf, i_length );
205 return (val < 0) ? gnutls_Error ((vlc_object_t *)p_session, val) : val;
209 /*****************************************************************************
210 * tls_Session(Continue)?Handshake:
211 *****************************************************************************
212 * Establishes TLS session with a peer through socket <fd>.
213 * Returns -1 on error (you need not and must not call tls_SessionClose)
214 * 0 on succesful handshake completion, 1 if more would-be blocking recv is
215 * needed, 2 if more would-be blocking send is required.
216 *****************************************************************************/
218 gnutls_ContinueHandshake( tls_session_t *p_session)
220 tls_session_sys_t *p_sys;
223 p_sys = (tls_session_sys_t *)(p_session->p_sys);
225 /* TODO: handle fatal error */
227 WSASetLastError( 0 );
229 val = gnutls_handshake( p_sys->session );
230 if( ( val == GNUTLS_E_AGAIN ) || ( val == GNUTLS_E_INTERRUPTED ) )
231 return 1 + gnutls_record_get_direction( p_sys->session );
236 msg_Dbg( p_session, "Winsock error %d", WSAGetLastError( ) );
238 msg_Err( p_session, "TLS handshake error: %s",
239 gnutls_strerror( val ) );
240 p_session->pf_close( p_session );
244 p_sys->b_handshaked = VLC_TRUE;
255 static const error_msg_t cert_errors[] =
257 { GNUTLS_CERT_INVALID,
258 "Certificate could not be verified" },
259 { GNUTLS_CERT_REVOKED,
260 "Certificate was revoked" },
261 { GNUTLS_CERT_SIGNER_NOT_FOUND,
262 "Certificate's signer was not found" },
263 { GNUTLS_CERT_SIGNER_NOT_CA,
264 "Certificate's signer is not a CA" },
265 { GNUTLS_CERT_INSECURE_ALGORITHM,
266 "Insecure certificate signature algorithm" },
272 gnutls_HandshakeAndValidate( tls_session_t *session )
274 int val = gnutls_ContinueHandshake( session );
278 tls_session_sys_t *p_sys = (tls_session_sys_t *)(session->p_sys);
280 /* certificates chain verification */
282 val = gnutls_certificate_verify_peers2( p_sys->session, &status );
286 msg_Err( session, "Certificate verification failed: %s",
287 gnutls_strerror( val ) );
293 msg_Err( session, "TLS session: access denied" );
294 for( const error_msg_t *e = cert_errors; e->flag; e++ )
296 if( status & e->flag )
298 msg_Err( session, e->msg );
305 "unknown certificate error (you found a bug in VLC)" );
310 /* certificate (host)name verification */
311 const gnutls_datum *data = gnutls_certificate_get_peers( p_sys->session,
315 msg_Err( session, "Peer certificate not available" );
319 gnutls_x509_crt cert;
320 val = gnutls_x509_crt_init( &cert );
323 msg_Err( session, "x509 fatal error: %s", gnutls_strerror( val ) );
327 val = gnutls_x509_crt_import( cert, data, GNUTLS_X509_FMT_DER );
330 msg_Err( session, "Certificate import error: %s",
331 gnutls_strerror( val ) );
332 gnutls_x509_crt_deinit( cert );
336 if( p_sys->psz_hostname != NULL )
338 if ( !gnutls_x509_crt_check_hostname( cert, p_sys->psz_hostname ) )
340 msg_Err( session, "Certificate does not match \"%s\"",
341 p_sys->psz_hostname );
346 msg_Warn( session, "Certificate and hostname were not verified" );
348 if( gnutls_x509_crt_get_expiration_time( cert ) < time( NULL ) )
350 msg_Err( session, "Certificate expired" );
354 if( gnutls_x509_crt_get_activation_time( cert ) > time ( NULL ) )
356 msg_Err( session, "Certificate not yet valid" );
360 gnutls_x509_crt_deinit( cert );
361 msg_Dbg( session, "TLS/x509 certificate verified" );
365 gnutls_x509_crt_deinit( cert );
367 session->pf_close( session );
372 * Starts negociation of a TLS session.
374 * @param fd stream socket already connected with the peer.
375 * @param psz_hostname if not NULL, hostname to mention as a Server Name.
377 * @return -1 on error (you need not and must not call tls_SessionClose),
378 * 0 on succesful handshake completion, 1 if more would-be blocking recv is
379 * needed, 2 if more would-be blocking send is required.
382 gnutls_BeginHandshake( tls_session_t *p_session, int fd,
383 const char *psz_hostname )
385 tls_session_sys_t *p_sys;
387 p_sys = (tls_session_sys_t *)(p_session->p_sys);
389 gnutls_transport_set_ptr (p_sys->session, (gnutls_transport_ptr)(intptr_t)fd);
391 if( psz_hostname != NULL )
393 gnutls_server_name_set( p_sys->session, GNUTLS_NAME_DNS, psz_hostname,
394 strlen( psz_hostname ) );
395 if (var_CreateGetBool (p_session, "tls-check-hostname"))
397 p_sys->psz_hostname = strdup( psz_hostname );
398 if( p_sys->psz_hostname == NULL )
400 p_session->pf_close( p_session );
406 return p_session->pf_handshake2( p_session );
410 * Terminates TLS session and releases session data.
411 * You still have to close the socket yourself.
414 gnutls_SessionClose( tls_session_t *p_session )
416 tls_session_sys_t *p_sys;
418 p_sys = (tls_session_sys_t *)(p_session->p_sys);
420 if( p_sys->b_handshaked == VLC_TRUE )
421 gnutls_bye( p_sys->session, GNUTLS_SHUT_WR );
422 gnutls_deinit( p_sys->session );
424 if( p_sys->psz_hostname != NULL )
425 free( p_sys->psz_hostname );
427 vlc_object_detach( p_session );
428 vlc_object_destroy( p_session );
434 typedef int (*tls_prio_func) (gnutls_session_t, const int *);
437 gnutls_SetPriority (vlc_object_t *restrict obj, const char *restrict name,
438 tls_prio_func func, gnutls_session_t session,
439 const int *restrict values)
441 int val = func (session, values);
444 msg_Err (obj, "cannot set %s priorities: %s", name,
445 gnutls_strerror (val));
453 gnutls_SessionPrioritize (vlc_object_t *obj, gnutls_session_t session)
455 /* Note that ordering matters (on the client side) */
456 static const int protos[] =
463 static const int comps[] =
469 static const int macs[] =
472 GNUTLS_MAC_RMD160, // RIPEMD
478 static const int ciphers[] =
480 GNUTLS_CIPHER_AES_256_CBC,
481 GNUTLS_CIPHER_AES_128_CBC,
482 GNUTLS_CIPHER_3DES_CBC,
483 GNUTLS_CIPHER_ARCFOUR_128,
484 //GNUTLS_CIPHER_DES_CBC,
485 //GNUTLS_CIPHER_ARCFOUR_40,
486 //GNUTLS_CIPHER_RC2_40_CBC,
487 //GNUTLS_CIPHER_NULL,
490 static const int cert_types[] =
493 //GNUTLS_CRT_OPENPGP, TODO
497 int val = gnutls_set_default_priority (session);
500 msg_Err (obj, "cannot set default TLS priorities: %s",
501 gnutls_strerror (val));
505 if (gnutls_SetPriority (obj, "protocols",
506 gnutls_protocol_set_priority, session, protos)
507 || gnutls_SetPriority (obj, "compressions",
508 gnutls_compression_set_priority, session, comps)
509 || gnutls_SetPriority (obj, "MAC",
510 gnutls_mac_set_priority, session, macs)
511 || gnutls_SetPriority (obj, "ciphers",
512 gnutls_cipher_set_priority, session, ciphers)
513 || gnutls_SetPriority (obj, "certificate types",
514 gnutls_certificate_type_set_priority, session,
523 gnutls_ClientDelete( tls_session_t *p_session )
525 /* On the client-side, credentials are re-allocated per session */
526 gnutls_certificate_credentials x509_cred =
527 ((tls_client_sys_t *)(p_session->p_sys))->x509_cred;
529 gnutls_SessionClose( p_session );
531 /* credentials must be free'd *after* gnutls_deinit() */
532 gnutls_certificate_free_credentials( x509_cred );
537 gnutls_Addx509File( vlc_object_t *p_this,
538 gnutls_certificate_credentials cred,
539 const char *psz_path, vlc_bool_t b_priv );
542 gnutls_Addx509Directory( vlc_object_t *p_this,
543 gnutls_certificate_credentials cred,
544 const char *psz_dirname,
549 if( *psz_dirname == '\0' )
552 dir = utf8_opendir( psz_dirname );
555 msg_Warn( p_this, "cannot open directory (%s): %s", psz_dirname,
562 struct stat st1, st2;
563 int fd = dirfd( dir );
566 * Gets stats for the directory path, checks that it is not a
567 * symbolic link (to avoid possibly infinite recursion), and verifies
568 * that the inode is still the same, to avoid TOCTOU race condition.
571 || fstat( fd, &st1 ) || utf8_lstat( psz_dirname, &st2 )
572 || S_ISLNK( st2.st_mode ) || ( st1.st_ino != st2.st_ino ) )
582 char *ent = utf8_readdir (dir);
586 if ((strcmp (ent, ".") == 0) || (strcmp (ent, "..") == 0))
589 char path[strlen (psz_dirname) + strlen (ent) + 2];
590 sprintf (path, "%s"DIR_SEP"%s", psz_dirname, ent);
593 gnutls_Addx509File( p_this, cred, path, b_priv );
602 gnutls_Addx509File( vlc_object_t *p_this,
603 gnutls_certificate_credentials cred,
604 const char *psz_path, vlc_bool_t b_priv )
608 if( utf8_stat( psz_path, &st ) == 0 )
610 if( S_ISREG( st.st_mode ) )
612 char *psz_localname = ToLocale( psz_path );
614 ? gnutls_certificate_set_x509_key_file( cred,
615 psz_localname, psz_localname, GNUTLS_X509_FMT_PEM )
616 : gnutls_certificate_set_x509_trust_file( cred,
617 psz_localname, GNUTLS_X509_FMT_PEM );
618 LocaleFree( psz_localname );
622 msg_Warn( p_this, "cannot add x509 credentials (%s): %s",
623 psz_path, gnutls_strerror( i ) );
628 msg_Dbg( p_this, "added x509 credentials (%s)",
633 else if( S_ISDIR( st.st_mode ) )
636 "looking recursively for x509 credentials in %s",
638 return gnutls_Addx509Directory( p_this, cred, psz_path, b_priv);
642 msg_Warn( p_this, "cannot add x509 credentials (%s): %s",
643 psz_path, strerror( errno ) );
649 * Initializes a client-side TLS session.
651 static tls_session_t *
652 gnutls_ClientCreate( tls_t *p_tls )
654 tls_session_t *p_session = NULL;
655 tls_client_sys_t *p_sys = NULL;
658 p_sys = (tls_client_sys_t *)malloc( sizeof(struct tls_client_sys_t) );
662 p_session = (struct tls_session_t *)vlc_object_create ( p_tls, sizeof(struct tls_session_t) );
663 if( p_session == NULL )
669 p_session->p_sys = p_sys;
670 p_session->sock.p_sys = p_session;
671 p_session->sock.pf_send = gnutls_Send;
672 p_session->sock.pf_recv = gnutls_Recv;
673 p_session->pf_handshake = gnutls_BeginHandshake;
674 p_session->pf_close = gnutls_ClientDelete;
676 p_sys->session.b_handshaked = VLC_FALSE;
677 p_sys->session.psz_hostname = NULL;
679 vlc_object_attach( p_session, p_tls );
681 const char *homedir = p_tls->p_libvlc->psz_homedir,
682 *datadir = config_GetDataDir ((vlc_object_t *)p_session);
683 size_t l1 = strlen (homedir), l2 = strlen (datadir);
684 char path[((l1 > l2) ? l1 : l2) + sizeof ("/"CONFIG_DIR"/ssl/private")];
685 // > sizeof ("/"CONFIG_DIR"/ssl/certs")
686 // > sizeof ("/ca-certificates.crt")
688 i_val = gnutls_certificate_allocate_credentials( &p_sys->x509_cred );
691 msg_Err( p_tls, "cannot allocate X509 credentials: %s",
692 gnutls_strerror( i_val ) );
696 if (var_CreateGetBool (p_tls, "tls-check-cert"))
698 sprintf (path, "%s/"CONFIG_DIR"/ssl/certs", homedir);
699 gnutls_Addx509Directory ((vlc_object_t *)p_session,
700 p_sys->x509_cred, path, VLC_FALSE);
702 sprintf (path, "%s/ca-certificates.crt", datadir);
703 gnutls_Addx509File ((vlc_object_t *)p_session,
704 p_sys->x509_cred, path, VLC_FALSE);
705 p_session->pf_handshake2 = gnutls_HandshakeAndValidate;
708 p_session->pf_handshake2 = gnutls_ContinueHandshake;
710 sprintf (path, "%s/"CONFIG_DIR"/ssl/private", homedir);
711 gnutls_Addx509Directory ((vlc_object_t *)p_session, p_sys->x509_cred,
714 i_val = gnutls_init( &p_sys->session.session, GNUTLS_CLIENT );
717 msg_Err( p_tls, "cannot initialize TLS session: %s",
718 gnutls_strerror( i_val ) );
719 gnutls_certificate_free_credentials( p_sys->x509_cred );
723 if (gnutls_SessionPrioritize (VLC_OBJECT (p_session),
724 p_sys->session.session))
727 i_val = gnutls_credentials_set( p_sys->session.session,
728 GNUTLS_CRD_CERTIFICATE,
732 msg_Err( p_tls, "cannot set TLS session credentials: %s",
733 gnutls_strerror( i_val ) );
740 gnutls_deinit( p_sys->session.session );
741 gnutls_certificate_free_credentials( p_sys->x509_cred );
744 vlc_object_detach( p_session );
745 vlc_object_destroy( p_session );
753 * TLS session resumption callbacks (server-side)
755 static int cb_store( void *p_server, gnutls_datum key, gnutls_datum data )
757 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
759 if( ( p_sys->i_cache_size == 0 )
760 || ( key.size > MAX_SESSION_ID )
761 || ( data.size > MAX_SESSION_DATA ) )
764 vlc_mutex_lock( &p_sys->cache_lock );
766 memcpy( p_sys->p_store->id, key.data, key.size);
767 memcpy( p_sys->p_store->data, data.data, data.size );
768 p_sys->p_store->i_idlen = key.size;
769 p_sys->p_store->i_datalen = data.size;
772 if( ( p_sys->p_store - p_sys->p_cache ) == p_sys->i_cache_size )
773 p_sys->p_store = p_sys->p_cache;
775 vlc_mutex_unlock( &p_sys->cache_lock );
781 static const gnutls_datum err_datum = { NULL, 0 };
783 static gnutls_datum cb_fetch( void *p_server, gnutls_datum key )
785 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
786 saved_session_t *p_session, *p_end;
788 p_session = p_sys->p_cache;
789 p_end = p_session + p_sys->i_cache_size;
791 vlc_mutex_lock( &p_sys->cache_lock );
793 while( p_session < p_end )
795 if( ( p_session->i_idlen == key.size )
796 && !memcmp( p_session->id, key.data, key.size ) )
800 data.size = p_session->i_datalen;
802 data.data = gnutls_malloc( data.size );
803 if( data.data == NULL )
805 vlc_mutex_unlock( &p_sys->cache_lock );
809 memcpy( data.data, p_session->data, data.size );
810 vlc_mutex_unlock( &p_sys->cache_lock );
816 vlc_mutex_unlock( &p_sys->cache_lock );
822 static int cb_delete( void *p_server, gnutls_datum key )
824 tls_server_sys_t *p_sys = ((tls_server_t *)p_server)->p_sys;
825 saved_session_t *p_session, *p_end;
827 p_session = p_sys->p_cache;
828 p_end = p_session + p_sys->i_cache_size;
830 vlc_mutex_lock( &p_sys->cache_lock );
832 while( p_session < p_end )
834 if( ( p_session->i_idlen == key.size )
835 && !memcmp( p_session->id, key.data, key.size ) )
837 p_session->i_datalen = p_session->i_idlen = 0;
838 vlc_mutex_unlock( &p_sys->cache_lock );
844 vlc_mutex_unlock( &p_sys->cache_lock );
851 * Initializes a server-side TLS session.
853 static tls_session_t *
854 gnutls_ServerSessionPrepare( tls_server_t *p_server )
856 tls_session_t *p_session;
857 tls_server_sys_t *p_server_sys;
858 gnutls_session session;
861 p_session = vlc_object_create( p_server, sizeof (struct tls_session_t) );
862 if( p_session == NULL )
865 p_session->p_sys = malloc( sizeof(struct tls_session_sys_t) );
866 if( p_session->p_sys == NULL )
868 vlc_object_destroy( p_session );
872 vlc_object_attach( p_session, p_server );
874 p_server_sys = (tls_server_sys_t *)p_server->p_sys;
875 p_session->sock.p_sys = p_session;
876 p_session->sock.pf_send = gnutls_Send;
877 p_session->sock.pf_recv = gnutls_Recv;
878 p_session->pf_handshake = gnutls_BeginHandshake;
879 p_session->pf_handshake2 = p_server_sys->pf_handshake2;
880 p_session->pf_close = gnutls_SessionClose;
882 ((tls_session_sys_t *)p_session->p_sys)->b_handshaked = VLC_FALSE;
883 ((tls_session_sys_t *)p_session->p_sys)->psz_hostname = NULL;
885 i_val = gnutls_init( &session, GNUTLS_SERVER );
888 msg_Err( p_server, "cannot initialize TLS session: %s",
889 gnutls_strerror( i_val ) );
893 ((tls_session_sys_t *)p_session->p_sys)->session = session;
895 i_val = gnutls_set_default_priority( session );
896 if (gnutls_SessionPrioritize (VLC_OBJECT (p_session), session))
898 gnutls_deinit( session );
902 i_val = gnutls_credentials_set( session, GNUTLS_CRD_CERTIFICATE,
903 p_server_sys->x509_cred );
906 msg_Err( p_server, "cannot set TLS session credentials: %s",
907 gnutls_strerror( i_val ) );
908 gnutls_deinit( session );
912 if( p_session->pf_handshake2 == gnutls_HandshakeAndValidate )
913 gnutls_certificate_server_set_request( session, GNUTLS_CERT_REQUIRE );
915 i_val = config_GetInt (p_server, "gnutls-dh-bits");
916 gnutls_dh_set_prime_bits (session, i_val);
918 /* Session resumption support */
919 i_val = config_GetInt (p_server, "gnutls-cache-expiration");
920 gnutls_db_set_cache_expiration (session, i_val);
921 gnutls_db_set_retrieve_function( session, cb_fetch );
922 gnutls_db_set_remove_function( session, cb_delete );
923 gnutls_db_set_store_function( session, cb_store );
924 gnutls_db_set_ptr( session, p_server );
929 free( p_session->p_sys );
930 vlc_object_detach( p_session );
931 vlc_object_destroy( p_session );
937 * Releases data allocated with tls_ServerCreate().
940 gnutls_ServerDelete( tls_server_t *p_server )
942 tls_server_sys_t *p_sys;
943 p_sys = (tls_server_sys_t *)p_server->p_sys;
945 vlc_mutex_destroy( &p_sys->cache_lock );
946 free( p_sys->p_cache );
948 vlc_object_detach( p_server );
949 vlc_object_destroy( p_server );
951 /* all sessions depending on the server are now deinitialized */
952 gnutls_certificate_free_credentials( p_sys->x509_cred );
953 gnutls_dh_params_deinit( p_sys->dh_params );
959 * Adds one or more certificate authorities.
961 * @param psz_ca_path (Unicode) path to an x509 certificates list.
963 * @return -1 on error, 0 on success.
964 *****************************************************************************/
966 gnutls_ServerAddCA( tls_server_t *p_server, const char *psz_ca_path )
968 tls_server_sys_t *p_sys;
969 char *psz_local_path;
972 p_sys = (tls_server_sys_t *)(p_server->p_sys);
974 psz_local_path = ToLocale( psz_ca_path );
975 val = gnutls_certificate_set_x509_trust_file( p_sys->x509_cred,
977 GNUTLS_X509_FMT_PEM );
978 LocaleFree( psz_local_path );
981 msg_Err( p_server, "cannot add trusted CA (%s): %s", psz_ca_path,
982 gnutls_strerror( val ) );
985 msg_Dbg( p_server, " %d trusted CA added (%s)", val, psz_ca_path );
987 /* enables peer's certificate verification */
988 p_sys->pf_handshake2 = gnutls_HandshakeAndValidate;
995 * Adds a certificates revocation list to be sent to TLS clients.
997 * @param psz_crl_path (Unicode) path of the CRL file.
999 * @return -1 on error, 0 on success.
1002 gnutls_ServerAddCRL( tls_server_t *p_server, const char *psz_crl_path )
1005 char *psz_local_path = ToLocale( psz_crl_path );
1007 val = gnutls_certificate_set_x509_crl_file( ((tls_server_sys_t *)
1008 (p_server->p_sys))->x509_cred,
1010 GNUTLS_X509_FMT_PEM );
1011 LocaleFree( psz_crl_path );
1014 msg_Err( p_server, "cannot add CRL (%s): %s", psz_crl_path,
1015 gnutls_strerror( val ) );
1016 return VLC_EGENERIC;
1018 msg_Dbg( p_server, "%d CRL added (%s)", val, psz_crl_path );
1024 * Allocates a whole server's TLS credentials.
1026 * @return NULL on error.
1028 static tls_server_t *
1029 gnutls_ServerCreate( tls_t *p_tls, const char *psz_cert_path,
1030 const char *psz_key_path )
1032 tls_server_t *p_server;
1033 tls_server_sys_t *p_sys;
1034 char *psz_local_key, *psz_local_cert;
1037 msg_Dbg( p_tls, "creating TLS server" );
1039 p_sys = (tls_server_sys_t *)malloc( sizeof(struct tls_server_sys_t) );
1043 p_sys->i_cache_size = config_GetInt (p_tls, "gnutls-cache-size");
1044 p_sys->p_cache = (struct saved_session_t *)calloc( p_sys->i_cache_size,
1045 sizeof( struct saved_session_t ) );
1046 if( p_sys->p_cache == NULL )
1051 p_sys->p_store = p_sys->p_cache;
1053 p_server = vlc_object_create( p_tls, sizeof(struct tls_server_t) );
1054 if( p_server == NULL )
1056 free( p_sys->p_cache );
1061 vlc_object_attach( p_server, p_tls );
1063 p_server->p_sys = p_sys;
1064 p_server->pf_delete = gnutls_ServerDelete;
1065 p_server->pf_add_CA = gnutls_ServerAddCA;
1066 p_server->pf_add_CRL = gnutls_ServerAddCRL;
1067 p_server->pf_session_prepare = gnutls_ServerSessionPrepare;
1069 /* No certificate validation by default */
1070 p_sys->pf_handshake2 = gnutls_ContinueHandshake;
1072 vlc_mutex_init( p_server, &p_sys->cache_lock );
1074 /* Sets server's credentials */
1075 val = gnutls_certificate_allocate_credentials( &p_sys->x509_cred );
1078 msg_Err( p_server, "cannot allocate X509 credentials: %s",
1079 gnutls_strerror( val ) );
1083 psz_local_cert = ToLocale( psz_cert_path );
1084 psz_local_key = ToLocale( psz_key_path );
1085 val = gnutls_certificate_set_x509_key_file( p_sys->x509_cred,
1086 psz_local_cert, psz_local_key,
1087 GNUTLS_X509_FMT_PEM );
1088 LocaleFree( psz_cert_path );
1089 LocaleFree( psz_key_path );
1092 msg_Err( p_server, "cannot set certificate chain or private key: %s",
1093 gnutls_strerror( val ) );
1094 gnutls_certificate_free_credentials( p_sys->x509_cred );
1099 * - regenerate these regularly
1100 * - support other ciper suites
1102 val = gnutls_dh_params_init( &p_sys->dh_params );
1105 msg_Dbg( p_server, "computing Diffie Hellman ciphers parameters" );
1106 val = gnutls_dh_params_generate2( p_sys->dh_params,
1107 config_GetInt( p_tls, "gnutls-dh-bits" ) );
1111 msg_Err( p_server, "cannot initialize DH cipher suites: %s",
1112 gnutls_strerror( val ) );
1113 gnutls_certificate_free_credentials( p_sys->x509_cred );
1116 msg_Dbg( p_server, "ciphers parameters computed" );
1118 gnutls_certificate_set_dh_params( p_sys->x509_cred, p_sys->dh_params);
1123 vlc_mutex_destroy( &p_sys->cache_lock );
1124 vlc_object_detach( p_server );
1125 vlc_object_destroy( p_server );
1131 #ifdef LIBVLC_USE_PTHREAD
1132 GCRY_THREAD_OPTION_PTHREAD_IMPL;
1133 # define gcry_threads_vlc gcry_threads_pthread
1136 * gcrypt thread option VLC implementation
1139 # define NEED_THREAD_CONTEXT 1
1140 static vlc_object_t *__p_gcry_data;
1142 static int gcry_vlc_mutex_init( void **p_sys )
1145 vlc_mutex_t *p_lock = (vlc_mutex_t *)malloc( sizeof( vlc_mutex_t ) );
1150 i_val = vlc_mutex_init( __p_gcry_data, p_lock );
1158 static int gcry_vlc_mutex_destroy( void **p_sys )
1161 vlc_mutex_t *p_lock = (vlc_mutex_t *)*p_sys;
1163 i_val = vlc_mutex_destroy( p_lock );
1168 static int gcry_vlc_mutex_lock( void **p_sys )
1170 return vlc_mutex_lock( (vlc_mutex_t *)*p_sys );
1173 static int gcry_vlc_mutex_unlock( void **lock )
1175 return vlc_mutex_unlock( (vlc_mutex_t *)*lock );
1178 static struct gcry_thread_cbs gcry_threads_vlc =
1180 GCRY_THREAD_OPTION_USER,
1182 gcry_vlc_mutex_init,
1183 gcry_vlc_mutex_destroy,
1184 gcry_vlc_mutex_lock,
1185 gcry_vlc_mutex_unlock
1190 /*****************************************************************************
1191 * Module initialization
1192 *****************************************************************************/
1194 Open( vlc_object_t *p_this )
1196 tls_t *p_tls = (tls_t *)p_this;
1198 vlc_value_t lock, count;
1200 var_Create( p_this->p_libvlc_global, "gnutls_mutex", VLC_VAR_MUTEX );
1201 var_Get( p_this->p_libvlc_global, "gnutls_mutex", &lock );
1202 vlc_mutex_lock( lock.p_address );
1204 /* Initialize GnuTLS only once */
1205 var_Create( p_this->p_libvlc_global, "gnutls_count", VLC_VAR_INTEGER );
1206 var_Get( p_this->p_libvlc_global, "gnutls_count", &count);
1208 if( count.i_int == 0)
1210 #ifdef NEED_THREAD_CONTEXT
1211 __p_gcry_data = VLC_OBJECT( p_this->p_libvlc );
1214 gcry_control (GCRYCTL_SET_THREAD_CBS, &gcry_threads_vlc);
1215 if( gnutls_global_init( ) )
1217 msg_Warn( p_this, "cannot initialize GnuTLS" );
1218 vlc_mutex_unlock( lock.p_address );
1219 return VLC_EGENERIC;
1222 const char *psz_version = gnutls_check_version( "1.2.9" );
1223 if( psz_version == NULL )
1225 gnutls_global_deinit( );
1226 vlc_mutex_unlock( lock.p_address );
1227 msg_Err( p_this, "unsupported GnuTLS version" );
1228 return VLC_EGENERIC;
1230 msg_Dbg( p_this, "GnuTLS v%s initialized", psz_version );
1234 var_Set( p_this->p_libvlc_global, "gnutls_count", count);
1235 vlc_mutex_unlock( lock.p_address );
1237 p_tls->pf_server_create = gnutls_ServerCreate;
1238 p_tls->pf_client_create = gnutls_ClientCreate;
1243 /*****************************************************************************
1244 * Module deinitialization
1245 *****************************************************************************/
1247 Close( vlc_object_t *p_this )
1249 /*tls_t *p_tls = (tls_t *)p_this;
1250 tls_sys_t *p_sys = (tls_sys_t *)(p_this->p_sys);*/
1252 vlc_value_t lock, count;
1254 var_Create( p_this->p_libvlc_global, "gnutls_mutex", VLC_VAR_MUTEX );
1255 var_Get( p_this->p_libvlc_global, "gnutls_mutex", &lock );
1256 vlc_mutex_lock( lock.p_address );
1258 var_Create( p_this->p_libvlc_global, "gnutls_count", VLC_VAR_INTEGER );
1259 var_Get( p_this->p_libvlc_global, "gnutls_count", &count);
1261 var_Set( p_this->p_libvlc_global, "gnutls_count", count);
1263 if( count.i_int == 0 )
1265 gnutls_global_deinit( );
1266 msg_Dbg( p_this, "GnuTLS deinitialized" );
1269 vlc_mutex_unlock( lock.p_address );