froonix / acme-dns-inwx

🌐 Use INWX DNS-API for ACME's dns-01 challenge

ACME-DNS-INWX

Simple helper script for various Let's Encrypt clients. Developed for GetSSL and ACME.sh, tested at Debian and Ubuntu.

Initial setup

Download or clone the archive and extract it to a new folder.

Copy the example config file config/.inwx.ini to ~/.inwx.ini and insert your credentials. If enabled, enter your TOTP/2FA shared secret. Don't forget to check file permissions! (recommended: 0600)

Run it for the first time:

# Add the TXT record _acme-challenge.example.com
# with value "test" and set TTL to 300 seconds:
./scripts/acme-dns-inwx --add "example.com" "test"

# Check your nameserver: (wait some time)
dig TXT "_acme-challenge.example.com" +short

# Delete the TXT record _acme-challenge.example.com:
./scripts/acme-dns-inwx --del "example.com"

Take a look at the wiki for more examples.

Bugs? Feedback?

Open a new issue or drop me a line at [email protected]! :-)

Important: This project is not affiliated with INWX GmbH!

Important links...

• Bugtracker
• Wiki pages
• INWX DNS-API (DE)
• INWX DNS-API (EN)
• Let's Encrypt

acme-dns-inwx's Issues

Testmodus über OTE

Über Option in INI-Datei aktivieren?

api="…"

Update testscript

(see acme-dns-nc)

Von 3 auf 5 Wiederholungen bei Fehler erhöhen

Bei 2FA und allgemein. Es gibt zwei Schleifen dafür.

Die API reagiert einfach unzuverlässig, es gibt zu viele sporadische Timeouts. Eine Erklärung habe ich dafür leider noch nicht. Eventuell ist der DDoS-Schutz von INWX zu hart.

Dumm ist daran nur, dass manche Aktionen ohne Rückmeldung doppelt ausgeführt werden könnten. Beim Löschen von Records werden diese Fehler aber sowieso schon abgefangen.

Dependency for php-json module missing

Otherwise this seems to work, I'm just blocked by API ratelimiting. FreeBSD 11.1 with PHP 7.2. Thanks a lot.

Lizenz wählen

GPL oder doch eine andere?

fnx.li aus den Dateien entfernen

Vorallem aus dem Testscript, das kann man über $1 übergeben.

Don't call logout() in INWX::login()

Only reset session storage!

PHP 5 Kompatibilität wieder herstellen

Gefundene Domains zwischenspeichern

Memcached? Temporäre Dateien?

Destroy cookiefile at INWX::logout()

Call clearstatcache() in INWX::setSessionStorage()

Wildcard Support

(Multiple TXT records per host!)

subdomain-handling in gettssl >= v2.21

Getssl check the dns-txt-record for "_acme-challenge.subdomain.domain.extension" and the result is wrong. It is in getssl since version 2.21. Getssl version 2.20 still check the dns-txt-record for "_acme-challenge.subdomain".

idn_to_utf8()

Convert $domain at all doRequest calls:

function idn_to_utf8_wrapper($domain)
{
	if(defined('INTL_IDNA_VARIANT_UTS46'))
	{
		return idn_to_utf8($domain, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46);
	}

	return idn_to_utf8($domain);
}

Don't forget extension_loaded('intl') requirement check!

--
Reference: fnx-dns-tool

• 299c3de4f53544b824e908ec137f0e10c290479c
• 5ec4573771f56fa15578817caae43686ae26c6da
• 765bc5650fe796f4e35e07bbe4734995746259a7

sleep bei 2FA auf mind. 30 erhöhen

Da nur ein Login in einem 30 Sekunden Zeitfenster möglich ist, macht weniger meistens keinen Sinn.

cURL-Timeout über INI konfigurierbar machen

wrapper: "add" muss prüfen, ob zweiter Parameter angegeben wurde!

Ansonsten Usage-Meldung ausgeben.

sleep nach jeder Anfrage?

Steht sowieso noch auskommentiert drinnen: sleep(mt_rand(3, 8));

Ohne diese kurze Wartezeit scheint es noch mehr sporadische Fehler zu geben, die in Wiederholungen enden.