Rubayat Hasan
Software Development, Music, Web Design, life, thoughts…
Setting up Apache HTTPS/SSL on Windows
I am assuming that you already have Apache2 installed and working on a Windows server.
For SSL/HTTPS to work you need to download and setup the Win32 Binary including OpenSSL "httpd/apache_x.x.x-win32-x86-openssl-x.x.x.msi" on your Windows server.
If you now have regular HTTP server working follow the guide below to setup HTTPS.
Setting up HTTPS on a Windows Server:
-
Creating a self-signed SSL Certificate using OpenSSL:
Open the command prompt and cd to your Apache installations "bin" directory. Usually it would be:
cd "C:Program FilesApache Software FoundationApache2.2in"
To create the SSL certificate we will need the openssl.cnf files location but the default location set by OpenSSL for this file is setup according to a Linux distribution, so we need to fix it for Windows.
We need to setup the Windows environment variable OPENSSL_CONF to point to the openssl.cnf files location. It is usually located in "C:Program FilesApache Software FoundationApache2.2confopenssl.cnf" directory.
So we can set it up by the following command or through the GUI interface:
set OPENSSL_CONF=C:Program FilesApache Software FoundationApache2.2confopenssl.cnf
All files generated from the following commands will reside in "C:Program FilesApache Software FoundationApache2.2in" folder.
Now that we have the environment variable set we need to create a new OpenSSL certificate request using the following command:
openssl req -new -out server.csr
It will ask you some questions and you can safely ignore them and just answer the following questions:
PEM pass phrase: Password associated with the private key you’regenerating (anything of your choice).
Common Name: The fully-qualified domain name associated with this certificate (i.e. www.your-domain.com).Now we need to remove the passphrase from the private key. The file"server.key" created from the following command should be only readable by the apache server and the administrator. You should also delete the .rnd file because it contains the entropy information for creating the key and could be used for cryptographic attacks against your private key.
openssl rsa -in privkey.pem -out server.key
Now we need to set up an expiry date, it could be any time of your choice, we use 365 days below:
openssl x509 -in server.csr -out server.cert -req -signkey server.key -days 365
We have the Self-signed SSL certificates ready now. Now We need to MOVE the "server.cert" and "server.key" file to the
"C:Program FilesApache Software FoundationApache2.2conf" location.
-
Configuring Apache to run SSL/HTTPS server:
Now that we have the Self-signed SSL certificate ready, all we need is to configure Apache to start the SSL server.
First we modify the "C:Program FilesApache Software FoundationApache2.2confhttpd.conf" file.
Open up confhttpd.conf in a text editor and look for the line:
LoadModule ssl_module modules/mod_ssl.so and remove any pound sign (#) characters preceding it.
Include conf/extra/httpd-ssl.conf and remove any pound sign (#) characters preceding it.
Now we need to modify the "C:Program FilesApache Software FoundationApache2.2confextrahttpd-ssl.conf". Let all the default options as it is but make sure to modify the following section according to your need:
<VirtualHost _default_:443>
ServerAdmin some@email.com
DocumentRoot "Your Root folder location"
ServerName www.domain.com:443
ServerAlias domain.com:443
ErrorLog "logs/anyFile-error.log"
CustomLog "logs/anyFile-access.log" common
SSLEngine onSSLCertificateFile "C:/Program Files/Apache Software Foundation/Apache2.2/conf/server.cert"
SSLCertificateKeyFile "C:/Program Files/Apache Software Foundation/Apache2.2/conf/server.key"
</VirtualHost>Make sure that "SSLCertificateFile" and "SSLCertificateKeyFile" are properly located.
For better organizing you can also put the whole <VirtualHost></VirtualHost> section in the "C:Program FilesApache Software FoundationApache2.2confextrahttpd-vhosts.conf" along with your other Virtual Host settings there but you need to uncomment “Include conf/extra/httpd-vhosts.conf” in your confhttpd.conf file to use that.
-
Opening SSL/HTTPS port on Windows:
Now we need to open an exception in Windows Firewall for TCP port 443. You can do that by going to “Windows Firewall” settings in Control Panel and adding a port in the exception section.
Well that was long and painful but but now Restart the server and everything should work fine.
Please feel free to leave comments if this guide helped.
Create Self-Signed CertificateC
Related posts:
- Guide to Running Apache on Windows or Ubuntu - After using IIS for almost 4 years now, I have...
December 18th, 2011 at 12:39 pm
hi,
please change:
openssl x509 -in server.csr -out server.crt -req -signkey server.key -days 365
instead
openssl x509 -in server.csr -out server.cert -req -signkey server.key -days 365
December 9th, 2011 at 12:16 am
[...] reference: http://rubayathasan.com/tutorial/apache-ssl-on-windows/?replytocom=46419#respond [...]
August 18th, 2011 at 1:42 pm
Really good guide. Thank you very much for posting this.
August 11th, 2011 at 3:40 am
where are the files located after this guide ? can’t find them.
July 28th, 2011 at 7:01 am
Today I have downloadedhttp://www.fightrice.com/mirrors/apache//httpd/binaries/win32/httpd-2.2.19-win32-x86-openssl-0.9.8r.msi file on Windows 2008 RC2 64-bit. Installed the file and Apache default web page on http is working fine.
Configuring all this settings and starting Apache Windows service and I get error: “Windows could not start the Apache2.2 on Local Computer. For more information, review the System Event Log. If this is a non-Microsoft service, contact the service vendor, and refer to service-specific error code 1.”
I have looked into System Event Log and there is message: “The Apache2.2 service terminated with service-specific error Incorrect function.”
I have looked at Apache log folder and there are no files in this folder (I have deleted all files from this log folder before starting Apache).
Any idea what could be wrong?
July 5th, 2011 at 3:56 am
Great tutorial. But I had to replace :
SSLCertificateFile “F:/Bin/Apache Software Foundation/Apache2.2/conf/server.crt”
by :
SSLCertificateFile “F:/Bin/Apache Software Foundation/Apache2.2/conf/server.cert”
(.cert instead of .crt) in httpd-ssl.conf to make it work.
July 1st, 2011 at 5:17 am
Many Thanks,
Your doku is very precise.
Only one detail:
In conf/extra/httpd-ssl.conf we have SSLMutex to sat to default like beneath.
SSLMutex default
June 15th, 2011 at 2:38 am
thnx a lot 4 ur kind info but the command “C:Program FilesApache Software FoundationApache2.2confopenssl.cnf” is not working…the command is saying that… the path is wrong..
June 15th, 2011 at 2:23 am
really,i was much confused before ur suggestion…thnx u.
May 26th, 2011 at 2:23 pm
Be aware on Win 64, you must uncomment the OTHER SSLSessionCache for things to work. The default SSLSessionCache setting will fail with a spurious “values must be > 8192)”
May 12th, 2011 at 7:27 am
Hi
Thanks a lot for the help on this especially on pointing to the openssl.cnf in command prompt.
I still have a big problem, after doing all this, I restart my server and it says: “The requested operation has failed”. Do note that Iinstalled the following file for Apache: httpd-2.2.17-win32-x86-openssl-0.9.8o.msi.
What can be the problem?
May 10th, 2011 at 3:24 pm
It’s been a bit of time, yet still your directions are great. I’ve just downloaded the WampServer, and was having the error “ordinal 924 could not be located in the dynamic link library LIBEAY32.dll” when trying to general the new certificate request. I replace the openssl.exe, libeay32.dll, and ssleay32.dll from an older version of PHP (i.e., version 5.2.17-Win32), and the command “magically” worked. (Think it may have to do with the setup -or lack thereof – of my machine.) From there on, it was clear sailing.
March 3rd, 2011 at 12:20 am
Rubayat,
This tutorial was immensely helpful. Thank you for writing it.
January 31st, 2011 at 2:12 pm
Great article! Thanks!
October 25th, 2010 at 1:19 am
instead of
“set OPENSSL_CONF=C:Program FilesApache Software FoundationApache2.2confopenssl.cnf”,
we can specify the configuration file location by using “openssl req –config openssl.conf –new –out ./sss/blarg.csr –keyout ./ssl/blarg.pem”.
and all is about generating certificate file and config httpd.conf to load the module and know where is the certificate. cheers.
October 9th, 2010 at 6:39 pm
Hi Rubayat…
I have a question here…. About the openssl.cnf file. We need to change all the directories in that file manually if we implement it in Windows?
October 11th, 2010 at 2:42 pm
Hi,
We are not changing anything in that file. All we are doing is setting Windows Environment Variable properly to point to that files location.
October 6th, 2010 at 10:18 pm
what i’ve missed?
after follow the steps, and i restart the apache
then i open http://www.my-website.com is still doing nothing!, only ‘the page cannot display’
please help me
October 25th, 2010 at 1:15 am
for this set up, you should test on https:// instead.
June 13th, 2010 at 5:51 pm
Thank you so much for getting me back on track. I think it was removing the passphrase that tripped me up!
April 29th, 2010 at 7:08 pm
Hi Rubiyat,
Is it possible to specify 2 server certificates for within tag. The server certificate on my proxy server is expiring and before it expires i need to install a new certificate. I was wondering whether it was possible to have 2 certificates for the same ip address and domain specified in the vHosts configuration.
Any help in this regard would be greatly appreciated.
April 30th, 2010 at 1:42 am
So you want to use 2 SSL certificate on one vHost configuration for one domain? Thats probably not going to work.
Logically there will be no way for the server to know which certificate is the one to serve for a particular domain.
Why can’t you just link the new certificate when the old one expires?
April 19th, 2010 at 7:28 pm
Great guide, Rubayat!