Skip to main content

No project description provided

Project description

Travis CI Status Coveralls Status PyPI Version

kasserver - Manage domains hosted on All-Inkl.com through the KAS server API

This project consists of the Python library kasserver and a few command line utilities to manage domains of the German webhoster All-Inkl.com through their KAS server API.

At the moment the main focus is managing DNS record as this allows to automate the creation of Let’s Encrypt (wildcard) certificates with the ACME DNS-01 challenge.

Installation

kasserver (and its dependencies) can be installed from PyPI with: pip3 install kasserver

Authentication

Both library and command line utilities require access to the KAS credentials. Username and password are read from the KASSERVER_USER and KASSERVER_PASSWORD environment variables or from the ~/.netrc file:

machine kasapi.kasserver.com
login USERNAME
password PASSWORD

The file must be accessible only by your user account: chmod 600 ~/.netrc.

Scripts

kasserver-dns

A generic program to manage DNS records.

DNS records can be listed with:

$ kasserver-dns list example.com
ID C Zone        Name Type  Data               Aux
 1 Y example.com      A     X.X.X.X            0
 0 N example.com      NS    ns5.kasserver.com. 0
 0 N example.com      NS    ns6.kasserver.com. 0
 0 N example.com www  CNAME example.com        0

A new DNS record is added with:

kasserver-dns add test.example.com CNAME example.com

An existing DNS record is removed with:

kasserver-dns remove test.example.com CNAME

kasserver-dns-*

The following programs are designed to be used together with ACME clients to automate DNS record creation/removal as it is required by a Let’s Encryt ACME DNS-01 challenge for automatic certificate renewal.

kasserver-dns-certbot

This program is designed to be used with Certbot:

certbot certonly -d foo.exmaple.com --preferred-challenges dns \
                 --manual --manual-auth-hook kasserver-dns-certbot \
                          --manual-cleanup-hook kasserver-dns-certbot \
                 -m invalid@example.com
kasserver-dns-lego

This program is designed to be used with lego:

EXEC_PATH=kasserver-dns-lego lego --dns exec \
    --domains foo.example.com --email invalid@example.com run

License

This projected is licensed under the terms of the MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kasserver, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size kasserver-0.2.0.tar.gz (12.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page