certbot_dns_rfc2136.dns_rfc2136

DNS Authenticator using RFC 2136 Dynamic Updates.

class certbot_dns_rfc2136.dns_rfc2136.Authenticator(*args, **kwargs)[source]

Bases: certbot.plugins.dns_common.DNSAuthenticator

DNS Authenticator using RFC 2136 Dynamic Updates

This Authenticator uses RFC 2136 Dynamic Updates to fulfull a dns-01 challenge.

class certbot_dns_rfc2136.dns_rfc2136._RFC2136Client(server, key_name, key_secret, key_algorithm)[source]

Bases: object

Encapsulates all communication with the target DNS server.

add_txt_record(domain_name, record_name, record_content, record_ttl)[source]

Add a TXT record using the supplied information.

Parameters:
  • domain (str) – The domain to use to find the closest SOA.
  • record_name (str) – The record name (typically beginning with ‘_acme-challenge.’).
  • record_content (str) – The record content (typically the challenge validation).
  • record_ttl (int) – The record TTL (number of seconds that the record may be cached).
Raises:

certbot.errors.PluginError – if an error occurs communicating with the DNS server

del_txt_record(domain_name, record_name, record_content)[source]

Delete a TXT record using the supplied information.

Parameters:
  • domain (str) – The domain to use to find the closest SOA.
  • record_name (str) – The record name (typically beginning with ‘_acme-challenge.’).
  • record_content (str) – The record content (typically the challenge validation).
  • record_ttl (int) – The record TTL (number of seconds that the record may be cached).
Raises:

certbot.errors.PluginError – if an error occurs communicating with the DNS server

_find_domain(domain_name)[source]

Find the closest domain with an SOA record for a given domain name.

Parameters:domain_name (str) – The domain name for which to find the closest SOA record.
Returns:The domain, if found.
Return type:str
Raises:certbot.errors.PluginError – if no SOA record can be found.
_query_soa(domain_name)[source]

Query a domain name for an authoritative SOA record.

Parameters:domain_name (str) – The domain name to query for an SOA record.
Returns:True if found, False otherwise.
Return type:bool
Raises:certbot.errors.PluginError – if no response is received.