certbot-dns-aa 0.1.1__tar.gz

certbot_dns_aa-0.1.1/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: certbot-dns-aa
+Version: 0.1.1
+Summary: Certbot DNS-01 plugin for Andrews & Arnold using Selenium
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: certbot
+Requires-Dist: selenium
+Requires-Dist: webdriver-manager
+Requires-Dist: zope.interface
+
+# certbot_dns_aa
+
+This is a plugin for certbot to implement a DNS-01 challenge for Andrews and Arnold. As Andrews and Arnold don't have an API, it makes use of Selenium to simulate a browser session and modify DNS records from there.
+
+# Usage
+
+```bash
+git clone ...
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install certbot selenium webdriver zope
+pip install -e .
+
+export AA_USERNAME="your-aa-username"
+export AA_PASSWORD="your-aa-password"
+
+sudo -E .venv/bin/certbot certonly --authenticator dns-aa -d "<your_domain>" -v
+```
+
+
+## To-do
+
+- Add cleanup to acme challenge records

certbot_dns_aa-0.1.1/README.md

@@ -0,0 +1,23 @@
+# certbot_dns_aa
+
+This is a plugin for certbot to implement a DNS-01 challenge for Andrews and Arnold. As Andrews and Arnold don't have an API, it makes use of Selenium to simulate a browser session and modify DNS records from there.
+
+# Usage
+
+```bash
+git clone ...
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install certbot selenium webdriver zope
+pip install -e .
+
+export AA_USERNAME="your-aa-username"
+export AA_PASSWORD="your-aa-password"
+
+sudo -E .venv/bin/certbot certonly --authenticator dns-aa -d "<your_domain>" -v
+```
+
+
+## To-do
+
+- Add cleanup to acme challenge records

certbot_dns_aa-0.1.1/certbot_dns_aa/dns_aa.py

@@ -0,0 +1,158 @@
+import logging
+import os
+import time
+from certbot import errors
+from certbot.plugins import dns_common
+from zope.interface import implementer
+
+from selenium import webdriver
+from selenium.webdriver.chrome.service import Service as ChromeService
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support.ui import Select
+from webdriver_manager.chrome import ChromeDriverManager
+from selenium.webdriver.common.keys import Keys
+
+logger = logging.getLogger(__name__)
+
+class Authenticator(dns_common.DNSAuthenticator):
+    """
+    Certbot Authenticator for Andrews & Arnold Control Pages using Selenium.
+    """
+
+    description = "Obtain certificates using a DNS-01 challenge via Andrews & Arnold Control Pages automation."
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.credentials = None
+
+    @classmethod
+    def add_parser_arguments(cls, add):
+        super().add_parser_arguments(add, default_propagation_seconds=60)
+        add("credentials", help="Path to A&A credentials INI file (or use environment variables).")
+
+    def more_info(self):
+        return "Configure your Andrews & Arnold credentials to allow Certbot to automatically manage DNS-01 TXT records."
+
+    def _setup_credentials(self):
+        # self.username = os.environ.get("AA_USERNAME")
+        # self.password = os.environ.get("AA_PASSWORD")
+        
+        self.credentials = self._configure_credentials(
+        'credentials',
+        'Andrews & Arnold credentials INI file',
+        {
+            'username': 'A&A control pages username.',
+            'password': 'A&A control pages password.',
+        }
+        )
+        self.username = self.credentials.conf('username')
+        self.password = self.credentials.conf('password')
+
+    # def _validate_credentials(self, credentials):
+    #     if not credentials.conf('username') or not credentials.conf('password'):
+    #         raise errors.PluginError("Username and password must be set in the credentials file.")
+
+    #     if not self.username or not self.password:
+    #         raise errors.PluginError("A&A Username and Password must be provided via environment variables.")
+
+    def _perform(self, domain, validation_name, validation_value):
+        self._setup_credentials()
+        
+        options = webdriver.ChromeOptions()
+        options.add_argument("--headless")
+        options.add_argument("--no-sandbox")
+        options.add_argument("--disable-dev-shm-usage")
+
+        driver = webdriver.Chrome(
+            service=ChromeService(ChromeDriverManager().install()), options=options
+        )
+        wait = WebDriverWait(driver, 15)
+
+        try:
+            logger.info("Navigating to Andrews & Arnold Control Pages login...")
+            driver.get("https://control.aa.net.uk/")
+
+
+            username_field = wait.until(
+                EC.presence_of_element_located((By.NAME, "USERNAME"))
+            )
+            password_field = driver.find_element(By.NAME, "PASSWORD")
+
+            username_field.send_keys(self.username)
+            password_field.send_keys(self.password)
+
+            login_button = driver.find_element(
+                By.XPATH, "//button[@type='submit'] | //input[@type='submit']"
+            )
+            login_button.click()
+
+
+            wait.until(
+                EC.presence_of_element_located(
+                    (By.XPATH, "//*[contains(text(), 'Logout')]")
+                )
+            )
+            logger.info("Successfully logged into A&A Control Pages.")
+
+            logger.info(f"Navigating to DNS settings for {domain}...")
+            domain_link = wait.until(
+                EC.presence_of_element_located(
+                    (By.XPATH, f"//a[contains(text(), '{domain}')]")
+                )
+            )
+            domain_link.click()
+
+            record_type = wait.until(
+                EC.presence_of_element_located((By.NAME, "rectype"))
+            )
+            Select(record_type).select_by_visible_text("TXT")
+
+            ttl_elem = wait.until(
+                EC.presence_of_element_located((By.NAME, "TTL"))
+            )
+            Select(ttl_elem).select_by_visible_text("1 minute")
+
+            record_name = wait.until(
+                EC.presence_of_element_located((By.NAME, "node"))
+            )
+
+            record_name.send_keys(validation_name)
+
+            record_value = wait.until(
+                EC.presence_of_element_located((By.NAME, "recvalue"))
+            )
+            record_value.send_keys(validation_value)
+            record_value.send_keys(Keys.ENTER)
+
+            logger.info("Successfully added DNS challenge record.")
+            time.sleep(5)
+
+        except Exception as e:
+            logger.error(f"Failed to add DNS record via Selenium: {e}")
+            raise errors.PluginError(f"Selenium automation failed: {e}")
+        finally:
+            driver.quit()
+
+    def _cleanup(self, domain, validation_name, validation_value):
+        pass
+
+    # Certbot hooks
+    def perform(self, achalls):
+        responses = []
+        for achall in achalls:
+            domain = achall.domain
+            validation_name = "_acme-challenge" 
+            validation_value = achall.validation(achall.account_key)
+            logger.info(f"Validation value: {validation_value}")
+            self._perform(domain, validation_name, validation_value)
+            responses.append(achall.response(achall.account_key))
+        return responses
+
+    def cleanup(self, achalls):
+        for achall in achalls:
+            domain = achall.domain
+            validation_name = "_acme-challenge"
+            validation_value = achall.validation(achall.account_key)
+            self._cleanup(domain, validation_name, validation_value)

