2 * InspIRCd -- Internet Relay Chat Daemon
4 * Copyright (C) 2009-2010 Daniel De Graaf <danieldg@inspircd.org>
5 * Copyright (C) 2008 Pippijn van Steenhoven <pip88nl@gmail.com>
6 * Copyright (C) 2006-2008 Craig Edwards <craigedwards@brainbox.cc>
7 * Copyright (C) 2008 Thomas Stagner <aquanight@inspircd.org>
8 * Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
9 * Copyright (C) 2006 Oliver Lupton <oliverlupton@gmail.com>
11 * This file is part of InspIRCd. InspIRCd is free software: you can
12 * redistribute it and/or modify it under the terms of the GNU General Public
13 * License as published by the Free Software Foundation, version 2.
15 * This program is distributed in the hope that it will be useful, but WITHOUT
16 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
20 * You should have received a copy of the GNU General Public License
21 * along with this program. If not, see <http://www.gnu.org/licenses/>.
27 #include "modules/ssl.h"
29 // Ignore OpenSSL deprecation warnings on OS X Lion and newer.
31 # pragma GCC diagnostic ignored "-Wdeprecated-declarations"
34 // Fix warnings about the use of `long long` on C++03.
36 # pragma clang diagnostic ignored "-Wc++11-long-long"
37 #elif defined __GNUC__
38 # pragma GCC diagnostic ignored "-Wlong-long"
41 #include <openssl/ssl.h>
42 #include <openssl/err.h>
45 # pragma comment(lib, "ssleay32.lib")
46 # pragma comment(lib, "libeay32.lib")
49 /* $CompileFlags: pkgconfversion("openssl","0.9.7") pkgconfincludes("openssl","/openssl/ssl.h","") */
50 /* $LinkerFlags: rpath("pkg-config --libs openssl") pkgconflibs("openssl","/libssl.so","-lssl -lcrypto") */
52 #if ((OPENSSL_VERSION_NUMBER >= 0x10000000L) && (!(defined(OPENSSL_NO_ECDH))))
53 // OpenSSL 0.9.8 includes some ECC support, but it's unfinished. Enable only for 1.0.0 and later.
54 #define INSPIRCD_OPENSSL_ENABLE_ECDH
57 enum issl_status { ISSL_NONE, ISSL_HANDSHAKING, ISSL_OPEN };
59 static bool SelfSigned = false;
60 static int exdataindex;
64 return ERR_error_string(ERR_get_error(), NULL);
67 static int OnVerify(int preverify_ok, X509_STORE_CTX* ctx);
68 static void StaticSSLInfoCallback(const SSL* ssl, int where, int rc);
72 class Exception : public ModuleException
75 Exception(const std::string& reason)
76 : ModuleException(reason) { }
84 DHParams(const std::string& filename)
86 BIO* dhpfile = BIO_new_file(filename.c_str(), "r");
88 throw Exception("Couldn't open DH file " + filename);
90 dh = PEM_read_bio_DHparams(dhpfile, NULL, NULL, NULL);
94 throw Exception("Couldn't read DH params from file " + filename);
114 Context(SSL_CTX* context)
117 // Sane default options for OpenSSL see https://www.openssl.org/docs/ssl/SSL_CTX_set_options.html
118 // and when choosing a cipher, use the server's preferences instead of the client preferences.
119 long opts = SSL_OP_NO_SSLv2 | SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION | SSL_OP_CIPHER_SERVER_PREFERENCE | SSL_OP_SINGLE_DH_USE;
120 // Only turn options on if they exist
121 #ifdef SSL_OP_SINGLE_ECDH_USE
122 opts |= SSL_OP_SINGLE_ECDH_USE;
124 #ifdef SSL_OP_NO_TICKET
125 opts |= SSL_OP_NO_TICKET;
128 ctx_options = SSL_CTX_set_options(ctx, opts);
129 SSL_CTX_set_mode(ctx, SSL_MODE_ENABLE_PARTIAL_WRITE | SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER);
130 SSL_CTX_set_verify(ctx, SSL_VERIFY_PEER | SSL_VERIFY_CLIENT_ONCE, OnVerify);
131 SSL_CTX_set_session_cache_mode(ctx, SSL_SESS_CACHE_OFF);
132 SSL_CTX_set_info_callback(ctx, StaticSSLInfoCallback);
140 bool SetDH(DHParams& dh)
143 return (SSL_CTX_set_tmp_dh(ctx, dh.get()) >= 0);
146 #ifdef INSPIRCD_OPENSSL_ENABLE_ECDH
147 void SetECDH(const std::string& curvename)
149 int nid = OBJ_sn2nid(curvename.c_str());
151 throw Exception("Unknown curve: " + curvename);
153 EC_KEY* eckey = EC_KEY_new_by_curve_name(nid);
155 throw Exception("Unable to create EC key object");
158 bool ret = (SSL_CTX_set_tmp_ecdh(ctx, eckey) >= 0);
161 throw Exception("Couldn't set ECDH parameters");
165 bool SetCiphers(const std::string& ciphers)
168 return SSL_CTX_set_cipher_list(ctx, ciphers.c_str());
171 bool SetCerts(const std::string& filename)
174 return SSL_CTX_use_certificate_chain_file(ctx, filename.c_str());
177 bool SetPrivateKey(const std::string& filename)
180 return SSL_CTX_use_PrivateKey_file(ctx, filename.c_str(), SSL_FILETYPE_PEM);
183 bool SetCA(const std::string& filename)
186 return SSL_CTX_load_verify_locations(ctx, filename.c_str(), 0);
189 long GetDefaultContextOptions() const
194 long SetRawContextOptions(long setoptions, long clearoptions)
197 SSL_CTX_clear_options(ctx, SSL_CTX_get_options(ctx));
199 // Set the default options and what is in the conf
200 SSL_CTX_set_options(ctx, ctx_options | setoptions);
201 return SSL_CTX_clear_options(ctx, clearoptions);
204 SSL* CreateServerSession()
206 SSL* sess = SSL_new(ctx);
207 SSL_set_accept_state(sess); // Act as server
211 SSL* CreateClientSession()
213 SSL* sess = SSL_new(ctx);
214 SSL_set_connect_state(sess); // Act as client
219 class Profile : public refcountbase
221 /** Name of this profile
223 const std::string name;
225 /** DH parameters in use
229 /** OpenSSL makes us have two contexts, one for servers and one for clients
234 /** Digest to use when generating fingerprints
236 const EVP_MD* digest;
238 /** Last error, set by error_callback()
242 /** True if renegotiations are allowed, false if not
244 const bool allowrenego;
246 /** Rough max size of records to send
248 const unsigned int outrecsize;
250 static int error_callback(const char* str, size_t len, void* u)
252 Profile* profile = reinterpret_cast<Profile*>(u);
253 profile->lasterr = std::string(str, len - 1);
257 /** Set raw OpenSSL context (SSL_CTX) options from a config tag
258 * @param ctxname Name of the context, client or server
259 * @param tag Config tag defining this profile
260 * @param context Context object to manipulate
262 void SetContextOptions(const std::string& ctxname, ConfigTag* tag, Context& context)
264 long setoptions = tag->getInt(ctxname + "setoptions");
265 long clearoptions = tag->getInt(ctxname + "clearoptions");
266 #ifdef SSL_OP_NO_COMPRESSION
267 if (!tag->getBool("compression", true))
268 setoptions |= SSL_OP_NO_COMPRESSION;
270 if (!tag->getBool("sslv3", true))
271 setoptions |= SSL_OP_NO_SSLv3;
272 if (!tag->getBool("tlsv1", true))
273 setoptions |= SSL_OP_NO_TLSv1;
275 if (!setoptions && !clearoptions)
276 return; // Nothing to do
278 ServerInstance->Logs->Log(MODNAME, LOG_DEBUG, "Setting %s %s context options, default: %ld set: %ld clear: %ld", name.c_str(), ctxname.c_str(), ctx.GetDefaultContextOptions(), setoptions, clearoptions);
279 long final = context.SetRawContextOptions(setoptions, clearoptions);
280 ServerInstance->Logs->Log(MODNAME, LOG_DEFAULT, "%s %s context options: %ld", name.c_str(), ctxname.c_str(), final);
284 Profile(const std::string& profilename, ConfigTag* tag)
286 , dh(ServerInstance->Config->Paths.PrependConfig(tag->getString("dhfile", "dh.pem")))
287 , ctx(SSL_CTX_new(SSLv23_server_method()))
288 , clictx(SSL_CTX_new(SSLv23_client_method()))
289 , allowrenego(tag->getBool("renegotiation")) // Disallow by default
290 , outrecsize(tag->getInt("outrecsize", 2048, 512, 16384))
292 if ((!ctx.SetDH(dh)) || (!clictx.SetDH(dh)))
293 throw Exception("Couldn't set DH parameters");
295 std::string hash = tag->getString("hash", "md5");
296 digest = EVP_get_digestbyname(hash.c_str());
298 throw Exception("Unknown hash type " + hash);
300 std::string ciphers = tag->getString("ciphers");
301 if (!ciphers.empty())
303 if ((!ctx.SetCiphers(ciphers)) || (!clictx.SetCiphers(ciphers)))
305 ERR_print_errors_cb(error_callback, this);
306 throw Exception("Can't set cipher list to \"" + ciphers + "\" " + lasterr);
310 #ifdef INSPIRCD_OPENSSL_ENABLE_ECDH
311 std::string curvename = tag->getString("ecdhcurve", "prime256v1");
312 if (!curvename.empty())
313 ctx.SetECDH(curvename);
316 SetContextOptions("server", tag, ctx);
317 SetContextOptions("client", tag, clictx);
319 /* Load our keys and certificates
320 * NOTE: OpenSSL's error logging API sucks, don't blame us for this clusterfuck.
322 std::string filename = ServerInstance->Config->Paths.PrependConfig(tag->getString("certfile", "cert.pem"));
323 if ((!ctx.SetCerts(filename)) || (!clictx.SetCerts(filename)))
325 ERR_print_errors_cb(error_callback, this);
326 throw Exception("Can't read certificate file: " + lasterr);
329 filename = ServerInstance->Config->Paths.PrependConfig(tag->getString("keyfile", "key.pem"));
330 if ((!ctx.SetPrivateKey(filename)) || (!clictx.SetPrivateKey(filename)))
332 ERR_print_errors_cb(error_callback, this);
333 throw Exception("Can't read key file: " + lasterr);
336 // Load the CAs we trust
337 filename = ServerInstance->Config->Paths.PrependConfig(tag->getString("cafile", "ca.pem"));
338 if ((!ctx.SetCA(filename)) || (!clictx.SetCA(filename)))
340 ERR_print_errors_cb(error_callback, this);
341 ServerInstance->Logs->Log(MODNAME, LOG_DEFAULT, "Can't read CA list from %s. This is only a problem if you want to verify client certificates, otherwise it's safe to ignore this message. Error: %s", filename.c_str(), lasterr.c_str());
345 const std::string& GetName() const { return name; }
346 SSL* CreateServerSession() { return ctx.CreateServerSession(); }
347 SSL* CreateClientSession() { return clictx.CreateClientSession(); }
348 const EVP_MD* GetDigest() { return digest; }
349 bool AllowRenegotiation() const { return allowrenego; }
350 unsigned int GetOutgoingRecordSize() const { return outrecsize; }
354 static int OnVerify(int preverify_ok, X509_STORE_CTX *ctx)
356 /* XXX: This will allow self signed certificates.
357 * In the future if we want an option to not allow this,
358 * we can just return preverify_ok here, and openssl
359 * will boot off self-signed and invalid peer certs.
361 int ve = X509_STORE_CTX_get_error(ctx);
363 SelfSigned = (ve == X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT);
368 class OpenSSLIOHook : public SSLIOHook
374 reference<OpenSSL::Profile> profile;
376 // Returns 1 if handshake succeeded, 0 if it is still in progress, -1 if it failed
377 int Handshake(StreamSocket* user)
380 int ret = SSL_do_handshake(sess);
383 int err = SSL_get_error(sess, ret);
385 if (err == SSL_ERROR_WANT_READ)
387 SocketEngine::ChangeEventMask(user, FD_WANT_POLL_READ | FD_WANT_NO_WRITE);
388 this->status = ISSL_HANDSHAKING;
391 else if (err == SSL_ERROR_WANT_WRITE)
393 SocketEngine::ChangeEventMask(user, FD_WANT_NO_READ | FD_WANT_SINGLE_WRITE);
394 this->status = ISSL_HANDSHAKING;
405 // Handshake complete.
410 SocketEngine::ChangeEventMask(user, FD_WANT_POLL_READ | FD_WANT_NO_WRITE | FD_ADD_TRIAL_WRITE);
433 void VerifyCertificate()
436 ssl_cert* certinfo = new ssl_cert;
437 this->certificate = certinfo;
439 unsigned char md[EVP_MAX_MD_SIZE];
441 cert = SSL_get_peer_certificate(sess);
445 certinfo->error = "Could not get peer certificate: "+std::string(get_error());
449 certinfo->invalid = (SSL_get_verify_result(sess) != X509_V_OK);
453 certinfo->unknownsigner = false;
454 certinfo->trusted = true;
458 certinfo->unknownsigner = true;
459 certinfo->trusted = false;
463 X509_NAME_oneline(X509_get_subject_name(cert), buf, sizeof(buf));
465 // Make sure there are no chars in the string that we consider invalid
466 if (certinfo->dn.find_first_of("\r\n") != std::string::npos)
467 certinfo->dn.clear();
469 X509_NAME_oneline(X509_get_issuer_name(cert), buf, sizeof(buf));
470 certinfo->issuer = buf;
471 if (certinfo->issuer.find_first_of("\r\n") != std::string::npos)
472 certinfo->issuer.clear();
474 if (!X509_digest(cert, profile->GetDigest(), md, &n))
476 certinfo->error = "Out of memory generating fingerprint";
480 certinfo->fingerprint = BinToHex(md, n);
483 if ((ASN1_UTCTIME_cmp_time_t(X509_get_notAfter(cert), ServerInstance->Time()) == -1) || (ASN1_UTCTIME_cmp_time_t(X509_get_notBefore(cert), ServerInstance->Time()) == 0))
485 certinfo->error = "Not activated, or expired certificate";
491 void SSLInfoCallback(int where, int rc)
493 if ((where & SSL_CB_HANDSHAKE_START) && (status == ISSL_OPEN))
495 if (profile->AllowRenegotiation())
498 // The other side is trying to renegotiate, kill the connection and change status
499 // to ISSL_NONE so CheckRenego() closes the session
501 SocketEngine::Shutdown(SSL_get_fd(sess), 2);
505 bool CheckRenego(StreamSocket* sock)
507 if (status != ISSL_NONE)
510 ServerInstance->Logs->Log(MODNAME, LOG_DEBUG, "Session %p killed, attempted to renegotiate", (void*)sess);
512 sock->SetError("Renegotiation is not allowed");
516 // Returns 1 if application I/O should proceed, 0 if it must wait for the underlying protocol to progress, -1 on fatal error
517 int PrepareIO(StreamSocket* sock)
519 if (status == ISSL_OPEN)
521 else if (status == ISSL_HANDSHAKING)
523 // The handshake isn't finished, try to finish it
524 return Handshake(sock);
531 // Calls our private SSLInfoCallback()
532 friend void StaticSSLInfoCallback(const SSL* ssl, int where, int rc);
535 OpenSSLIOHook(IOHookProvider* hookprov, StreamSocket* sock, SSL* session, const reference<OpenSSL::Profile>& sslprofile)
536 : SSLIOHook(hookprov)
539 , data_to_write(false)
540 , profile(sslprofile)
544 if (SSL_set_fd(sess, sock->GetFd()) == 0)
545 throw ModuleException("Can't set fd with SSL_set_fd: " + ConvToStr(sock->GetFd()));
547 SSL_set_ex_data(sess, exdataindex, this);
548 sock->AddIOHook(this);
552 void OnStreamSocketClose(StreamSocket* user) CXX11_OVERRIDE
557 int OnStreamSocketRead(StreamSocket* user, std::string& recvq) CXX11_OVERRIDE
559 // Finish handshake if needed
560 int prepret = PrepareIO(user);
564 // If we resumed the handshake then this->status will be ISSL_OPEN
567 char* buffer = ServerInstance->GetReadBuffer();
568 size_t bufsiz = ServerInstance->Config->NetBufferSize;
569 int ret = SSL_read(sess, buffer, bufsiz);
571 if (!CheckRenego(user))
576 recvq.append(buffer, ret);
578 SocketEngine::ChangeEventMask(user, FD_WANT_POLL_READ | FD_WANT_SINGLE_WRITE);
583 // Client closed connection.
585 user->SetError("Connection closed");
590 int err = SSL_get_error(sess, ret);
592 if (err == SSL_ERROR_WANT_READ)
594 SocketEngine::ChangeEventMask(user, FD_WANT_POLL_READ);
597 else if (err == SSL_ERROR_WANT_WRITE)
599 SocketEngine::ChangeEventMask(user, FD_WANT_NO_READ | FD_WANT_SINGLE_WRITE);
611 int OnStreamSocketWrite(StreamSocket* user) CXX11_OVERRIDE
613 // Finish handshake if needed
614 int prepret = PrepareIO(user);
618 data_to_write = true;
620 // Session is ready for transferring application data
621 StreamSocket::SendQueue& sendq = user->GetSendQ();
622 while (!sendq.empty())
625 FlattenSendQueue(sendq, profile->GetOutgoingRecordSize());
626 const StreamSocket::SendQueue::Element& buffer = sendq.front();
627 int ret = SSL_write(sess, buffer.data(), buffer.size());
629 if (!CheckRenego(user))
632 if (ret == (int)buffer.length())
634 // Wrote entire record, continue sending
639 sendq.erase_front(ret);
640 SocketEngine::ChangeEventMask(user, FD_WANT_SINGLE_WRITE);
650 int err = SSL_get_error(sess, ret);
652 if (err == SSL_ERROR_WANT_WRITE)
654 SocketEngine::ChangeEventMask(user, FD_WANT_SINGLE_WRITE);
657 else if (err == SSL_ERROR_WANT_READ)
659 SocketEngine::ChangeEventMask(user, FD_WANT_POLL_READ);
670 data_to_write = false;
671 SocketEngine::ChangeEventMask(user, FD_WANT_POLL_READ | FD_WANT_NO_WRITE);
675 void TellCiphersAndFingerprint(LocalUser* user)
679 std::string text = "*** You are connected using SSL cipher '";
680 GetCiphersuite(text);
682 const std::string& fingerprint = certificate->fingerprint;
683 if (!fingerprint.empty())
684 text += " and your SSL certificate fingerprint is " + fingerprint;
686 user->WriteNotice(text);
690 void GetCiphersuite(std::string& out) const
692 out.append(SSL_get_version(sess)).push_back('-');
693 out.append(SSL_get_cipher(sess));
696 bool IsHandshakeDone() const { return (status == ISSL_OPEN); }
699 static void StaticSSLInfoCallback(const SSL* ssl, int where, int rc)
701 OpenSSLIOHook* hook = static_cast<OpenSSLIOHook*>(SSL_get_ex_data(ssl, exdataindex));
702 hook->SSLInfoCallback(where, rc);
705 class OpenSSLIOHookProvider : public refcountbase, public IOHookProvider
707 reference<OpenSSL::Profile> profile;
710 OpenSSLIOHookProvider(Module* mod, reference<OpenSSL::Profile>& prof)
711 : IOHookProvider(mod, "ssl/" + prof->GetName(), IOHookProvider::IOH_SSL)
714 ServerInstance->Modules->AddService(*this);
717 ~OpenSSLIOHookProvider()
719 ServerInstance->Modules->DelService(*this);
722 void OnAccept(StreamSocket* sock, irc::sockets::sockaddrs* client, irc::sockets::sockaddrs* server) CXX11_OVERRIDE
724 new OpenSSLIOHook(this, sock, profile->CreateServerSession(), profile);
727 void OnConnect(StreamSocket* sock) CXX11_OVERRIDE
729 new OpenSSLIOHook(this, sock, profile->CreateClientSession(), profile);
733 class ModuleSSLOpenSSL : public Module
735 typedef std::vector<reference<OpenSSLIOHookProvider> > ProfileList;
737 ProfileList profiles;
741 ProfileList newprofiles;
742 ConfigTagList tags = ServerInstance->Config->ConfTags("sslprofile");
743 if (tags.first == tags.second)
745 // Create a default profile named "openssl"
746 const std::string defname = "openssl";
747 ConfigTag* tag = ServerInstance->Config->ConfValue(defname);
748 ServerInstance->Logs->Log(MODNAME, LOG_DEFAULT, "No <sslprofile> tags found, using settings from the <openssl> tag");
752 reference<OpenSSL::Profile> profile(new OpenSSL::Profile(defname, tag));
753 newprofiles.push_back(new OpenSSLIOHookProvider(this, profile));
755 catch (OpenSSL::Exception& ex)
757 throw ModuleException("Error while initializing the default SSL profile - " + ex.GetReason());
761 for (ConfigIter i = tags.first; i != tags.second; ++i)
763 ConfigTag* tag = i->second;
764 if (tag->getString("provider") != "openssl")
767 std::string name = tag->getString("name");
770 ServerInstance->Logs->Log(MODNAME, LOG_DEFAULT, "Ignoring <sslprofile> tag without name at " + tag->getTagLocation());
774 reference<OpenSSL::Profile> profile;
777 profile = new OpenSSL::Profile(name, tag);
779 catch (CoreException& ex)
781 throw ModuleException("Error while initializing SSL profile \"" + name + "\" at " + tag->getTagLocation() + " - " + ex.GetReason());
784 newprofiles.push_back(new OpenSSLIOHookProvider(this, profile));
787 profiles.swap(newprofiles);
793 // Initialize OpenSSL
795 SSL_load_error_strings();
798 void init() CXX11_OVERRIDE
800 ServerInstance->Logs->Log(MODNAME, LOG_DEFAULT, "OpenSSL lib version \"%s\" module was compiled for \"" OPENSSL_VERSION_TEXT "\"", SSLeay_version(SSLEAY_VERSION));
802 // Register application specific data
803 char exdatastr[] = "inspircd";
804 exdataindex = SSL_get_ex_new_index(0, exdatastr, NULL, NULL, NULL);
806 throw ModuleException("Failed to register application specific data");
811 void OnModuleRehash(User* user, const std::string ¶m) CXX11_OVERRIDE
820 catch (ModuleException& ex)
822 ServerInstance->Logs->Log(MODNAME, LOG_DEFAULT, ex.GetReason() + " Not applying settings.");
826 void OnUserConnect(LocalUser* user) CXX11_OVERRIDE
828 IOHook* hook = user->eh.GetIOHook();
829 if (hook && hook->prov->creator == this)
830 static_cast<OpenSSLIOHook*>(hook)->TellCiphersAndFingerprint(user);
833 void OnCleanup(int target_type, void* item) CXX11_OVERRIDE
835 if (target_type == TYPE_USER)
837 LocalUser* user = IS_LOCAL((User*)item);
839 if (user && user->eh.GetIOHook() && user->eh.GetIOHook()->prov->creator == this)
841 // User is using SSL, they're a local user, and they're using one of *our* SSL ports.
842 // Potentially there could be multiple SSL modules loaded at once on different ports.
843 ServerInstance->Users->QuitUser(user, "SSL module unloading");
848 ModResult OnCheckReady(LocalUser* user) CXX11_OVERRIDE
850 if ((user->eh.GetIOHook()) && (user->eh.GetIOHook()->prov->creator == this))
852 OpenSSLIOHook* iohook = static_cast<OpenSSLIOHook*>(user->eh.GetIOHook());
853 if (!iohook->IsHandshakeDone())
857 return MOD_RES_PASSTHRU;
860 Version GetVersion() CXX11_OVERRIDE
862 return Version("Provides SSL support for clients", VF_VENDOR);
866 MODULE_INIT(ModuleSSLOpenSSL)