Filesystem

Save verification files on (network) path

Plugin type HTTP validation
Download Built-in
Compatibility All platforms

Description

This plugin saves the validation challenge to a local or network path.

web.config

Optionally this plugin can place a web.config next to the validation file, to help IIS properly serve the response. There are many reasons why IIS can fail to properly serve the file. Some of them can be fixed this way. In interactive mode the program will ask you if you want to do this. In unattended mode you can request it using the command line. The web.config that will be copied lives in the root of the program directory with the name web_config.xml. You can modify it to fit your needs, e.g. for MVC sites you might need the following:

<configuration>
    <system.webServer>
        <staticContent>
            <clear/>
            <mimeMap fileExtension = ".*" mimeType="text/json" />
        </staticContent>
        <handlers>
            <clear />
            <add name="StaticFile" 
			path="*" 
			verb="*" 
			type="" 
			modules="StaticFileModule,
			         DefaultDocumentModule,
					 DirectoryListingModule" 
			scriptProcessor="" 
			resourceType="Either"
			requireAccess="Read" 
			allowPathInfo="false" 
			preCondition="" 
			responseBufferLimit="4194304" />
        </handlers>
    </system.webServer>
</configuration>

Or to disable URL Rewriting you might need to add this (in the beginning, right after <clear />).

<rule name="LetsEncrypt Rule" stopProcessing="true">
    <match url="^\.well-known.*$" />
    <action type="None" />
</rule>

Let us know if you could use a similar feature for uploading an .htaccess!

Command line

--validation filesystem Activates the plugin
‑‑validationsiteid Specify IIS site to use for handling validation requests. This will be used to choose the web root path.
‑‑webroot Root path of the site that will serve the HTTP validation requests.
‑‑manualtargetisiis Copy default web.config to the .well-known directory.

Examples

Path from IIS --validation filesystem ‑‑validationsiteid 1
Manual path --validation filesystem ‑‑webroot c:\httpdocs\

Settings

Validation.CleanupFolders If set to true, the program will automatically delete file it created after HTTP validation is complete. It will also cleanup the ./well-known/acme-challenge folder, if (and only if) there are no other files present.

Type: boolean
Default: true

JSON

ID 1c77b3a4-5310-4c46-92c6-00d866e84d6b

Settings

Validation.CleanupFolders If set to true, the program will automatically delete file it created after HTTP validation is complete. It will also cleanup the ./well-known/acme-challenge folder, if (and only if) there are no other files present.

Type: boolean
Default: true

Looking for win-acme?

simple-acme is a backwards compatible, drop-in replacement built by the same person. Project history.