Functions that operate on Ecore connection objects pertaining to SSL. More...
Functions | |
EAPI int | ecore_con_ssl_available_get (void) |
Return if SSL support is available. More... | |
EAPI Eina_Bool | ecore_con_ssl_server_cert_add (Ecore_Con_Server *svr, const char *cert) |
Add an ssl certificate for use in ecore_con functions. More... | |
EAPI Eina_Bool | ecore_con_ssl_server_privkey_add (Ecore_Con_Server *svr, const char *key_file) |
Add an ssl private key for use in ecore_con functions. More... | |
EAPI Eina_Bool | ecore_con_ssl_server_crl_add (Ecore_Con_Server *svr, const char *crl_file) |
Add an ssl CRL for use in ecore_con functions. More... | |
EAPI Eina_Bool | ecore_con_ssl_server_cafile_add (Ecore_Con_Server *svr, const char *ca_file) |
Add an ssl CA file for use in ecore_con functions. More... | |
EAPI void | ecore_con_ssl_server_verify (Ecore_Con_Server *svr) |
Enable certificate verification on a server object. More... | |
EAPI void | ecore_con_ssl_server_verify_basic (Ecore_Con_Server *svr) |
Enable hostname-based certificate verification on a server object. More... | |
EAPI void | ecore_con_ssl_server_verify_name_set (Ecore_Con_Server *svr, const char *name) |
Set the hostname to verify against in certificate verification. More... | |
EAPI const char * | ecore_con_ssl_server_verify_name_get (Ecore_Con_Server *svr) |
Get the hostname to verify against in certificate verification. More... | |
EAPI Eina_Bool | ecore_con_ssl_server_upgrade (Ecore_Con_Server *svr, Ecore_Con_Type compl_type) |
Upgrade a connection to a specified level of encryption. More... | |
EAPI Eina_Bool | ecore_con_ssl_client_upgrade (Ecore_Con_Client *cl, Ecore_Con_Type compl_type) |
Upgrade a connection to a specified level of encryption. More... | |
Functions that operate on Ecore connection objects pertaining to SSL.
EAPI int ecore_con_ssl_available_get | ( | void | ) |
Return if SSL support is available.
Referenced by ecore_ipc_ssl_available_get().
Add an ssl certificate for use in ecore_con functions.
Use this function to add a SSL PEM certificate. Simply specify the cert here to use it in the server object for connecting or listening. If there is an error loading the certificate, an error will automatically be logged.
svr | The server object |
cert | The path to the certificate. |
EINA_FALSE
if the file cannot be loaded, otherwise EINA_TRUE
. References EINA_FALSE, EINA_TRUE, and eo_data_scope_get().
Add an ssl private key for use in ecore_con functions.
Use this function to add a SSL PEM private key Simply specify the key file here to use it in the server object for connecting or listening. If there is an error loading the key, an error will automatically be logged.
svr | The server object |
key_file | The path to the key file. |
EINA_FALSE
if the file cannot be loaded, otherwise EINA_TRUE
. References EINA_FALSE, EINA_TRUE, and eo_data_scope_get().
Add an ssl CRL for use in ecore_con functions.
Use this function to add a SSL PEM CRL file Simply specify the CRL file here to use it in the server object for connecting or listening. If there is an error loading the CRL, an error will automatically be logged.
svr | The server object |
crl_file | The path to the CRL file. |
EINA_FALSE
if the file cannot be loaded, otherwise EINA_TRUE
. References EINA_FALSE, EINA_TRUE, and eo_data_scope_get().
Add an ssl CA file for use in ecore_con functions.
Use this function to add a SSL PEM CA file. Simply specify the file here to use it in the server object for connecting or listening. If there is an error loading the CAs, an error will automatically be logged.
svr | The server object |
ca_file | The path to the CA file. |
EINA_FALSE
if the file cannot be loaded, otherwise EINA_TRUE
. References EINA_FALSE, EINA_TRUE, and eo_data_scope_get().
EAPI void ecore_con_ssl_server_verify | ( | Ecore_Con_Server * | svr | ) |
Enable certificate verification on a server object.
Call this function on a server object before main loop has started to enable verification of certificates against loaded certificates.
svr | The server object |
References EINA_TRUE, and eo_data_scope_get().
EAPI void ecore_con_ssl_server_verify_basic | ( | Ecore_Con_Server * | svr | ) |
Enable hostname-based certificate verification on a server object.
Call this function on a server object before main loop has started to enable verification of certificates using ONLY their hostnames.
svr | The server object |
References EINA_TRUE, and eo_data_scope_get().
EAPI void ecore_con_ssl_server_verify_name_set | ( | Ecore_Con_Server * | svr, |
const char * | name | ||
) |
Set the hostname to verify against in certificate verification.
Sometimes the certificate hostname will not match the hostname that you are connecting to, and will instead match a different name. An example of this is that if you connect to talk.google.com to use Google Talk, you receive Google's certificate for gmail.com. This certificate should be trusted, and so you must call this function with "gmail.com" as name
. See RFC2818 for more details.
svr | The server object |
name | The hostname to verify against |
References eo_data_scope_get().
EAPI const char* ecore_con_ssl_server_verify_name_get | ( | Ecore_Con_Server * | svr | ) |
Get the hostname to verify against in certificate verification.
This function returns the name which will be used to validate the SSL certificate common name (CN) or alt name (subjectAltName). It will default to the name
param in ecore_con_server_connect(), but can be changed with ecore_con_ssl_server_verify_name_set().
svr | The server object |
References eo_data_scope_get().
Upgrade a connection to a specified level of encryption.
Use this function to begin an SSL handshake on a connection (STARTTLS or similar). Once the upgrade has been completed, an ECORE_CON_EVENT_SERVER_UPGRADE event will be emitted. The connection should be treated as disconnected until the next event.
svr | The server object |
ssl_type | The SSL connection type (ONLY). |
EINA_FALSE
if the connection cannot be upgraded, otherwise EINA_TRUE
. compl_type
WILL mess up your program. References EINA_FALSE, EINA_TRUE, and eo_data_scope_get().
Upgrade a connection to a specified level of encryption.
Use this function to begin an SSL handshake on a connection (STARTTLS or similar). Once the upgrade has been completed, an ECORE_CON_EVENT_CLIENT_UPGRADE event will be emitted. The connection should be treated as disconnected until the next event.
cl | The client object |
ssl_type | The SSL connection type (ONLY). |
EINA_FALSE
if the connection cannot be upgraded, otherwise EINA_TRUE
. compl_type
WILL mess up your program. References alloca(), DBG, ECORE_CON_EVENT_CLIENT_ERROR, ECORE_CON_EVENT_SERVER_ERROR, ECORE_FD_READ, ECORE_FD_WRITE, ecore_main_fd_handler_active_set(), EINA_FALSE, eina_file_ls(), EINA_ITERATOR_FOREACH, eina_iterator_free(), eina_stringshare_del(), EINA_TRUE, EINA_UNUSED, eo_data_scope_get(), ERR, INF, and WRN.