How to run 'dotnet dev-certs https --trust'?
asp.netUbuntuasp.net CoreHttpsasp.net Problem Overview
I'm new in ASP.NET.
Environment:
-
Ubuntu 18.04
-
Visual Studio Code
-
.NET SDK 2.2.105
I'm in trouble with some command running.
I was reading tutorial at
and ran this command:
dotnet dev-certs https --trust
I expect https://localhost should be trusted. but I found the error message;
$ Specify --help for a list of available options and commands.
It seems that the command "dotnet dev-certs https" has no --trust options. How to resolve this problem?
asp.net Solutions
Solution 1 - asp.net
On Ubuntu the standard mechanism would be:
dotnet dev-certs https -v
to generate a self-signed cert- convert the generated cert in ~/.dotnet/corefx/cryptography/x509stores/my from pfx to pem using
openssl pkcs12 -in <certname>.pfx -nokeys -out localhost.crt -nodes
- copy
localhost.crt
to/usr/local/share/ca-certificates
- trust the certificate using
sudo update-ca-certificates
- verify if the cert is copied to
/etc/ssl/certs/localhost.pem
(extension changes) - verify if it's trusted using
openssl verify localhost.crt
Unfortunately this does not work:
dotnet dev-certs https
generates certificates that are affected by the issue described on https://github.com/openssl/openssl/issues/1418 and https://github.com/dotnet/aspnetcore/issues/7246:
$ openssl verify localhost.crt
CN = localhost
error 20 at 0 depth lookup: unable to get local issuer certificate
error localhost.crt: verification failed
- due to that it's impossible to have a dotnet client trust the certificate
Workaround: (tested on Openssl 1.1.1c)
- manually generate self-signed cert
- trust this cert
- force your application to use this cert
In detail:
- manually generate self-signed cert:
- create localhost.conf file with the following content:
[req]
default_bits = 2048
default_keyfile = localhost.key
distinguished_name = req_distinguished_name
req_extensions = req_ext
x509_extensions = v3_ca
[req_distinguished_name]
commonName = Common Name (e.g. server FQDN or YOUR name)
commonName_default = localhost
commonName_max = 64
[req_ext]
subjectAltName = @alt_names
[v3_ca]
subjectAltName = @alt_names
basicConstraints = critical, CA:false
keyUsage = keyCertSign, cRLSign, digitalSignature,keyEncipherment
[alt_names]
DNS.1 = localhost
DNS.2 = 127.0.0.1
- generate cert using
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout localhost.key -out localhost.crt -config localhost.conf
- convert cert to pfx using
openssl pkcs12 -export -out localhost.pfx -inkey localhost.key -in localhost.crt
- (optionally) verify cert using
openssl verify -CAfile localhost.crt localhost.crt
which should yieldlocalhost.crt: OK
- as it's not trusted yet using
openssl verify localhost.crt
should fail with
CN = localhost
error 18 at 0 depth lookup: self signed certificate
error localhost.crt: verification failed
- trust this cert:
- copy localhost.crt to
/usr/local/share/ca-certificates
- trust the certificate using
sudo update-ca-certificates
- verify if the cert is copied to
/etc/ssl/certs/localhost.pem
(extension changes) - verifying the cert without the CAfile option should work now
$ openssl verify localhost.crt
localhost.crt: OK
- force your application to use this cert
- update your appsettings.json with the following settings:
"Kestrel": {
"Certificates": {
"Default": {
"Path": "localhost.pfx",
"Password": ""
}
}
}
Solution 2 - asp.net
While the answer provided by @chrsvdb is helpful it does not solve all problems. I still had issue with service-to-service communication (HttpClient - PartialChain error) and also you must reconfigure Kestrel to use your own certificate. It is possible to create a self-signed certificate and import it to the .NET SDK. All you need is to specify the 1.3.6.1.4.1.311.84.1.1
extension in the certificate.
After that the cert can be imported into .NET Core SDK and trusted. Trusting in Linux is a bit hard as each application can have it's own certificate store. E.g. Chromium and Edge use nssdb which can be configured with certutil
as described John Duffy. Unfortunately the location to the nssdb maybe different when you install application as snap. Then each application has its own database. E.g. for Chromium Snap the path will be $HOME/snap/chromium/current/.pki/nssdb
, for Postman Snap the will be $HOME/snap/postman/current/.pki/nssdb and so on.
Therefor I have created a script which generates the cert, trusts it for Postman Snap, Chmromium Snap, current user nssdb and on system level. It also imports the script into the .NET SDK so it will be used by ASP.NET Core without changing the configuration. You can find more informations about the script in my blog post https://blog.wille-zone.de/post/aspnetcore-devcert-for-ubuntu
Solution 3 - asp.net
In adition to crisvdb answer, I've several information to add and is the continuation of the walktrough. I don't comment because is pretty complex comment this, but before this answer take a look to crisvdb answer first and then return to continue.
Take the "in detail" crisdb answer.
- You can make your cert in any folder, can be or can't be in the same folder of the app.
- Take
openssl verify -CAfile localhost.crt localhost.crt
as not optional step, mandatory. It will help. - Do not recompile or touch the code meanwhile you are doing this, in order to get first scenario clean.
- If you run
sudo update-ca-certificates
that will answer you in wich folder the certified should be copied. - In some distributions, as Raspbian for Raspberry Pi, CA certificates are located in
/etc/ssl/certs
as well as/usr/share/ca-certificates/
and in some cases/usr/local/share/certificates
. - Do not copy the cert manually to trusted certs, run
sudo update-ca-certificates
after you copy the cert in the right folder. If it doesn't work (doesn't update or add any certificate) copy it to every folder possible. - If you use a password while making the certificate, you should use it in the
appsettings.json
- If you get this error:
> Interop+Crypto+OpenSslCryptographicException: error:2006D002:BIO > routines:BIO_new_file:system lib
Take in consideration that error means "access denied". It can be because you don't have permissions or related.
7b) Could be also that the file is not found, I use the entire path in the config:
"Path": "/home/user/www/myfolder1/myapp/localhost.pfx",
8) After that, and if everything works, you could see a 500 error if you are using Apache or Apache2.
If you get the following error in the apache logs of the site:
> [ssl:error] [remote ::1:yourport] AH01961: SSL Proxy requested for > yoursite.com:443 but not enabled [Hint: SSLProxyEngine] [proxy:error] > AH00961: HTTPS: failed to enable ssl support for [::1]:yourport > (localhost)
you must set in the VirtualHost the following configuration after SSLEngine On
and before your ProxyPass
SSLProxyEngine on
9) After that, and if everything works, you could see a 500 error if you are using Apache or Apache2.
If you get the following error in the apache logs of the site:
> [proxy:error] [client x.x.x.x:port] AH00898: Error during SSL > Handshake with remote server returned by / > [proxy_http:error] [client x.x.x.x:port] AH01097: pass request body failed to [::1]:port > (localhost) from x.x.x.x()
you must set in the VirtualHost the following configuration after SSLProxyEngine on
and before your ProxyPass
SSLProxyVerify none
SSLProxyCheckPeerCN off
SSLProxyCheckPeerName off
UPDATE
If you are renovating this, and using the same names, take in consideration that you should remove your pem
file from etc/ssl/certs
UPDATE 2
If it returns:
> Unhandled exception. Interop+Crypto+OpenSslCryptographicException: error:2006D002:BIO routines:BIO_new_file:system lib
Check that your pfx file is on 755 permissions.
If appsettings.json
seems to be don't load (on port 5000 by default or SQL or any configuration doesn't load or can't be read), take in consideration that the dotnet must be executed on the same directory where is appsettings.json
Solution 4 - asp.net
Looks like this is a known issue with dotnet global tools and that specific command is only available for MacOS and Windows. See this issue on github: Issue 6066.
It seems like there may be a work around for Linux users based on this SO post: https://stackoverflow.com/questions/52227372/asp-net-core-application-service-only-listening-to-port-5000-on-ubuntu.
Solution 5 - asp.net
For Chrome:
- Click "Not Secure" in address bar.
- Click Certificate.
- Click Details.
- Click Export.
Run: certutil -d sql:$HOME/.pki/nssdb -A -t "P,," -n {FILE_NAME} -i {FILE_NAME}
Restart Chrome.