In myprevious post, I discussed how to map a root domain or APEX domain with anAzure Functions instance. Let's bind an SSL certificate to the custom domain, which is generated byLet's Encrypt so that we can enable HTTPS connection through the custom domain.

Let's Encrypt

Let's Encrypt is a non-profit organisation that issues free SSL certificate. Although it's free, it's widely accepted and backed by many tech companies. There are a few limitations, though. It's valid only for three months. In other words, we MUST renew the SSL certificate issued by Let's Encrypt for every three months. But you know, we've got automation! So, don't worry about the certificate renewal as long as we've got the automation process for it.

Azure App Service Site Extension

Azure App Service provides the site extension feature. One of the extensions is theLet's Encrypt Site Extension. It's written as theAzure WebJob style so that the WebJob runs every three months to renew the certificate automatically. It's a pretty useful extension.

However, this extension has a few critical drawbacks as well.

• It only runs on Windows-based App Service instances (including Azure Functions) because WebJob basically relies on the Windows platform. No Linux-based App Service, unfortunately.
• It shares the runtime environment with the App Service instance. Therefore, whenever we deploy a new App Service instance, we MUST always deploy the extension and configure it.
• If we deploy an application with the "delete all files before deployment" option, the WebJob will get deleted.

It doesn't seem to be a way for production use. What else can we take to bind the SSL certificate for free?

Azure Functions App Only for SSL Certificate Management

We're lucky enough to haveShibayan who publishes an excellentAzure Function app that manages Let's Encrypt SSL Certificate with no dependency on the App Service instances. Through the application, we can quickly generate and renew as many SSL certificates as we can and store them toAzure Key Vault. The stored SSL certificates are directly bound to Azure Functions instances. How fantastic!

First of all, run the ARM template below to provision an Azure Functions app and Key Vault instance. But, if you like, you can write your own ARM template and run it.

The provisioned Azure Functions app instance got theManaged Identity feature enabled so the app can directly access to the Key Vault instance to store SSL certificates. Once all relevant resources are provisioned, follow the process below.

Let's say the Azure Functions app instance for the SSL certificate management ashttps://ssl-management.azurewebsites.net.

Authentication / Authorisation

The provisioned Azure Functions app includes an admin UI which is only accessible through authentication. Therefore, activate theAuthentiation / Authorisation feature like below:

Then, configure the Azure Active Directory for authentication. We use the account registered to Azure Active Directory. Set the management mode toExpress and put the app name. The default value of the app name is the Function app name. We don't need to change it.

Now, we got the Azure Functions app configured for SSL certificate management.

Azure DNS Configuration

I'm assuming that we useAzure DNS for domain management. Go to the resource group where the Azure DNS instance is provisioned and selectAccess control (IAM) blade, then assign a role to the Azure Functions app for SSL certificate management.

• Role: DNS Zone Contributor
• Assign access to: Function App
• Selected members: Azure Functions app for SSL certificate management. Only apps thatManaged Identity feature enabled appear here.

SSL Certificate Generation

Open a web browser and access to the admin UI for the SSL certificate management, by accessing tohttps://ssl-management.azurewebsites.net/add-certificate. If it's the first time for you to access, you'll be asked to log-in.

Once logged-in, the admin UI appears. For APEX domain, enter nothing to theRecord name field then click theAdd button. If you want to issue the certificate for subdomains, add the subdomain to theRecord name field. You can also issue one certificate for as many domains as you want. Here we generate one certificate for bothcnts.com anddev.cnts.com.

If you prefer to creating a separate certificate for each domain,cnts.com anddev.cnts.com, then run the registration twice.

Once completed, the pop-up appears like:

Let's go to theAzure Key Vault instance to check whether the SSL certificate has been generated or not.

SSL Certificate Binding to APEX Custom Domain on Azure Functions

We've got the custom APEX domain, mapped from theprevious post. Now, it's time to bind the certificate with the domain. Go to the Azure Functions instance that I want to attach the certificate and select theTLS/SSL settings blade. Click thePrivate Key Certificates (.pfx) tab thenImport Key Vault Certificate button to import the one stored in our Key Vault instance.

Once imported, you can see the screen below. As we generated one certificate for bothcnts.com anddev.cnts.com, it's normal to see both domain names.

Let's select theCustom domains blade. The domain is still not bound with the SSL certificate that we just imported. Click theAdd binding link, choosecnts.com for theCustom domain field,cnts.com,dev.cnts.com for thePrivate Certificate Thumbprint field. And finally, chooseSNI SSL for theTLS/SSL Type field.

Now we can see the SSL certificate is properly bound with the custom APEX domain.

So far, we've walked through howLet's Encrypt SSL certificate can be bound with a Custom APEX domain onAzure Functions instance. In the next post, I'll discuss how the inbound IP of the Azure Functions instance is automatically updated to the A Record ofAzure DNS.