Download the PHP package roy-bongers/certbot-transip-dns-01-validator without Composer
On this page you can find all versions of the php package roy-bongers/certbot-transip-dns-01-validator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download roy-bongers/certbot-transip-dns-01-validator
More information about roy-bongers/certbot-transip-dns-01-validator
Files in roy-bongers/certbot-transip-dns-01-validator
Package certbot-transip-dns-01-validator
Short Description Certbot DNS-01 validation for wildcard certificates (ACME-v2)
License GPL-3.0-or-later
Homepage https://github.com/roy-bongers/certbot-transip-dns-01-validator
Informations about the package certbot-transip-dns-01-validator
certbot-transip-dns-01-validator
Certbot DNS-01 validation for wildcard certificates (ACME-v2)
I created this script to request wildcard SSL certificates from Let’s Encrypt. You are required to do a DNS-01 challenge for which you need to create a DNS (TXT) record. TransIP has an API which allows you to automate this. When you need to renew your certificate you also need to perform the DNS-01 challenge again. This should happen automatically.
Requirements
Version 2.5 has the following requirements. If you use an older PHP version you have to use an older release. Upgrading from v1? See the upgrade guide.
- PHP >= 7.4 with JSON and OpenSSL extensions enabled
- The composer package manager
Installation
- Run
composer install --no-dev
- Copy
config/config.php.example
toconfig/config.php
- Acquire an API key for TransIP in your account on their website
- Edit
config/config.php
and set your login and private key. - Make sure you set the access to this file to only allow your user to read the contents of this file (on linux
chmod og-rwx config/config.php
)
Request a wildcard certificate
Use this command to request the certificate. Replace "/path/to/" with the actual path on your system. It takes a couple of minutes for the nameservers to be updated. Please be patient until the validation completes.
If you need to do some testing add the staging flag to the certbot command:
To automatically renew your certificate add the Certbot renew command in a cron job so it runs at least monthly. `
Docker
There is also a docker container which you can use. You can either bind mount the config
folder or use ENV
variables.
These variables are available: TRANSIP_LOGIN
, TRANSIP_PRIVATE_KEY
, LOGLEVEL
, LOGFILE
.
Only the first two variables are required.
For information about values see config/config.php.example
. Multiline values (the private key) can be a bit harder
to set. Make sure the entire private key is stored in the TRANSIP_PRIVATE_KEY
variable!
The application runs in the /opt/certbot-dns-transip
directory and the certificates are created in /etc/letsencrypt
.
And to renew certificates:
Supported platforms
The code is tested on a Debian based Linux distribution (Ubuntu LTS) and currently supported PHP versions (>= 7.4). It probably works fine on other systems and versions of PHP but no guarantees are made.
Upgrade guide
Version 2.0 is a complete rewrite of the code base and breaks with the original version. Follow these steps to upgrade:
- Checkout the latest master branch
- Follow the installation guide
- Remove the
Transip
folder after copying your login and private key toconfig/config.php
- You are ready to go!
Contributors
When creating an issue please include a detailed description of what you are trying to execute and any output you receive. Feel free to fork the project and create a pull request. Make sure your code complies with the PSR-12 coding standards.
All versions of certbot-transip-dns-01-validator with dependencies
monolog/monolog Version ^3.5
purplepixie/phpdns Version dev-master
php-di/php-di Version ^7.0
transip/transip-api-php Version ^6.3