Dvoituron.Tools.AzureLetsEncrypt 1.4.0

.NET Core 2.1
dotnet tool install --global Dvoituron.Tools.AzureLetsEncrypt --version 1.4.0
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local Dvoituron.Tools.AzureLetsEncrypt --version 1.4.0
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Dvoituron.Tools.AzureLetsEncrypt&version=1.4.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
nuke :add-package Dvoituron.Tools.AzureLetsEncrypt --version 1.4.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

AzureLetsEncrypt

Simple tool to add a Let's Encrypt SSL certificate to your websites. This application is a .NET Core tool that generates an SSL certificate, validated it with LetsEncrypt.

2 minutes of a live demo: https://youtu.be/OCKpC1W4Wks

Steps to generate and to validate a certificate

Prerequisite: you must have a website accessible from your domain name (in http). Indeed, the validation of LetsEncrypt tries to check the presence of a file available in your website.

  1. Go to Azure portal, navigate to your Advanced Tools (Kudu environment). And select Debug console / CMD.

  2. Install this tool, using this command from the folder D:\home\site.

     dotnet tool install dvoituron.tools.azureletsencrypt --tool-path tools
    
  3. Run this command, using your domains and password.

     .\tools\AzureLetsEncrypt --domains=mydomain.com,www.mydomain.com --password=MyPassword
    
  4. You can download your validated Pfx certificate from the subfolder ./store of your website.

  5. In the Azure portal, go to SSL settings panel, to upload your Pfx.

    • Private certificate: upload your Pfx file (using your password)
    • Bindings: Add a SSL Binding using a SNI based

When to renew the certificate?

LetsEncrypt's certificates expire after 90 days. This is an obligation imposed by LetsEncrypt. So, you need to reproduce these steps, each 3 months.

More about this project

The detailled steps to create a SSL certificate and validate it with the Let’s Encrypt Certificate Authority are described on my blog. This tool automates these steps.

If you want generate and publish automatically your certificate, see https://github.com/dvoituron/AzureLetsEncrypt

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
1.4.0 561 12/4/2019
1.3.0 431 6/12/2019