WebDav
Upload verification files via WebDav
Plugin type | HTTP validation | |
---|---|---|
Download | Built-in | |
Compatibility | All platforms |
Description
This plugin pushes the validation challenge to a WebDav 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 webdav |
Activates the plugin | |
---|---|---|
‑‑username |
Username for remote server | |
‑‑password |
Password for remote server
You may pass the secret in plain text, but can also use a reference to the secret vault like |
|
‑‑webroot |
Root path of the site that will serve the HTTP validation requests. | |
‑‑manualtargetisiis |
Copy default web.config to the .well-known directory. |
Examples
Typical | --validation webdav ‑‑webroot webdav://example.com/path/ ‑‑username simple-acme ‑‑password ***** |
---|
JSON
ID | 7e191d0e-30d1-47b3-ae2e-442499d33e16 |
---|
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.