Metadata-Version: 2.4
Name: certbot-dns-twc
Version: 1.0.0
Summary: TimeWeb DNS Authenticator plugin for Certbot
Author: Vladimir Berkutov
License-Expression: MIT
Project-URL: Homepage, https://gitflic.ru/project/ungoo/certbot-dns-twc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: System :: Networking
Classifier: Environment :: Plugins
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certbot>=2.0.0
Dynamic: license-file

# certbot-dns-twc

A Certbot DNS authenticator plugin for obtaining SSL/TLS certificates via DNS-01 challenge using [TimeWeb Cloud](https://timeweb.cloud/).

## Features

- **Tight integration with `twc-cli`**: Uses the official [TimeWeb Cloud CLI](https://github.com/timeweb-cloud/twc) for authentication and API access — no separate credential configuration needed.
- **Multi-profile support**: Switch between different TimeWeb Cloud accounts/profiles using the `--dns-twc-profile` option.

## Installation

```bash
pip install certbot-dns-twc
```

### Requirements

- Python 3.10+
- [certbot](https://certbot.eff.org/) >= 2.0.0
- [twc-cli](https://github.com/timeweb-cloud/twc) installed and configured

## Usage

### Basic usage

Using the `default` profile:

```
certbot certonly \
  --authenticator dns-twc \
  -d example.com -d '*.example.com'
```

Using a specific TimeWeb profile

```bash
certbot certonly \
  --authenticator dns-twc \
  --dns-twc-profile aa00000 \  # <- note the profile!
  -d example.com -d '*.example.com'
```

## Configuration

This plugin reads credentials from the `twc-cli` configuration file (typically located at `~/.twcrc`). Make sure you have put the [api key aka api token](https://timeweb.cloud/my/api-keys) for your profile using `twc config`.

## License

MIT
