Overview

Note

This affects Windows based Plesk hosting only

If your free Letโ€™s Encrypt certificate is failing with a 400 or 403 error, it may be due to one of two ASP.NET based configuration conflicts. While Plesk sorts some of these automatically, because the web.config can override all settings thereโ€™s two scenarios where manual intervention is required.

You may seen an error similar to:

let's encrypt fails to issue or renew on plesk windows

Issue #1: Authorization token is not available

For existing Umbraco installations and similar ASP.NET applications which control access to all files and sub-directorectories, you may get an error similar to:

let's encrypt fails to issue or renew on plesk windows

The key part is โ€œauthorization token is not availableโ€, which indicates that the verification file for Letโ€™s Encrypt could not be read. If youโ€™re seeing a 403 error for a different message, this issue does not apply.


Issue #2: Old ASP routing code

The second scenario is where your web.config contains old ASP routing configuration, which is usually a legacy of an old site and/or server it was migrated from. If you expand the Letโ€™s Encrypt error, you may see further details such as:

let's encrypt fails to issue or renew on plesk windows

The key phrase youโ€™re looking for is:

acme-challenge.localhost

Issue #3: Umbraco Redirects

Version 7 and below of Umbraco have a separate configuration file for redirects, normally located in Config/UrlRewriting.config. Wildcard redirects within this file are also known to cause issues and may present as the same symptoms as Issue #2.

Fixes

Fix #1: Allow .well-known access

  1. Login to Plesk or via the Conetix Control Panel.
  2. Go to the site with the issue, then to File Manager:
    let's encrypt fails to issue or renew on plesk windows
  3. Within the web.config file, find the umbracoReservedPaths configuration line and set this to have a value of โ€œ~/umbraco,~/install/,~/.well-knownโ€œ. It should look similar to this:
    let's encrypt fails to issue or renew on plesk windows
  4. Next, find the staticContent section of the web.config file and insert:
    <remove fileExtension="." />
    <mimeMap fileExtension="." mimeType="text/plain" />
    This will ensure the right MIME type is served for the .well-known file used by Letโ€™s Encrypt. A working configuration should look like:
    let's encrypt fails to issue or renew on plesk windows
  5. Go back to SSL Certificates and re-issue the certificate.

Fix #2: Remove obsolete ASP routing code

  1. Login to Plesk or via the Conetix Control Panel.
  2. Go to the site with the issue, then to File Manager.
    let's encrypt fails to issue or renew on plesk windows
  3. Within the web.config, search for โ€œrunAllManagedModulesForAllRequestsโ€œ:
    let's encrypt fails to issue or renew on plesk windows
  4. If it contains a line like the example above, edit the line and remove โ€œrunAllManagedModulesForAllRequestsโ€ option from the module line. It should now look like:
    let's encrypt fails to issue or renew on plesk windows
  5. Go back to SSL Certificates and re-issue the certificate.

Fix #3: Remove wildcard redirects

  1. Login to Plesk or via the Conetix Control Panel.
  2. Go to the site with the issue, then to File Manager:
    let's encrypt fails to issue or renew on plesk windows
  3. Edit the Config/UrlRewriting.config and search for any wildcard redirects. They may look like:
    let's encrypt fails to issue or renew on plesk windows
  4. Remove and re-implement these either directly within Plesk or direct within the web.config file (if theyโ€™re still required).
  5. Go back to SSL Certificates and re-issue the certificate.

If youโ€™re experiencing a different issue or youโ€™ve followed the above and itโ€™s still not working, please donโ€™t hesitate to contact our support team who will assist further.

Was this article helpful?

Related Articles