REST request
Send verification files to the server by issuing an http(s) request
| Plugin type | HTTP validation | |
|---|---|---|
| Download | Version v2.3.2. Look for older releases on GitHub for files named like plugin.validation.http.rest.v2.x.x.zip | |
| Chocolatey | choco install simple-acme-validation-http-rest(details) |
|
| Compatibility | All platforms |
Description
Publish the challenge answer using a REST API. You will need a third party or custom server component for this validation method to work. The reference implementation can be found here.
The plugin need to be unpacked into the folder where you also unpacked
wacs.exe to able to use it. Depending on how you downloaded the file,
you may have to unblock all new .dll files before your computer will trust
them. You can do that from the Windows File Explorer by using the right mouse button
and then checking the `Unblock` box on the General tab.
If you are using simple-acme as a dotnet tool, the folder will be %userprofile%\.dotnet\tools\.store\simple-acme\2.3.2.1981\simple-acme\2.3.2.1981\tools\net9.0\any
To verify that the plugin is properly installed you can start the main executable
with ‑‑verbose and it will print information about found and loaded plugins at
start up. When the plugin is loaded, it manifests itself as extra menu choices and
command line parameters being made availalbe.
This plugin requires to you use the pluggable release of the main executable. It will not work on the smaller trimmed releases.
Command line
--validation rest |
Activates the plugin | |
|---|---|---|
‑‑rest-securitytoken |
The bearer token needed to authenticate with the REST API on the server for PUT / DELETE requests.
You may pass the secret in plain text, but can also use a reference to the secret vault like |
|
‑‑rest-usehttps |
If HTTPS should be used instead of HTTP. Must be true if the server has HTTP to HTTPS redirection configured, as the redirected request always uses the GET method. |
Examples
| Typical | --validation rest ‑‑rest-securitytoken ***** [‑‑rest-usehttps] |
|---|
JSON
| ID | 11ba2994-ea59-4f2f-b9eb-0eaa2fa3cbfa |
|---|
Looking for win-acme?
simple-acme is a backwards compatible, drop-in replacement built by the same person. Project history.