204

I've gone through the steps detailed in How do you use https / SSL on localhost? but this sets up a self-signed cert for my machine name, and when browsing it via https://localhost I receive the IE warning.

Is there a way to create a self-signed cert for "localhost" to avoid this warning?

Community
  • 1
  • 1
chris
  • 36,094
  • 53
  • 157
  • 237
  • Did you install the certificate as a CA? – vcsjones Nov 17 '11 at 15:45
  • I followed the process to install a self-signed cert into IIS under Win7. But that creates the cert for "mymachinename", and I need one for "localhost". – chris Nov 17 '11 at 16:04
  • 1
    Hi! Consider setting Auri's answer as the main answer as makecert is deprecated. Link to the answer: https://stackoverflow.com/a/44164653/1461602 – Tormod Haugene Jul 16 '17 at 21:28
  • described process for win/osx here https://alfilatov.com/posts/how-to-create-self-signed-certificate/ – Alex Filatov Jan 10 '21 at 00:50
  • 1
    For the googlers, please head up to https://stackoverflow.com/a/57511038/873282. TL;DR: Use [mkcert](https://github.com/FiloSottile/mkcert) for a good certificate and installation on your OS. – koppor Apr 08 '23 at 19:08

13 Answers13

171

Since this question is tagged with IIS and I can't find a good answer on how to get a trusted certificate I will give my 2 cents about it:

First use the command from @AuriRahimzadeh in PowerShell as administrator:

New-SelfSignedCertificate -DnsName "localhost" -CertStoreLocation "cert:\LocalMachine\My" -NotAfter (Get-Date).AddYears(100)

Added Valid to 100 years so that the cert for localhost hopefully does not expire. You can use -NotAfter (Get-Date).AddMonths(24) for 24 months if you want that instead or any other value.

This is good but the certificate is not trusted and will result in the following error. It is because it is not installed in Trusted Root Certification Authorities.

enter image description here

Solve this by starting mmc.exe.

Then go to:

File -> Add or Remove Snap-ins -> Certificates -> Add -> Computer account -> Local computer. Click Finish.

Expand the Personal folder and you will see your localhost certificate:

enter image description here

Copy the certificate into Trusted Root Certification Authorities - Certificates folder.

The final step is to open Internet Information Services (IIS) Manager or simply inetmgr.exe. From there go to your site, select Bindings... and Add... or Edit.... Set https and select your certificate from the drop down.

enter image description here

Your certificate is now trusted:

enter image description here

