/* Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /* _ _ * _ __ ___ ___ __| | ___ ___| | mod_ssl * | '_ ` _ \ / _ \ / _` | / __/ __| | Apache Interface to OpenSSL * | | | | | | (_) | (_| | \__ \__ \ | * |_| |_| |_|\___/ \__,_|___|___/___/_| * |_____| * ssl_engine_init.c * Initialization of Servers */ /* ``Recursive, adj.; see Recursive.'' -- Unknown */ #include "ssl_private.h" /* _________________________________________________________________ ** ** Module Initialization ** _________________________________________________________________ */ static void ssl_add_version_components(apr_pool_t *p, server_rec *s) { char *modver = ssl_var_lookup(p, s, NULL, NULL, "SSL_VERSION_INTERFACE"); char *libver = ssl_var_lookup(p, s, NULL, NULL, "SSL_VERSION_LIBRARY"); char *incver = ssl_var_lookup(p, s, NULL, NULL, "SSL_VERSION_LIBRARY_INTERFACE"); ap_add_version_component(p, modver); ap_add_version_component(p, libver); ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "%s compiled against Server: %s, Library: %s", modver, AP_SERVER_BASEVERSION, incver); } /* * Handle the Temporary RSA Keys and DH Params */ #define MODSSL_TMP_KEY_FREE(mc, type, idx) \ if (mc->pTmpKeys[idx]) { \ type##_free((type *)mc->pTmpKeys[idx]); \ mc->pTmpKeys[idx] = NULL; \ } #define MODSSL_TMP_KEYS_FREE(mc, type) \ MODSSL_TMP_KEY_FREE(mc, type, SSL_TMP_KEY_##type##_512); \ MODSSL_TMP_KEY_FREE(mc, type, SSL_TMP_KEY_##type##_1024) static void ssl_tmp_keys_free(server_rec *s) { SSLModConfigRec *mc = myModConfig(s); MODSSL_TMP_KEYS_FREE(mc, RSA); MODSSL_TMP_KEYS_FREE(mc, DH); } static int ssl_tmp_key_init_rsa(server_rec *s, int bits, int idx) { SSLModConfigRec *mc = myModConfig(s); if (!(mc->pTmpKeys[idx] = RSA_generate_key(bits, RSA_F4, NULL, NULL))) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Init: Failed to generate temporary " "%d bit RSA private key", bits); return !OK; } return OK; } static int ssl_tmp_key_init_dh(server_rec *s, int bits, int idx) { SSLModConfigRec *mc = myModConfig(s); if (!(mc->pTmpKeys[idx] = ssl_dh_GetTmpParam(bits))) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Init: Failed to generate temporary " "%d bit DH parameters", bits); return !OK; } return OK; } #define MODSSL_TMP_KEY_INIT_RSA(s, bits) \ ssl_tmp_key_init_rsa(s, bits, SSL_TMP_KEY_RSA_##bits) #define MODSSL_TMP_KEY_INIT_DH(s, bits) \ ssl_tmp_key_init_dh(s, bits, SSL_TMP_KEY_DH_##bits) static int ssl_tmp_keys_init(server_rec *s) { ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "Init: Generating temporary RSA private keys (512/1024 bits)"); if (MODSSL_TMP_KEY_INIT_RSA(s, 512) || MODSSL_TMP_KEY_INIT_RSA(s, 1024)) { return !OK; } ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "Init: Generating temporary DH parameters (512/1024 bits)"); if (MODSSL_TMP_KEY_INIT_DH(s, 512) || MODSSL_TMP_KEY_INIT_DH(s, 1024)) { return !OK; } return OK; } /* * Per-module initialization */ int ssl_init_Module(apr_pool_t *p, apr_pool_t *plog, apr_pool_t *ptemp, server_rec *base_server) { SSLModConfigRec *mc = myModConfig(base_server); SSLSrvConfigRec *sc; server_rec *s; /* We initialize mc->pid per-process in the child init, * but it should be initialized for startup before we * call ssl_rand_seed() below. */ mc->pid = getpid(); /* * Let us cleanup on restarts and exists */ apr_pool_cleanup_register(p, base_server, ssl_init_ModuleKill, apr_pool_cleanup_null); /* * Any init round fixes the global config */ ssl_config_global_create(base_server); /* just to avoid problems */ ssl_config_global_fix(mc); /* * try to fix the configuration and open the dedicated SSL * logfile as early as possible */ for (s = base_server; s; s = s->next) { sc = mySrvConfig(s); if (sc->server) { sc->server->sc = sc; } if (sc->proxy) { sc->proxy->sc = sc; } /* * Create the server host:port string because we need it a lot */ sc->vhost_id = ssl_util_vhostid(p, s); sc->vhost_id_len = strlen(sc->vhost_id); if (ap_get_server_protocol(s) && strcmp("https", ap_get_server_protocol(s)) == 0) { sc->enabled = SSL_ENABLED_TRUE; } /* If sc->enabled is UNSET, then SSL is optional on this vhost */ /* Fix up stuff that may not have been set */ if (sc->enabled == SSL_ENABLED_UNSET) { sc->enabled = SSL_ENABLED_FALSE; } if (sc->proxy_enabled == UNSET) { sc->proxy_enabled = FALSE; } if (sc->session_cache_timeout == UNSET) { sc->session_cache_timeout = SSL_SESSION_CACHE_TIMEOUT; } if (sc->server->pphrase_dialog_type == SSL_PPTYPE_UNSET) { sc->server->pphrase_dialog_type = SSL_PPTYPE_BUILTIN; } } #if APR_HAS_THREADS ssl_util_thread_setup(p); #endif /* * SSL external crypto device ("engine") support */ #if defined(HAVE_OPENSSL_ENGINE_H) && defined(HAVE_ENGINE_INIT) ssl_init_Engine(base_server, p); #endif ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "Init: Initialized %s library", SSL_LIBRARY_NAME); /* * Seed the Pseudo Random Number Generator (PRNG) * only need ptemp here; nothing inside allocated from the pool * needs to live once we return from ssl_rand_seed(). */ ssl_rand_seed(base_server, ptemp, SSL_RSCTX_STARTUP, "Init: "); /* * read server private keys/public certs into memory. * decrypting any encrypted keys via configured SSLPassPhraseDialogs * anything that needs to live longer than ptemp needs to also survive * restarts, in which case they'll live inside s->process->pool. */ ssl_pphrase_Handle(base_server, ptemp); if (ssl_tmp_keys_init(base_server)) { return !OK; } /* * initialize the mutex handling */ if (!ssl_mutex_init(base_server, p)) { return HTTP_INTERNAL_SERVER_ERROR; } /* * initialize session caching */ ssl_scache_init(base_server, p); /* * initialize servers */ ap_log_error(APLOG_MARK, APLOG_INFO, 0, base_server, "Init: Initializing (virtual) servers for SSL"); for (s = base_server; s; s = s->next) { sc = mySrvConfig(s); /* * Either now skip this server when SSL is disabled for * it or give out some information about what we're * configuring. */ /* * Read the server certificate and key */ ssl_init_ConfigureServer(s, p, ptemp, sc); } /* * Configuration consistency checks */ ssl_init_CheckServers(base_server, ptemp); /* * Announce mod_ssl and SSL library in HTTP Server field * as ``mod_ssl/X.X.X OpenSSL/X.X.X'' */ ssl_add_version_components(p, base_server); SSL_init_app_data2_idx(); /* for SSL_get_app_data2() at request time */ return OK; } /* * Support for external a Crypto Device ("engine"), usually * a hardware accellerator card for crypto operations. */ #if defined(HAVE_OPENSSL_ENGINE_H) && defined(HAVE_ENGINE_INIT) void ssl_init_Engine(server_rec *s, apr_pool_t *p) { SSLModConfigRec *mc = myModConfig(s); ENGINE *e; if (mc->szCryptoDevice) { if (!(e = ENGINE_by_id(mc->szCryptoDevice))) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Init: Failed to load Crypto Device API `%s'", mc->szCryptoDevice); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } if (strEQ(mc->szCryptoDevice, "chil")) { ENGINE_ctrl(e, ENGINE_CTRL_CHIL_SET_FORKCHECK, 1, 0, 0); } if (!ENGINE_set_default(e, ENGINE_METHOD_ALL)) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Init: Failed to enable Crypto Device API `%s'", mc->szCryptoDevice); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "Init: loaded Crypto Device API `%s'", mc->szCryptoDevice); ENGINE_free(e); } } #endif static void ssl_init_server_check(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { /* * check for important parameters and the * possibility that the user forgot to set them. */ if (!mctx->pks->cert_files[0]) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "No SSL Certificate set [hint: SSLCertificateFile]"); ssl_die(); } /* * Check for problematic re-initializations */ if (mctx->pks->certs[SSL_AIDX_RSA] || mctx->pks->certs[SSL_AIDX_DSA]) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Illegal attempt to re-initialise SSL for server " "(theoretically shouldn't happen!)"); ssl_die(); } } static void ssl_init_ctx_protocol(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { SSL_CTX *ctx = NULL; MODSSL_SSL_METHOD_CONST SSL_METHOD *method = NULL; char *cp; int protocol = mctx->protocol; /* * Create the new per-server SSL context */ if (protocol == SSL_PROTOCOL_NONE) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "No SSL protocols available [hint: SSLProtocol]"); ssl_die(); } cp = apr_pstrcat(p, (protocol & SSL_PROTOCOL_SSLV2 ? "SSLv2, " : ""), (protocol & SSL_PROTOCOL_SSLV3 ? "SSLv3, " : ""), (protocol & SSL_PROTOCOL_TLSV1 ? "TLSv1, " : ""), NULL); cp[strlen(cp)-2] = NUL; ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Creating new SSL context (protocols: %s)", cp); if (protocol == SSL_PROTOCOL_SSLV2) { method = mctx->pkp ? SSLv2_client_method() : /* proxy */ SSLv2_server_method(); /* server */ ctx = SSL_CTX_new(method); /* only SSLv2 is left */ } else { method = mctx->pkp ? SSLv23_client_method() : /* proxy */ SSLv23_server_method(); /* server */ ctx = SSL_CTX_new(method); /* be more flexible */ } mctx->ssl_ctx = ctx; SSL_CTX_set_options(ctx, SSL_OP_ALL); if (!(protocol & SSL_PROTOCOL_SSLV2)) { SSL_CTX_set_options(ctx, SSL_OP_NO_SSLv2); } if (!(protocol & SSL_PROTOCOL_SSLV3)) { SSL_CTX_set_options(ctx, SSL_OP_NO_SSLv3); } if (!(protocol & SSL_PROTOCOL_TLSV1)) { SSL_CTX_set_options(ctx, SSL_OP_NO_TLSv1); } #ifdef SSL_OP_CIPHER_SERVER_PREFERENCE { SSLSrvConfigRec *sc = mySrvConfig(s); if (sc->cipher_server_pref == TRUE) { SSL_CTX_set_options(ctx, SSL_OP_CIPHER_SERVER_PREFERENCE); } } #endif SSL_CTX_set_app_data(ctx, s); /* * Configure additional context ingredients */ SSL_CTX_set_options(ctx, SSL_OP_SINGLE_DH_USE); #ifdef SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION /* * Disallow a session from being resumed during a renegotiation, * so that an acceptable cipher suite can be negotiated. */ SSL_CTX_set_options(ctx, SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION); #endif } static void ssl_init_ctx_session_cache(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { SSL_CTX *ctx = mctx->ssl_ctx; SSLModConfigRec *mc = myModConfig(s); long cache_mode = SSL_SESS_CACHE_OFF; if (mc->nSessionCacheMode != SSL_SCMODE_NONE) { /* SSL_SESS_CACHE_NO_INTERNAL will force OpenSSL * to ignore process local-caching and * to always get/set/delete sessions using mod_ssl's callbacks. */ cache_mode = SSL_SESS_CACHE_SERVER|SSL_SESS_CACHE_NO_INTERNAL; } SSL_CTX_set_session_cache_mode(ctx, cache_mode); SSL_CTX_sess_set_new_cb(ctx, ssl_callback_NewSessionCacheEntry); SSL_CTX_sess_set_get_cb(ctx, ssl_callback_GetSessionCacheEntry); SSL_CTX_sess_set_remove_cb(ctx, ssl_callback_DelSessionCacheEntry); } static void ssl_init_ctx_callbacks(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { SSL_CTX *ctx = mctx->ssl_ctx; SSL_CTX_set_tmp_rsa_callback(ctx, ssl_callback_TmpRSA); SSL_CTX_set_tmp_dh_callback(ctx, ssl_callback_TmpDH); if (s->loglevel >= APLOG_DEBUG) { /* this callback only logs if LogLevel >= info */ SSL_CTX_set_info_callback(ctx, ssl_callback_LogTracingState); } } static void ssl_init_ctx_verify(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { SSL_CTX *ctx = mctx->ssl_ctx; int verify = SSL_VERIFY_NONE; STACK_OF(X509_NAME) *ca_list; if (mctx->auth.verify_mode == SSL_CVERIFY_UNSET) { mctx->auth.verify_mode = SSL_CVERIFY_NONE; } if (mctx->auth.verify_depth == UNSET) { mctx->auth.verify_depth = 1; } /* * Configure callbacks for SSL context */ if (mctx->auth.verify_mode == SSL_CVERIFY_REQUIRE) { verify |= SSL_VERIFY_PEER_STRICT; } if ((mctx->auth.verify_mode == SSL_CVERIFY_OPTIONAL) || (mctx->auth.verify_mode == SSL_CVERIFY_OPTIONAL_NO_CA)) { verify |= SSL_VERIFY_PEER; } SSL_CTX_set_verify(ctx, verify, ssl_callback_SSLVerify); /* * Configure Client Authentication details */ if (mctx->auth.ca_cert_file || mctx->auth.ca_cert_path) { ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Configuring client authentication"); if (!SSL_CTX_load_verify_locations(ctx, MODSSL_PCHAR_CAST mctx->auth.ca_cert_file, MODSSL_PCHAR_CAST mctx->auth.ca_cert_path)) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to configure verify locations " "for client authentication"); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } if (mctx->pks && (mctx->pks->ca_name_file || mctx->pks->ca_name_path)) { ca_list = ssl_init_FindCAList(s, ptemp, mctx->pks->ca_name_file, mctx->pks->ca_name_path); } else ca_list = ssl_init_FindCAList(s, ptemp, mctx->auth.ca_cert_file, mctx->auth.ca_cert_path); if (!ca_list) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to determine list of acceptable " "CA certificates for client authentication"); ssl_die(); } SSL_CTX_set_client_CA_list(ctx, (STACK *)ca_list); } /* * Give a warning when no CAs were configured but client authentication * should take place. This cannot work. */ if (mctx->auth.verify_mode == SSL_CVERIFY_REQUIRE) { ca_list = (STACK_OF(X509_NAME) *)SSL_CTX_get_client_CA_list(ctx); if (sk_X509_NAME_num(ca_list) == 0) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, s, "Init: Oops, you want to request client " "authentication, but no CAs are known for " "verification!? [Hint: SSLCACertificate*]"); } } } static void ssl_init_ctx_cipher_suite(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { SSL_CTX *ctx = mctx->ssl_ctx; const char *suite = mctx->auth.cipher_suite; /* * Configure SSL Cipher Suite */ if (!suite) { return; } ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Configuring permitted SSL ciphers [%s]", suite); if (!SSL_CTX_set_cipher_list(ctx, MODSSL_PCHAR_CAST suite)) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to configure permitted SSL ciphers"); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } } static void ssl_init_ctx_crl(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { /* * Configure Certificate Revocation List (CRL) Details */ if (!(mctx->crl_file || mctx->crl_path)) { return; } ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Configuring certificate revocation facility"); mctx->crl = SSL_X509_STORE_create((char *)mctx->crl_file, (char *)mctx->crl_path); if (!mctx->crl) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to configure X.509 CRL storage " "for certificate revocation"); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } } static void ssl_init_ctx_cert_chain(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { BOOL skip_first = FALSE; int i, n; const char *chain = mctx->cert_chain; /* * Optionally configure extra server certificate chain certificates. * This is usually done by OpenSSL automatically when one of the * server cert issuers are found under SSLCACertificatePath or in * SSLCACertificateFile. But because these are intended for client * authentication it can conflict. For instance when you use a * Global ID server certificate you've to send out the intermediate * CA certificate, too. When you would just configure this with * SSLCACertificateFile and also use client authentication mod_ssl * would accept all clients also issued by this CA. Obviously this * isn't what we want in this situation. So this feature here exists * to allow one to explicity configure CA certificates which are * used only for the server certificate chain. */ if (!chain) { return; } for (i = 0; (i < SSL_AIDX_MAX) && mctx->pks->cert_files[i]; i++) { if (strEQ(mctx->pks->cert_files[i], chain)) { skip_first = TRUE; break; } } n = SSL_CTX_use_certificate_chain(mctx->ssl_ctx, (char *)chain, skip_first, NULL); if (n < 0) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Failed to configure CA certificate chain!"); ssl_die(); } ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Configuring server certificate chain " "(%d CA certificate%s)", n, n == 1 ? "" : "s"); } static void ssl_init_ctx(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { ssl_init_ctx_protocol(s, p, ptemp, mctx); ssl_init_ctx_session_cache(s, p, ptemp, mctx); ssl_init_ctx_callbacks(s, p, ptemp, mctx); ssl_init_ctx_verify(s, p, ptemp, mctx); ssl_init_ctx_cipher_suite(s, p, ptemp, mctx); ssl_init_ctx_crl(s, p, ptemp, mctx); if (mctx->pks) { /* XXX: proxy support? */ ssl_init_ctx_cert_chain(s, p, ptemp, mctx); } } static int ssl_server_import_cert(server_rec *s, modssl_ctx_t *mctx, const char *id, int idx) { SSLModConfigRec *mc = myModConfig(s); ssl_asn1_t *asn1; MODSSL_D2I_X509_CONST unsigned char *ptr; const char *type = ssl_asn1_keystr(idx); X509 *cert; if (!(asn1 = ssl_asn1_table_get(mc->tPublicCert, id))) { return FALSE; } ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Configuring %s server certificate", type); ptr = asn1->cpData; if (!(cert = d2i_X509(NULL, &ptr, asn1->nData))) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to import %s server certificate", type); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } if (SSL_CTX_use_certificate(mctx->ssl_ctx, cert) <= 0) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to configure %s server certificate", type); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } mctx->pks->certs[idx] = cert; return TRUE; } static int ssl_server_import_key(server_rec *s, modssl_ctx_t *mctx, const char *id, int idx) { SSLModConfigRec *mc = myModConfig(s); ssl_asn1_t *asn1; MODSSL_D2I_PrivateKey_CONST unsigned char *ptr; const char *type = ssl_asn1_keystr(idx); int pkey_type = (idx == SSL_AIDX_RSA) ? EVP_PKEY_RSA : EVP_PKEY_DSA; EVP_PKEY *pkey; if (!(asn1 = ssl_asn1_table_get(mc->tPrivateKey, id))) { return FALSE; } ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "Configuring %s server private key", type); ptr = asn1->cpData; if (!(pkey = d2i_PrivateKey(pkey_type, NULL, &ptr, asn1->nData))) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to import %s server private key", type); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } if (SSL_CTX_use_PrivateKey(mctx->ssl_ctx, pkey) <= 0) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Unable to configure %s server private key", type); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); ssl_die(); } /* * XXX: wonder if this is still needed, this is old todo doc. * (see http://www.psy.uq.edu.au/~ftp/Crypto/ssleay/TODO.html) */ if ((pkey_type == EVP_PKEY_DSA) && mctx->pks->certs[idx]) { EVP_PKEY *pubkey = X509_get_pubkey(mctx->pks->certs[idx]); if (pubkey && EVP_PKEY_missing_parameters(pubkey)) { EVP_PKEY_copy_parameters(pubkey, pkey); ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Copying DSA parameters from private key to certificate"); ssl_log_ssl_error(APLOG_MARK, APLOG_ERR, s); EVP_PKEY_free(pubkey); } } mctx->pks->keys[idx] = pkey; return TRUE; } static void ssl_check_public_cert(server_rec *s, apr_pool_t *ptemp, X509 *cert, int type) { int is_ca, pathlen; char *cn; if (!cert) { return; } /* * Some information about the certificate(s) */ if (SSL_X509_isSGC(cert)) { ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "%s server certificate enables " "Server Gated Cryptography (SGC)", ssl_asn1_keystr(type)); } if (SSL_X509_getBC(cert, &is_ca, &pathlen)) { if (is_ca) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, s, "%s server certificate is a CA certificate " "(BasicConstraints: CA == TRUE !?)", ssl_asn1_keystr(type)); } if (pathlen > 0) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, s, "%s server certificate is not a leaf certificate " "(BasicConstraints: pathlen == %d > 0 !?)", ssl_asn1_keystr(type), pathlen); } } if (SSL_X509_getCN(ptemp, cert, &cn)) { int fnm_flags = APR_FNM_PERIOD|APR_FNM_CASE_BLIND; if (apr_fnmatch_test(cn)) { if (apr_fnmatch(cn, s->server_hostname, fnm_flags) == APR_FNM_NOMATCH) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, s, "%s server certificate wildcard CommonName " "(CN) `%s' does NOT match server name!?", ssl_asn1_keystr(type), cn); } } else if (strNE(s->server_hostname, cn)) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, s, "%s server certificate CommonName (CN) `%s' " "does NOT match server name!?", ssl_asn1_keystr(type), cn); } } } static void ssl_init_server_certs(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { const char *rsa_id, *dsa_id; const char *vhost_id = mctx->sc->vhost_id; int i; int have_rsa, have_dsa; rsa_id = ssl_asn1_table_keyfmt(ptemp, vhost_id, SSL_AIDX_RSA); dsa_id = ssl_asn1_table_keyfmt(ptemp, vhost_id, SSL_AIDX_DSA); have_rsa = ssl_server_import_cert(s, mctx, rsa_id, SSL_AIDX_RSA); have_dsa = ssl_server_import_cert(s, mctx, dsa_id, SSL_AIDX_DSA); if (!(have_rsa || have_dsa)) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Oops, no RSA or DSA server certificate found " "for '%s:%d'?!", s->server_hostname, s->port); ssl_die(); } for (i = 0; i < SSL_AIDX_MAX; i++) { ssl_check_public_cert(s, ptemp, mctx->pks->certs[i], i); } have_rsa = ssl_server_import_key(s, mctx, rsa_id, SSL_AIDX_RSA); have_dsa = ssl_server_import_key(s, mctx, dsa_id, SSL_AIDX_DSA); if (!(have_rsa || have_dsa)) { ap_log_error(APLOG_MARK, APLOG_ERR, 0, s, "Oops, no RSA or DSA server private key found?!"); ssl_die(); } } static void ssl_init_proxy_certs(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, modssl_ctx_t *mctx) { int n, ncerts = 0; STACK_OF(X509_INFO) *sk; modssl_pk_proxy_t *pkp = mctx->pkp; SSL_CTX_set_client_cert_cb(mctx->ssl_ctx, ssl_callback_proxy_cert); if (!(pkp->cert_file || pkp->cert_path)) { return; } sk = sk_X509_INFO_new_null(); if (pkp->cert_file) { SSL_X509_INFO_load_file(ptemp, sk, pkp->cert_file); } if (pkp->cert_path) { SSL_X509_INFO_load_path(ptemp, sk, pkp->cert_path); } if ((ncerts = sk_X509_INFO_num(sk)) <= 0) { sk_X509_INFO_free(sk); ap_log_error(APLOG_MARK, APLOG_WARNING, 0, s, "no client certs found for SSL proxy"); return; } /* Check that all client certs have got certificates and private * keys. */ for (n = 0; n < ncerts; n++) { X509_INFO *inf = sk_X509_INFO_value(sk, n); if (!inf->x509 || !inf->x_pkey) { sk_X509_INFO_free(sk); ap_log_error(APLOG_MARK, APLOG_STARTUP, 0, s, "incomplete client cert configured for SSL proxy " "(missing or encrypted private key?)"); ssl_die(); return; } } ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "loaded %d client certs for SSL proxy", ncerts); pkp->certs = sk; } static void ssl_init_proxy_ctx(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, SSLSrvConfigRec *sc) { ssl_init_ctx(s, p, ptemp, sc->proxy); ssl_init_proxy_certs(s, p, ptemp, sc->proxy); } static void ssl_init_server_ctx(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, SSLSrvConfigRec *sc) { ssl_init_server_check(s, p, ptemp, sc->server); ssl_init_ctx(s, p, ptemp, sc->server); ssl_init_server_certs(s, p, ptemp, sc->server); } /* * Configure a particular server */ void ssl_init_ConfigureServer(server_rec *s, apr_pool_t *p, apr_pool_t *ptemp, SSLSrvConfigRec *sc) { /* Initialize the server if SSL is enabled or optional. */ if ((sc->enabled == SSL_ENABLED_TRUE) || (sc->enabled == SSL_ENABLED_OPTIONAL)) { ap_log_error(APLOG_MARK, APLOG_INFO, 0, s, "Configuring server for SSL protocol"); ssl_init_server_ctx(s, p, ptemp, sc); } if (sc->proxy_enabled) { ssl_init_proxy_ctx(s, p, ptemp, sc); } } void ssl_init_CheckServers(server_rec *base_server, apr_pool_t *p) { server_rec *s, *ps; SSLSrvConfigRec *sc; apr_hash_t *table; const char *key; apr_ssize_t klen; BOOL conflict = FALSE; /* * Give out warnings when a server has HTTPS configured * for the HTTP port or vice versa */ for (s = base_server; s; s = s->next) { sc = mySrvConfig(s); if ((sc->enabled == SSL_ENABLED_TRUE) && (s->port == DEFAULT_HTTP_PORT)) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, base_server, "Init: (%s) You configured HTTPS(%d) " "on the standard HTTP(%d) port!", ssl_util_vhostid(p, s), DEFAULT_HTTPS_PORT, DEFAULT_HTTP_PORT); } if ((sc->enabled == SSL_ENABLED_FALSE) && (s->port == DEFAULT_HTTPS_PORT)) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, base_server, "Init: (%s) You configured HTTP(%d) " "on the standard HTTPS(%d) port!", ssl_util_vhostid(p, s), DEFAULT_HTTP_PORT, DEFAULT_HTTPS_PORT); } } /* * Give out warnings when more than one SSL-aware virtual server uses the * same IP:port. This doesn't work because mod_ssl then will always use * just the certificate/keys of one virtual host (which one cannot be said * easily - but that doesn't matter here). */ table = apr_hash_make(p); for (s = base_server; s; s = s->next) { char *addr; sc = mySrvConfig(s); if (!((sc->enabled == SSL_ENABLED_TRUE) && s->addrs)) { continue; } apr_sockaddr_ip_get(&addr, s->addrs->host_addr); key = apr_psprintf(p, "%s:%u", addr, s->addrs->host_port); klen = strlen(key); if ((ps = (server_rec *)apr_hash_get(table, key, klen))) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, base_server, "Init: SSL server IP/port conflict: " "%s (%s:%d) vs. %s (%s:%d)", ssl_util_vhostid(p, s), (s->defn_name ? s->defn_name : "unknown"), s->defn_line_number, ssl_util_vhostid(p, ps), (ps->defn_name ? ps->defn_name : "unknown"), ps->defn_line_number); conflict = TRUE; continue; } apr_hash_set(table, key, klen, s); } if (conflict) { ap_log_error(APLOG_MARK, APLOG_WARNING, 0, base_server, "Init: You should not use name-based " "virtual hosts in conjunction with SSL!!"); } } #ifdef SSLC_VERSION_NUMBER static int ssl_init_FindCAList_X509NameCmp(char **a, char **b) { return(X509_NAME_cmp((void*)*a, (void*)*b)); } #else static int ssl_init_FindCAList_X509NameCmp(X509_NAME **a, X509_NAME **b) { return(X509_NAME_cmp(*a, *b)); } #endif static void ssl_init_PushCAList(STACK_OF(X509_NAME) *ca_list, server_rec *s, const char *file) { int n; STACK_OF(X509_NAME) *sk; sk = (STACK_OF(X509_NAME) *) SSL_load_client_CA_file(MODSSL_PCHAR_CAST file); if (!sk) { return; } for (n = 0; n < sk_X509_NAME_num(sk); n++) { char name_buf[256]; X509_NAME *name = sk_X509_NAME_value(sk, n); ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, s, "CA certificate: %s", X509_NAME_oneline(name, name_buf, sizeof(name_buf))); /* * note that SSL_load_client_CA_file() checks for duplicates, * but since we call it multiple times when reading a directory * we must also check for duplicates ourselves. */ if (sk_X509_NAME_find(ca_list, name) < 0) { /* this will be freed when ca_list is */ sk_X509_NAME_push(ca_list, name); } else { /* need to free this ourselves, else it will leak */ X509_NAME_free(name); } } sk_X509_NAME_free(sk); } STACK_OF(X509_NAME) *ssl_init_FindCAList(server_rec *s, apr_pool_t *ptemp, const char *ca_file, const char *ca_path) { STACK_OF(X509_NAME) *ca_list; /* * Start with a empty stack/list where new * entries get added in sorted order. */ ca_list = sk_X509_NAME_new(ssl_init_FindCAList_X509NameCmp); /* * Process CA certificate bundle file */ if (ca_file) { ssl_init_PushCAList(ca_list, s, ca_file); } /* * Process CA certificate path files */ if (ca_path) { apr_dir_t *dir; apr_finfo_t direntry; apr_int32_t finfo_flags = APR_FINFO_TYPE|APR_FINFO_NAME; apr_status_t rv; if ((rv = apr_dir_open(&dir, ca_path, ptemp)) != APR_SUCCESS) { ap_log_error(APLOG_MARK, APLOG_ERR, rv, s, "Failed to open Certificate Path `%s'", ca_path); ssl_die(); } while ((apr_dir_read(&direntry, finfo_flags, dir)) == APR_SUCCESS) { const char *file; if (direntry.filetype == APR_DIR) { continue; /* don't try to load directories */ } file = apr_pstrcat(ptemp, ca_path, "/", direntry.name, NULL); ssl_init_PushCAList(ca_list, s, file); } apr_dir_close(dir); } /* * Cleanup */ sk_X509_NAME_set_cmp_func(ca_list, NULL); return ca_list; } void ssl_init_Child(apr_pool_t *p, server_rec *s) { SSLModConfigRec *mc = myModConfig(s); mc->pid = getpid(); /* only call getpid() once per-process */ /* XXX: there should be an ap_srand() function */ srand((unsigned int)time(NULL)); /* open the mutex lockfile */ ssl_mutex_reinit(s, p); } #define MODSSL_CFG_ITEM_FREE(func, item) \ if (item) { \ func(item); \ item = NULL; \ } static void ssl_init_ctx_cleanup(modssl_ctx_t *mctx) { MODSSL_CFG_ITEM_FREE(X509_STORE_free, mctx->crl); MODSSL_CFG_ITEM_FREE(SSL_CTX_free, mctx->ssl_ctx); } static void ssl_init_ctx_cleanup_proxy(modssl_ctx_t *mctx) { ssl_init_ctx_cleanup(mctx); if (mctx->pkp->certs) { sk_X509_INFO_pop_free(mctx->pkp->certs, X509_INFO_free); } } static void ssl_init_ctx_cleanup_server(modssl_ctx_t *mctx) { int i; ssl_init_ctx_cleanup(mctx); for (i=0; i < SSL_AIDX_MAX; i++) { MODSSL_CFG_ITEM_FREE(X509_free, mctx->pks->certs[i]); MODSSL_CFG_ITEM_FREE(EVP_PKEY_free, mctx->pks->keys[i]); } } apr_status_t ssl_init_ModuleKill(void *data) { SSLSrvConfigRec *sc; server_rec *base_server = (server_rec *)data; server_rec *s; /* * Drop the session cache and mutex */ ssl_scache_kill(base_server); /* * Destroy the temporary keys and params */ ssl_tmp_keys_free(base_server); /* * Free the non-pool allocated structures * in the per-server configurations */ for (s = base_server; s; s = s->next) { sc = mySrvConfig(s); ssl_init_ctx_cleanup_proxy(sc->proxy); ssl_init_ctx_cleanup_server(sc->server); } return APR_SUCCESS; }
.htaccess Tutorial
Find information you are looking for on the AskApache Home Page.