WAPI-TXT

Download wapi-txt.exe (v1.0.1-windows)
Download wapi-txt (v1.0.0-linux)

source

WAPI-TXT is a program that automates the creation of TXT records on DNS servers operated by the hosting company WEDOS.

What the program is good for?
In cooperation with e.g. the WIN-ACME program, it allows you to automatically verify domain ownership in the process of requesting an SSL certificate, e.g. from Let's Encrypt, using the so-called DNS-01 challenge.

DNS-01 challenge

Pros:

  • Can be used from computer without port opened to internet.
  • Can be used for wildcard certificates.

Cons:

  • API credentials has to be stored on PC.

Features of the program

How to use

  1. Enable WAPI interface in WEDOS administration and add IP address of computer to whitelist.
  2. Copy wapi-txt.exe (Windows) or wapi-txt (Linux) to your computer.
  3. Create file containing encrypted form of your credentials to WAPI interface by command: 
    wapi-txt.exe --set wapi_credentials(Windows)
    wapi-txt --set wapi_credentials(Linux)
    (Caution: Content of the file with credentials is not encrypted in Linux!) 
  4. Use program to create and delete TXT DNS records. You can do it from command line or by e.g. WIN-ACME utility.

Options and parameters

Description:

This program create or delete TXT records in WEDOS DNS servers via WAPI. Usage:

wapi-txt[.exe] [options] [command <arg1> <arg2> <arg3>]

Options:
--set wapi_credentials Set access information for WAPI interface
--config               Path to config file
--lets-secure          Program will works with ACME CHALLENGE related record only.
--no-check             Do not check command's arguments
--version              Show version information
--help                 Show help and usage information
--EULA                 Show license agreement.



Commands:
create <arg1> <arg2> <arg3>
delete <arg1> <arg2> <arg3>




Examples:

Create record:
wapi-txt[.exe] create www.example.com _acme-challenge.www.example.com ql4ykjsbqCB_9SVBl_ZvxhGuMWpSVT2Qs3wgN



Delete record:
wapi-txt[.exe] delete www.example.com _acme-challenge.www.example.com ql4ykjsbqCB_9SVBl_ZvxhGuMWpSVT2Qs3wgN


How to config


1. If the --config parameter is used, the path to the file containing WAPI credentials is retrieved from the specified configuration file.
2. If the parameter is not used, the application searches for a configuration file in its own folder.
3. If no configuration file is found, the application looks for a file in the same folder.


Config file example

<Config>
<CredentialsFile>../my.secret.file</CredentialsFile>
</Config>








Options and parameters

Description:

This program create or delete TXT records in WEDOS DNS servers via WAPI. Usage:

wapi-txt[.exe] [options] [command <arg1> <arg2> <arg3>]

Options:
--set wapi_credentials Set access information for WAPI interface
--config               Path to config file
--lets-secure          Program will works with ACME CHALLENGE related record only.
--no-check             Do not check command's arguments
--version              Show version information
--help                 Show help and usage information
--EULA                 Show license agreement.



Commands:
create <arg1> <arg2> <arg3>
delete <arg1> <arg2> <arg3>




Examples:

Create record:
wapi-txt[.exe] create www.example.com _acme-challenge.www.example.com ql4ykjsbqCB_9SVBl_ZvxhGuMWpSVT2Qs3wgN



Delete record:
wapi-txt[.exe] delete www.example.com _acme-challenge.www.example.com ql4ykjsbqCB_9SVBl_ZvxhGuMWpSVT2Qs3wgN


How to config


1. If the --config parameter is used, the path to the file containing WAPI credentials is retrieved from the specified configuration file.
2. If the parameter is not used, the application searches for a configuration file in its own folder.
3. If no configuration file is found, the application looks for a file in the same folder.


Config file example

<Config>
<CredentialsFile>../my.secret.file</CredentialsFile>
</Config>