diff --git a/README.rst b/README.rst index e10dc71..2484d43 100644 --- a/README.rst +++ b/README.rst @@ -39,8 +39,8 @@ certbot's command line: | (Default: 10, Recommended: >= 600) ============================================================= ============================================== -(Note that the verbose and seemingly redundant ``certbot-dns-ispconfig:`` prefix -is currently imposed by certbot for external plugins.) +(Note that the verbose and seemingly redundant ``certbot-dns-corenetworks:`` +prefix is currently imposed by certbot for external plugins.) Credentials @@ -52,7 +52,6 @@ An example ``credentials.ini`` file: certbot_dns_corenetworks:dns_corenetworks_username = myremoteuser certbot_dns_corenetworks:dns_corenetworks_password = verysecureremoteuserpassword - certbot_dns_corenetworks:dns_corenetworks_endpoint = https://localhost:8080/remote/json.php The path to this file can be provided interactively or using the ``--certbot-dns-corenetworks:dns-corenetworks-credentials`` command-line argument. Certbot diff --git a/certbot_dns_corenetworks.egg-info/PKG-INFO b/certbot_dns_corenetworks.egg-info/PKG-INFO new file mode 100644 index 0000000..3d8cd9c --- /dev/null +++ b/certbot_dns_corenetworks.egg-info/PKG-INFO @@ -0,0 +1,124 @@ +Metadata-Version: 2.1 +Name: certbot-dns-corenetworks +Version: 0.2.0 +Summary: Core Networks DNS Authenticator plugin for Certbot +Home-page: https://github.com/MasinAD/certbot-dns-corenetworks +Author: Masin Al-Dujaili +Author-email: masin.aldujaili@googlemail.com +License: Apache License 2.0 +Description: certbot-dns-corenetworks + ===================== + + Core_Networks_ DNS Authenticator plugin for Certbot + + This plugin automates the process of completing a ``dns-01`` challenge by + creating, and subsequently removing, TXT records using the Core Networks beta API. + + Configuration of Core Networks + --------------------------- + + In the `Allgemein -> Profil -> API-Benutzer` you have to have a user with a login name and password + + .. _Core_Networks: https://beta.api.core-networks.de/doc/ + .. _certbot: https://certbot.eff.org/ + + Installation + ------------ + + :: + + pip install certbot-dns-corenetworks + + + Named Arguments + --------------- + + To start using DNS authentication for Core Networks, pass the following arguments on + certbot's command line: + + ============================================================= ============================================== + ``--authenticator certbot-dns-corenetworks:dns-corenetworks`` select the authenticator plugin (Required) + + ``--certbot-dns-corenetworks:dns-corenetworks-credentials`` Core Networks Remote User credentials + INI file. (Required) + + ``--certbot-dns-corenetworks:dns-corenetworks-propagation-seconds`` | waiting time for DNS to propagate before asking + | the ACME server to verify the DNS record. + | (Default: 10, Recommended: >= 600) + ============================================================= ============================================== + + (Note that the verbose and seemingly redundant ``certbot-dns-corenetworks:`` + prefix is currently imposed by certbot for external plugins.) + + + Credentials + ----------- + + An example ``credentials.ini`` file: + + .. code-block:: ini + + certbot_dns_corenetworks:dns_corenetworks_username = myremoteuser + certbot_dns_corenetworks:dns_corenetworks_password = verysecureremoteuserpassword + + The path to this file can be provided interactively or using the + ``--certbot-dns-corenetworks:dns-corenetworks-credentials`` command-line argument. Certbot + records the path to this file for use during renewal, but does not store the + file's contents. + + **CAUTION:** You should protect these API credentials as you would the + password to your Core Networks account. Users who can read this file can use these + credentials to issue arbitrary API calls on your behalf. Users who can cause + Certbot to run using these credentials can complete a ``dns-01`` challenge to + acquire new certificates or revoke existing certificates for associated + domains, even if those domains aren't being managed by this server. + + Certbot will emit a warning if it detects that the credentials file can be + accessed by other users on your system. The warning reads "Unsafe permissions + on credentials configuration file", followed by the path to the credentials + file. This warning will be emitted each time Certbot uses the credentials file, + including for renewal, and cannot be silenced except by addressing the issue + (e.g., by using a command like ``chmod 600`` to restrict access to the file). + + + Examples + -------- + + To acquire a single certificate for both ``example.com`` and + ``*.example.com``, waiting 900 seconds for DNS propagation: + + .. code-block:: bash + + certbot certonly \ + --authenticator certbot-dns-corenetworks:dns-corenetworks \ + --certbot-dns-corenetworks:dns-corenetworks-credentials /etc/letsencrypt/.secrets/domain.tld.ini \ + --certbot-dns-corenetworks:dns-corenetworks-propagation-seconds 900 \ + --server https://acme-v02.api.letsencrypt.org/directory \ + --agree-tos \ + --rsa-key-size 4096 \ + -d 'example.com' \ + -d '*.example.com' + + +Platform: UNKNOWN +Classifier: Development Status :: 3 - Alpha +Classifier: Environment :: Plugins +Classifier: Intended Audience :: System Administrators +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Operating System :: POSIX :: Linux +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.4 +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Topic :: Internet :: WWW/HTTP +Classifier: Topic :: Security +Classifier: Topic :: System :: Installation/Setup +Classifier: Topic :: System :: Networking +Classifier: Topic :: System :: Systems Administration +Classifier: Topic :: Utilities +Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.* +Description-Content-Type: text/x-rst diff --git a/certbot_dns_corenetworks.egg-info/SOURCES.txt b/certbot_dns_corenetworks.egg-info/SOURCES.txt new file mode 100644 index 0000000..3ad2d9b --- /dev/null +++ b/certbot_dns_corenetworks.egg-info/SOURCES.txt @@ -0,0 +1,12 @@ +README.rst +setup.cfg +setup.py +certbot_dns_corenetworks/__init__.py +certbot_dns_corenetworks/dns_corenetworks.py +certbot_dns_corenetworks/dns_corenetworks_test.py +certbot_dns_corenetworks.egg-info/PKG-INFO +certbot_dns_corenetworks.egg-info/SOURCES.txt +certbot_dns_corenetworks.egg-info/dependency_links.txt +certbot_dns_corenetworks.egg-info/entry_points.txt +certbot_dns_corenetworks.egg-info/requires.txt +certbot_dns_corenetworks.egg-info/top_level.txt \ No newline at end of file diff --git a/certbot_dns_corenetworks.egg-info/dependency_links.txt b/certbot_dns_corenetworks.egg-info/dependency_links.txt new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/certbot_dns_corenetworks.egg-info/dependency_links.txt @@ -0,0 +1 @@ + diff --git a/certbot_dns_corenetworks.egg-info/entry_points.txt b/certbot_dns_corenetworks.egg-info/entry_points.txt new file mode 100644 index 0000000..5af60c4 --- /dev/null +++ b/certbot_dns_corenetworks.egg-info/entry_points.txt @@ -0,0 +1,3 @@ +[certbot.plugins] +dns-corenetworks = certbot_dns_corenetworks.dns_corenetworks:Authenticator + diff --git a/certbot_dns_corenetworks.egg-info/requires.txt b/certbot_dns_corenetworks.egg-info/requires.txt new file mode 100644 index 0000000..a08ac39 --- /dev/null +++ b/certbot_dns_corenetworks.egg-info/requires.txt @@ -0,0 +1,7 @@ +acme>=0.29.0 +certbot>=0.34.0 +setuptools +requests +mock +requests-mock +lexicon diff --git a/certbot_dns_corenetworks.egg-info/top_level.txt b/certbot_dns_corenetworks.egg-info/top_level.txt new file mode 100644 index 0000000..8fdc0eb --- /dev/null +++ b/certbot_dns_corenetworks.egg-info/top_level.txt @@ -0,0 +1 @@ +certbot_dns_corenetworks diff --git a/certbot_dns_corenetworks/__init__.pyc b/certbot_dns_corenetworks/__init__.pyc new file mode 100644 index 0000000..a9879d4 Binary files /dev/null and b/certbot_dns_corenetworks/__init__.pyc differ diff --git a/certbot_dns_corenetworks/__pycache__/__init__.cpython-38.pyc b/certbot_dns_corenetworks/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000..db89ae8 Binary files /dev/null and b/certbot_dns_corenetworks/__pycache__/__init__.cpython-38.pyc differ diff --git a/certbot_dns_corenetworks/__pycache__/dns_corenetworks.cpython-38.pyc b/certbot_dns_corenetworks/__pycache__/dns_corenetworks.cpython-38.pyc new file mode 100644 index 0000000..fb62f78 Binary files /dev/null and b/certbot_dns_corenetworks/__pycache__/dns_corenetworks.cpython-38.pyc differ diff --git a/certbot_dns_corenetworks/dns_corenetworks.py b/certbot_dns_corenetworks/dns_corenetworks.py index 8728e07..7fa004c 100644 --- a/certbot_dns_corenetworks/dns_corenetworks.py +++ b/certbot_dns_corenetworks/dns_corenetworks.py @@ -2,7 +2,7 @@ import logging import zope.interface -from lexicon.providers import corenetworks +from lexicon import corenetworks from certbot import errors from certbot import interfaces diff --git a/certbot_dns_corenetworks/dns_corenetworks.pyc b/certbot_dns_corenetworks/dns_corenetworks.pyc new file mode 100644 index 0000000..cb89284 Binary files /dev/null and b/certbot_dns_corenetworks/dns_corenetworks.pyc differ