Ogglas
  • 62,132
  • 37
  • 328
  • 418
  • 14
    This should be the accepted answer! It works! If you messed around with the localhost and trusted certificate. Be sure to remove all of the old localhost certificates (via mmc console and IIS (top managed server) – Tuan Jinn Mar 19 '18 at 14:22
  • Thanks! There are so many SO answers and blog post on this topic, but very few talks about the certificate trust issues. Tip: Maybe you should explain why you don't use default SSL port 443? I guess it's because this port is often taken by some other process. – HoffZ Feb 04 '20 at 09:10
  • Really nice answer, and works well on IIS as 2020. Thanks a lot! – alessandrocb May 28 '20 at 17:50
  • 1
    As soon as I refresh the `Certificates` folder the certificate gets removed. – nathanjw Aug 12 '21 at 00:26
  • On windows 11 and without IIS, this nearly worked. I needed to export and then re-import the certificate before I could get Edge/Brave to recognise it. Restarts of machine or browser etc did not achieve that. Once export/delete/import was done on the trusted cert, it worked. – philw Oct 21 '21 at 11:42
  • @philw can you provide more detail on the export/delete/import? I upgraded to Windows 11 last week and since then I haven't been getting prompted for a CAC on my local application instance. I've tried creating new certs and adding them to the trusted root store as above, but that hasn't worked for me. – Levi Wallach Feb 14 '22 at 17:53
  • 3
    If you don't want repeat all of these steps after 1 year you can use the "-NotAfter" option to create a certificate that will expire some years further. For example: New-SelfSignedCertificate -DnsName "localhost" -CertStoreLocation "cert:\LocalMachine\My" -NotAfter "31/12/2199" – Luca Ritossa Aug 22 '22 at 12:02
  • I am getting `New-SelfSignedCertificate : CertEnroll::CX509Enrollment::_CreateRequest: Access is denied. 0x80070005 (WIN32: 5 ERROR_ACCESS_DENIED) At line:1 char:1 + New-SelfSignedCertificate -CertStoreLocation Cert:\LocalMachine\My -C ...` when I try to create a certificate – nickornotto Dec 12 '22 at 20:57
  • I run in admin mode and it worked but I am getting 0x80070520 error on selecting the certificate in domain bindings. The error basically says that the certificate is corrupted. – nickornotto Dec 13 '22 at 11:10
105

Although this post is post is tagged for Windows, it is relevant question on OS X that I have not seen answers for elsewhere. Here are steps to create a self-signed cert for localhost on OS X:

# Use 'localhost' for the 'Common name'
openssl req -x509 -sha256 -nodes -newkey rsa:2048 -days 365 -keyout localhost.key -out localhost.crt

# Add the cert to your keychain
open localhost.crt

In Keychain Access, double-click on this new localhost cert. Expand the arrow next to "Trust" and choose to "Always trust". Chrome and Safari should now trust this cert. For example, if you want to use this cert with node.js:

var options = {
    key: fs.readFileSync('/path/to/localhost.key').toString(),
    cert: fs.readFileSync('/path/to/localhost.crt').toString(),
    ciphers: 'ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES256-SHA384',
    honorCipherOrder: true,
    secureProtocol: 'TLSv1_2_method'
};

var server = require('https').createServer(options, app);
styfle
  • 22,361
  • 27
  • 86
  • 128
Ben Flynn
  • 18,524
  • 20
  • 97
  • 142
  • 2
    The first command, `ssh-keygen`, is unnecessary as the openssl command is _also_ creating a new key (and overwriting the one created by ssh). – Félix Saparelli Jan 02 '16 at 23:45
  • @FélixSaparelli Totally right. Missed that somehow. Editing the answer. – Ben Flynn Jan 03 '16 at 03:23
  • 8
    Also you can automate the process completely by adding `-subj '/CN=localhost'` to the `openssl` arguments. – Félix Saparelli Jan 03 '16 at 07:16
  • 8
    To have OS X trust it from the command line instead of clicking around, you can do: `sudo security add-trusted-cert -p ssl -d -r trustRoot -k ~/Library/Keychains/login.keychain localhost.crt` – philfreo Apr 08 '16 at 00:50
  • 3
    Also relevant for linux. Thanks a lot. – Marcel Mar 09 '17 at 20:55
  • 1
    I followed all these steps and I'm getting a `ERR_SSL_VERSION_OR_CIPHER_MISMATCH` in Chrome 60 and Safari 10.1.2 doesn't like it either. – styfle Aug 05 '17 at 21:19
  • 1
    `Chrome: version 65` getting `Certificate presented to the app has different CN (common name) than the domain of the request` on my REST client. Does the common name need to include the port number? `localhost:8443` or is it `localhost` alone? – DJ2 Apr 13 '18 at 18:32
  • If the browser still does not accept the certificate, add to the `openssl` command the `-extension` and `-config` parameters as Arjun Kava wrote in his reply. – Ferdinand Prantl Apr 01 '22 at 12:53
61

You can use PowerShell to generate a self-signed certificate with the new-selfsignedcertificate cmdlet:

New-SelfSignedCertificate -DnsName "localhost" -CertStoreLocation "cert:\LocalMachine\My"

Note: makecert.exe is deprecated.

Cmdlet Reference: https://learn.microsoft.com/en-us/powershell/module/pki/new-selfsignedcertificate?view=windowsserver2022-ps

Matthew Steeples
  • 7,858
  • 4
  • 34
  • 49
Auri Rahimzadeh
  • 2,133
  • 15
  • 21
  • This should be the answer as of 2017. – Tormod Haugene Jul 16 '17 at 21:24
  • 1
    For those who follow and don't know how to go about installing the resultant cert, follow the steps in this video, it worked for me! https://www.youtube.com/watch?v=y4uKPUFmSZ0 – Eric Brown - Cal Aug 31 '17 at 13:49
  • 9
    where do the key and crt files get stored? – woojoo666 Apr 22 '18 at 06:50
  • 1
    @woojoo666 with `-KeyLocation` flag you can specify location. – hamid Nov 01 '19 at 16:07
  • 1
    This answer is useful, but incomplete, because the certificate won't be trusted. See the other answer about adding it as a trusted authority. – BurnsBA Aug 15 '20 at 23:56
  • 4
    New-SelfSignedCertificate -DnsName "localhost" -CertStoreLocation "cert:\LocalMachine\My" -KeyLocation "c:\users\mad\certs" generates no file in the specified directory. – Marc Aug 22 '20 at 08:54
46

After spending a good amount of time on this issue I found whenever I followed suggestions of using IIS to make a self signed certificate, I found that the Issued To and Issued by was not correct. SelfSSL.exe was the key to solving this problem. The following website not only provided a step by step approach to making self signed certificates, but also solved the Issued To and Issued by problem. Here is the best solution I found for making self signed certificates. If you'd prefer to see the same tutorial in video form click here.

A sample use of SelfSSL would look something like the following:

SelfSSL /N:CN=YourWebsite.com /V:1000 /S:2

SelfSSL /? will provide a list of parameters with explanation.

Hashim Aziz
  • 4,074
  • 5
  • 38
  • 68
23

If you are trying to create a self signed certificate that lets you go http://localhost/mysite Then here is a way to create it

makecert -r -n "CN=localhost" -b 01/01/2000 -e 01/01/2099 -eku 1.3.6.1.5.5.7.3.1 -sv localhost.pvk localhost.cer
cert2spc localhost.cer localhost.spc
pvk2pfx -pvk localhost.pvk -spc localhost.spc -pfx localhost.pfx

From http://social.msdn.microsoft.com/Forums/en-US/wcf/thread/32bc5a61-1f7b-4545-a514-a11652f11200

Scott Chamberlain
  • 124,994
  • 33
  • 282
  • 431
David Burela
  • 444
  • 3
  • 11
  • 2
    where did my certificate go :o its not in C:\Windows\system32 – EaterOfCode Sep 17 '12 at 19:37
  • 2
    By the way, the makecert.exe tool is used via the Visual Studio Command prompt for future readers. You could also use the the Internet Information Services (IIS) Resource Kit Tools and install SelfSSL 1.0. http://www.microsoft.com/downloads/en/details.aspx?FamilyID=56fc92ee-a71a-4c73-b628-ade629c89499&displaylang=en – atconway Oct 12 '12 at 19:12
  • 3
    While quick answers are great, they do not always help. "Certificate cannot be used as an SSL server certificate" is an error I see in IIS7. Op had also mentioned browser warnings & not "How do I create a cert"? – cmroanirgo Dec 15 '12 at 20:00
  • You can omit cert2spc step due parameter `pvk2pfx -spc` [accepts both](http://msdn.microsoft.com/en-us/library/windows/hardware/ff549703.aspx) .spc and .cer – abatishchev Jun 19 '13 at 06:39
  • 1
    the eku is for code signing, if you want a SSL cert you need to use the eku `1.3.6.1.5.5.7.3.1`. Persionally I do `-eku 1.3.6.1.5.5.7.3.1,1.3.6.1.5.5.7.3.2,1.3.6.1.5.5.7.3.3` which gives you Client Auth, Server Auth, and Code Signing. – Scott Chamberlain Feb 03 '14 at 14:56
  • 1
    @EaterOfCode Mine was in C:\Windows\SysWOW64 – jcs Jul 29 '15 at 19:09
  • According with https://learn.microsoft.com/en-us/windows/win32/seccrypto/makecert "MakeCert is deprecated. To create self-signed certificates, use the Powershell Cmdlet New-SelfSignedCertificate." I used the command `New-SelfSignedCertificate ` -CertStoreLocation Cert:\LocalMachine\My ` -DnsName "testdomain.local" -Verbose` from https://www.tutorialspoint.com/how-to-create-a-self-signed-certificate-using-powershell – berserck Apr 06 '22 at 13:41
10

I would recomment Pluralsight's tool for creating self-signed-certs: http://blog.pluralsight.com/selfcert-create-a-self-signed-certificate-interactively-gui-or-programmatically-in-net

Make your cert as a .pfx and import it into IIS. And add it as a trusted root cert authority.

cederlof
  • 7,206
  • 4
  • 45
  • 62
  • 1
    After flapping around with trying all kinds of PowerShell "magic" and other stuff that just didn't work - Pluralsight's tool generated a working script for me in 30 seconds flat, and that includes the time it took to eat the pizza (+ download and extract the tool, I mean). As I'm still running Windows 7 on this old laptop - this was the perfect solution for me, thanks! – Ade Dec 20 '19 at 08:25
5

Fastest Way to generate localhost certificate.

openssl req -x509 -out localhost.crt -keyout localhost.key \
  -newkey rsa:2048 -nodes -sha256 \
  -subj '/CN=localhost' -extensions EXT -config <( \
   printf "[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth")
Arjun Kava
  • 5,303
  • 3
  • 20
  • 20
  • `At line:3 char:53 + -subj '/CN=localhost' -extensions EXT -config <( \ + ~ Missing closing ')' in expression.` Removing brackets doe snot work either – nickornotto Dec 13 '22 at 11:11
3

Yes and no. Self signed certificates result in that warning message because the certificate was not signed by a trusted Certificate Authority. There are a few options that you can consider to remove this warning on your local machine. See the highest ranked answers to this question for details:

What do I need to do to get Internet Explorer 8 to accept a self signed certificate?

Hope this helps!


EDIT:

Sorry, I wasn't initially aware that you were constrained to localhost. You can attempt to follow the directions on the the link below to "Generate a Self Signed Certificate with the Correct Common Name."

http://www.sslshopper.com/article-how-to-create-a-self-signed-certificate-in-iis-7.html

Community
  • 1
  • 1
Phil Klein
  • 7,344
  • 3
  • 30
  • 33
  • No, the warning message is there because the URL (https://localhost) doesn't match the cert name, which is issued under the machine name. If I switch to https://mymachinename then I don't get the error. Unfortunately, I have to use localhost and not machine name for reasons that don't affect the question. – chris Nov 17 '11 at 16:03
2

In a LAN (Local Area Network) we have a server computer, here named xhost running Windows 10, IIS is activated as WebServer. We must access this computer via Browser like Google Chrome not only from localhost through https://localhost/ from server itsself, but also from other hosts in the LAN with URL https://xhost/ :


https://localhost/
https://xhost/
https://xhost.local/
...

With this manner of accessing, we have not a fully-qualified domain name, but only local computer name xhost here.

Or from WAN:


https://dev.example.org/
...

You shall replace xhost by your real local computer name.

None of above solutions may satisfy us. After days of try, we have adopted the solution openssl.exe. We use 2 certificates - a CA (self certified Authority certificate) RootCA.crt and xhost.crt certified by the former. We use PowerShell.

1. Create and change to a safe directory:

cd C:\users\so\crt

2. Generate RootCA.pem, RootCA.key & RootCA.crt as self-certified Certification Authority:


openssl req -x509 -nodes -new -sha256 -days 10240 -newkey rsa:2048 -keyout RootCA.key -out RootCA.pem -subj "/C=ZA/CN=RootCA-CA"
openssl x509 -outform pem -in RootCA.pem -out RootCA.crt

3. make request for certification: xhost.key, xhost.csr:

C: Country
ST: State
L: locality (city)
O: Organization Name
Organization Unit
CN: Common Name

    

openssl req -new -nodes -newkey rsa:2048 -keyout xhost.key -out xhost.csr -subj "/C=ZA/ST=FREE STATE/L=Golden Gate Highlands National Park/O=WWF4ME/OU=xhost.home/CN=xhost.local"

4. get xhost.crt certified by RootCA.pem:


openssl x509 -req -sha256 -days 1024 -in xhost.csr -CA RootCA.pem -CAkey RootCA.key -CAcreateserial -extfile domains.ext -out xhost.crt

with extfile domains.ext file defining many secured ways of accessing the server website:

authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names
[alt_names]
DNS.1 = localhost
DNS.2 = xhost
DNS.3 = xhost.local
DNS.4 = dev.example.org
DNS.5 = 192.168.1.2

5. Make xhost.pfx PKCS #12,

combinig both private xhost.key and certificate xhost.crt, permitting to import into iis. This step asks for password, please let it empty by pressing [RETURN] key (without password):


openssl pkcs12 -export -out xhost.pfx -inkey xhost.key -in xhost.crt

6. import xhost.pfx in iis10

installed in xhost computer (here localhost). and Restart IIS service.

IIS10 Gestionnaire des services Internet (IIS) (%windir%\system32\inetsrv\InetMgr.exe)

enter image description here

enter image description here

7. Bind ssl with xhost.local certificate on port 443.

enter image description here

Restart IIS Service.

8. Import RootCA.crt into Trusted Root Certification Authorities

via Google Chrome in any computer that will access the website https://xhost/.

\Google Chrome/…/Settings /[Advanced]/Privacy and Security/Security/Manage certificates

Import RootCA.crt

enter image description here

The browser will show this valid certificate tree:


RootCA-CA
  |_____ xhost.local

enter image description here

No Certificate Error will appear through LAN, even through WAN by https://dev.example.org.

enter image description here

Here is the whole Powershell Script socrt.ps1 file to generate all required certificate files from the naught:


#
# Generate:
#   RootCA.pem, RootCA.key RootCA.crt
#
#   xhost.key xhost.csr xhost.crt
#   xhost.pfx
#
# created  15-EEC-2020
# modified 15-DEC-2020
#
#
# change to a safe directory:
#

cd C:\users\so\crt

#
# Generate RootCA.pem, RootCA.key & RootCA.crt as Certification Authority:
#
openssl req -x509 -nodes -new -sha256 -days 10240 -newkey rsa:2048 -keyout RootCA.key -out RootCA.pem -subj "/C=ZA/CN=RootCA-CA"
openssl x509 -outform pem -in RootCA.pem -out RootCA.crt

#
# get RootCA.pfx: permitting to import into iis10: not required.
#
#openssl pkcs12 -export -out RootCA.pfx -inkey RootCA.key -in RootCA.crt

#
# get xhost.key xhost.csr:
#   C: Country
#   ST: State
#   L: locality (city)
#   O: Organization Name
#   OU: Organization Unit
#   CN: Common Name
#
openssl req -new -nodes -newkey rsa:2048 -keyout xhost.key -out xhost.csr -subj "/C=ZA/ST=FREE STATE/L=Golden Gate Highlands National Park/O=WWF4ME/OU=xhost.home/CN=xhost.local"

#
# get xhost.crt certified by RootCA.pem:
# to show content:
#   openssl x509 -in xhost.crt -noout -text
#
openssl x509 -req -sha256 -days 1024 -in xhost.csr -CA RootCA.pem -CAkey RootCA.key -CAcreateserial -extfile domains.ext -out xhost.crt

#
# get xhost.pfx, permitting to import into iis:
#
openssl pkcs12 -export -out xhost.pfx -inkey xhost.key -in xhost.crt

#
# import xhost.pfx in iis10 installed in xhost computer (here localhost).
#

To install openSSL for Windows, please visit https://slproweb.com/products/Win32OpenSSL.html

jacouh
  • 8,473
  • 5
  • 32
  • 43
1

you could try mkcert.

macos: brew install mkcert

clark yu
  • 109
  • 3
  • 3
0

If you are using Visual Studio, there is an easy way to setup and enable SSL using IIS Express explained here

Amir Chatrbahr
  • 2,260
  • 21
  • 31
0

Here's what I did to get a valid certificate for localhost on Windows:

  1. Download mkcert executable (https://github.com/FiloSottile/mkcert/releases) and rename it to mkcert.exe
  2. Run "mkcert -install"
  3. Open Windows certificate manager (certmgr.msc)
  4. Right click on "Trusted Root Certification Authorities" -> Import
  5. Import Root cert (rootCA.pem) from C:\Users[username]\AppData\Local\mkcert\
  6. Create a *.p12 certificate for specified domain(s): "mkcert -pkcs12 [name1] [name2]"
  7. Rename *.p12 certificate into *.pfx
  8. In IIS -> Server Certificates -> Import (pfx) in "Personal" group [default password: "changeit"]
  9. Assign certificate to Default Web Site (binding -> https (443) -> modify -> SSL certificate)
Dharman
  • 30,962
  • 25
  • 85
  • 135
Niente0
  • 504
  • 3
  • 11
0

Solution for Windows 10

None of the above worked for me but this one:

1. Follow these steps

$cert = New-SelfSignedCertificate -Subject local.YourDomain -DnsName local.yourdomain.co.uk

then

Format-List -Property *

or steps under Creating A Certificate With a Single Subject here: https://adamtheautomator.com/new-selfsignedcertificate/

You can also try SAN (Creating A Subject Alternative Name (SAN) Certificate).

2. Open mmc

Open Windows search and type mmc

then follow these steps:

Open File > Add/Remove Snap-in, select Certificates and click Add. Select Computer account, click Next and then Finish.

3. Copy certificate from Personal to Trusted

Expand Personal under Certificates in mmc

Copy your new certificate from Personal to Trusted Root Certification Authorities

4. Select the new certificate for your domain binding in IIS

5. Restart the domain/ site

nickornotto
  • 1,946
  • 4
  • 36
  • 68