NGENIX DNS Authenticator plugin for Certbot
Project description
NGENIX 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 NGENIX Remote API.
Named Arguments
To start using DNS authentication for NGENIX, pass the following arguments on certbot’s command line:
--authenticator dns-ngenix |
select the authenticator plugin (Required) |
--dns-ngenix-credentials |
NGENIX Remote User credentials INI file. (Required) |
--dns-ngenix-propagation-seconds |
waiting time for DNS to propagate before asking
the ACME server to verify the DNS record.
(Default: 300, Recommended: >= 600)
|
Credentials
An example credentials.ini file:
# NGENIX API credentials used by Certbot
dns_ngenix_email = user@domain.tld
dns_ngenix_api_token = ngenix_token
The path to this file can be provided interactively or using the --dns-ngenix-credentials command-line argument. Certbot records the path to this file for use during renewal, but does not store the file’s contents.
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
certbot certonly \\
--dns-ngenix \\
--dns-ngenix-credentials ~/.secrets/certbot/ngenix.ini \\
-d example.com
certbot certonly \\
--dns-ngenix \\
--dns-ngenix-credentials ~/.secrets/certbot/ngenix.ini \\
-d example.com \\
-d www.example.com
certbot certonly \\
--dns-ngenix \\
--dns-ngenix-credentials ~/.secrets/certbot/ngenix.ini \\
--dns-ngenix-propagation-seconds 240 \\
-d example.com
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for certbot_dns_ngenix-0.0.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 682b25c9afc7a014e7af6a55b783f3ffaeadf12e6fb52463954c630e03b53ed5 |
|
MD5 | a5c30528bdabbc4819a88ce1cd229d46 |
|
BLAKE2b-256 | d6f9fd7e5e37eb5a37dc41222de94f8acb15bf5e4324a1e0f70f1d2a3425a9bb |