Metadata-Version: 2.4
Name: certbot-dns-contabo-api
Version: 1.0.1
Summary: Contabo DNS Authenticator plugin for Certbot
Author: Custom
License: Apache License 2.0
Classifier: Development Status :: 4 - Beta
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 :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
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: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: certbot>=1.0.0
Requires-Dist: requests>=2.20.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Certbot DNS Contabo Plugin

DNS Authenticator plugin for Certbot that uses Contabo DNS API.

## Installation

```bash
# Install dependencies first
apt install python3-pip -y

# Install the plugin
pip3 install /path/to/certbot-dns-contabo --break-system-packages
```

## Configuration

### 1. Get API Credentials

From [Contabo Customer Control Panel](https://my.contabo.com/api/details), get:
- Client ID
- Client Secret
- API User (your email)
- API Password

### 2. Create Credentials File

Create `/etc/letsencrypt/contabo.ini`:

```ini
dns_contabo_client_id = YOUR_CLIENT_ID
dns_contabo_client_secret = YOUR_CLIENT_SECRET
dns_contabo_api_user = your@email.com
dns_contabo_api_password = YOUR_API_PASSWORD
```

Secure the file:

```bash
chmod 600 /etc/letsencrypt/contabo.ini
```

### 3. Issue Certificate

```bash
certbot certonly \
  --authenticator dns-contabo \
  --dns-contabo-credentials /etc/letsencrypt/contabo.ini \
  --dns-contabo-propagation-seconds 120 \
  -d example.com \
  -d "*.example.com"
```

### 4. Test Auto-Renewal

```bash
certbot renew --dry-run
```

## Credentials File Format

```ini
# Contabo API credentials
dns_contabo_client_id = your_client_id
dns_contabo_client_secret = your_client_secret
dns_contabo_api_user = your_email@example.com
dns_contabo_api_password = your_api_password
```
