1 // Functions in this module handle SSL encryption when WebCit is running
4 // Copyright (c) 1996-2022 by the citadel.org team
6 // This program is open source software. It runs great on the
7 // Linux operating system (and probably elsewhere). You can use,
8 // copy, and run it under the terms of the GNU General Public
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
18 SSL_CTX *ssl_ctx; // global SSL context
19 char key_file[PATH_MAX] = "";
20 char cert_file[PATH_MAX] = "";
21 char *ssl_cipher_list = DEFAULT_SSL_CIPHER_LIST;
24 // Set the private key and certificate chain for the global SSL Context.
25 // This is called during initialization, and can be called again later if the certificate changes.
26 void bind_to_key_and_certificate(void) {
27 if (IsEmptyStr(key_file)) {
28 snprintf(key_file, sizeof key_file, "%s/keys/citadel.key", ctdl_dir);
30 if (IsEmptyStr(cert_file)) {
31 snprintf(cert_file, sizeof key_file, "%s/keys/citadel.cer", ctdl_dir);
34 syslog(LOG_DEBUG, "crypto: [re]installing key \"%s\" and certificate \"%s\"", key_file, cert_file);
36 SSL_CTX_use_certificate_chain_file(ssl_ctx, cert_file);
37 SSL_CTX_use_PrivateKey_file(ssl_ctx, key_file, SSL_FILETYPE_PEM);
39 if ( !SSL_CTX_check_private_key(ssl_ctx) ) {
40 syslog(LOG_WARNING, "crypto: cannot install certificate: %s", ERR_reason_error_string(ERR_get_error()));
45 // Initialize ssl engine, load certs and initialize openssl internals
47 const SSL_METHOD *ssl_method;
52 EVP_PKEY *req_pkey = NULL;
53 X509_NAME *name = NULL;
58 // Initialize SSL transport layer
60 SSL_load_error_strings();
61 ssl_method = SSLv23_server_method();
62 if (!(ssl_ctx = SSL_CTX_new(ssl_method))) {
63 syslog(LOG_WARNING, "SSL_CTX_new failed: %s", ERR_reason_error_string(ERR_get_error()));
67 syslog(LOG_INFO, "Requesting cipher list: %s", ssl_cipher_list);
68 if (!(SSL_CTX_set_cipher_list(ssl_ctx, ssl_cipher_list))) {
69 syslog(LOG_WARNING, "SSL_CTX_set_cipher_list failed: %s", ERR_reason_error_string(ERR_get_error()));
73 // Now try to bind to the key and certificate.
74 bind_to_key_and_certificate();
78 // Check the modification time of the key and certificate -- reload if they changed
79 void update_key_and_cert_if_needed(void) {
80 static time_t previous_mtime = 0;
84 if (stat(key_file, &keystat) != 0) {
85 syslog(LOG_ERR, "%s: %s", key_file, strerror(errno));
88 if (stat(cert_file, &certstat) != 0) {
89 syslog(LOG_ERR, "%s: %s", cert_file, strerror(errno));
93 if ((keystat.st_mtime + certstat.st_mtime) != previous_mtime) {
94 bind_to_key_and_certificate();
95 previous_mtime = keystat.st_mtime + certstat.st_mtime;
100 // starts SSL/TLS encryption for the current session.
101 void starttls(struct client_handle *ch) {
102 int retval, bits, alg_bits;
108 // Check the modification time of the key and certificate -- reload if they changed
109 update_key_and_cert_if_needed();
111 if (!(ch->ssl_handle = SSL_new(ssl_ctx))) {
112 syslog(LOG_WARNING, "SSL_new failed: %s", ERR_reason_error_string(ERR_get_error()));
115 if (!(SSL_set_fd(ch->ssl_handle, ch->sock))) {
116 syslog(LOG_WARNING, "SSL_set_fd failed: %s", ERR_reason_error_string(ERR_get_error()));
117 SSL_free(ch->ssl_handle);
120 retval = SSL_accept(ch->ssl_handle);
122 syslog(LOG_WARNING, "SSL_accept failed: %s", ERR_reason_error_string(ERR_get_error()));
125 syslog(LOG_INFO, "SSL_accept success");
127 bits = SSL_CIPHER_get_bits(SSL_get_current_cipher(ch->ssl_handle), &alg_bits);
128 syslog(LOG_INFO, "SSL/TLS using %s on %s (%d of %d bits)",
129 SSL_CIPHER_get_name(SSL_get_current_cipher(ch->ssl_handle)),
130 SSL_CIPHER_get_version(SSL_get_current_cipher(ch->ssl_handle)), bits, alg_bits);
131 syslog(LOG_INFO, "SSL started");
135 // shuts down the TLS connection
136 void endtls(struct client_handle *ch) {
137 syslog(LOG_INFO, "Ending SSL/TLS");
138 if (ch->ssl_handle != NULL) {
139 SSL_shutdown(ch->ssl_handle);
140 SSL_get_SSL_CTX(ch->ssl_handle);
141 SSL_free(ch->ssl_handle);
143 ch->ssl_handle = NULL;
147 // Send binary data to the client encrypted.
148 int client_write_ssl(struct client_handle *ch, char *buf, int nbytes) {
153 if (ch->ssl_handle == NULL)
157 while (nremain > 0) {
158 if (SSL_want_write(ch->ssl_handle)) {
159 if ((SSL_read(ch->ssl_handle, junk, 0)) < 1) {
160 syslog(LOG_WARNING, "SSL_read in client_write: %s", ERR_reason_error_string(ERR_get_error()));
163 retval = SSL_write(ch->ssl_handle, &buf[nbytes - nremain], nremain);
167 errval = SSL_get_error(ch->ssl_handle, retval);
168 if (errval == SSL_ERROR_WANT_READ || errval == SSL_ERROR_WANT_WRITE) {
172 syslog(LOG_WARNING, "SSL_write: %s", ERR_reason_error_string(ERR_get_error()));
174 syslog(LOG_WARNING, "errno is %d", errno);
185 // read data from the encrypted layer
186 int client_read_ssl(struct client_handle *ch, char *buf, int nbytes) {
191 if (ch->ssl_handle == NULL)
194 while (bytes_read < nbytes) {
195 if (SSL_want_read(ch->ssl_handle)) {
196 if ((SSL_write(ch->ssl_handle, junk, 0)) < 1) {
197 syslog(LOG_WARNING, "SSL_write in client_read");
200 rlen = SSL_read(ch->ssl_handle, &buf[bytes_read], nbytes - bytes_read);
203 errval = SSL_get_error(ch->ssl_handle, rlen);
204 if (errval == SSL_ERROR_WANT_READ || errval == SSL_ERROR_WANT_WRITE) {
208 syslog(LOG_WARNING, "SSL_read error %ld", errval);