certbot_dns_aa-0.1.1/certbot_dns_aa.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: certbot-dns-aa
+Version: 0.1.1
+Summary: Certbot DNS-01 plugin for Andrews & Arnold using Selenium
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: certbot
+Requires-Dist: selenium
+Requires-Dist: webdriver-manager
+Requires-Dist: zope.interface
+
+# certbot_dns_aa
+
+This is a plugin for certbot to implement a DNS-01 challenge for Andrews and Arnold. As Andrews and Arnold don't have an API, it makes use of Selenium to simulate a browser session and modify DNS records from there.
+
+# Usage
+
+```bash
+git clone ...
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install certbot selenium webdriver zope
+pip install -e .
+
+export AA_USERNAME="your-aa-username"
+export AA_PASSWORD="your-aa-password"
+
+sudo -E .venv/bin/certbot certonly --authenticator dns-aa -d "<your_domain>" -v
+```
+
+
+## To-do
+
+- Add cleanup to acme challenge records

certbot_dns_aa-0.1.1/certbot_dns_aa.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+certbot_dns_aa/dns_aa.py
+certbot_dns_aa.egg-info/PKG-INFO
+certbot_dns_aa.egg-info/SOURCES.txt
+certbot_dns_aa.egg-info/dependency_links.txt
+certbot_dns_aa.egg-info/entry_points.txt
+certbot_dns_aa.egg-info/requires.txt
+certbot_dns_aa.egg-info/top_level.txt

certbot_dns_aa-0.1.1/certbot_dns_aa.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

certbot_dns_aa-0.1.1/certbot_dns_aa.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[certbot.plugins]
+dns-aa = certbot_dns_aa.dns_aa:Authenticator

certbot_dns_aa-0.1.1/certbot_dns_aa.egg-info/requires.txt

@@ -0,0 +1,4 @@
+certbot
+selenium
+webdriver-manager
+zope.interface

certbot_dns_aa-0.1.1/certbot_dns_aa.egg-info/top_level.txt

@@ -0,0 +1 @@
+certbot_dns_aa

certbot_dns_aa-0.1.1/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "certbot-dns-aa"
+version = "0.1.1"
+description = "Certbot DNS-01 plugin for Andrews & Arnold using Selenium"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "certbot",
+    "selenium",
+    "webdriver-manager",
+    "zope.interface",
+]
+
+[project.entry-points."certbot.plugins"]
+dns-aa = "certbot_dns_aa.dns_aa:Authenticator"

certbot_dns_aa-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+