Download the PHP package pantheon-systems/terminus-acme-plugin without Composer
On this page you can find all versions of the php package pantheon-systems/terminus-acme-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pantheon-systems/terminus-acme-plugin
More information about pantheon-systems/terminus-acme-plugin
Files in pantheon-systems/terminus-acme-plugin
Package terminus-acme-plugin
Short Description Terminus commands to interact with ACME challenges.
License MIT
Informations about the package terminus-acme-plugin
Terminus ACME Plugin
Terminus commands to interact with ACME domain ownership validation challenges.
You can use these commands to allow Pantheon to obtain an HTTPS certificate for your domain before you go live on Pantheon.
Configuration
These commands require no configuration.
Usage
1. Obtain an ACME challenge to prove domain ownership
Choose to provision a DNS txt record or to serve a file from your existing webserver to prove you own the domain.
Using a DNS TXT record:
terminus alpha:https:challenge:dns-txt <site>.<env> example.com
This command also supports the --format
and --fields
options to assist in automating
your workflows with Terminus.
Using a file on your existing webserver:
terminus alpha:https:challenge:file <site>.<env> example.com
You must be a member of the site's team to create challenges.
2. Tell Pantheon the challenge is ready to be verified
After you have deployed the ACME challenge, tell Pantheon the challenge is ready to be verified using the appropriate command below.
Using a DNS TXT record:
terminus acme-txt-verify <site>.<env> example.com
Using a file on your existing webserver:
terminus alpha:https:challenge:file:verify <site>.<env> example.com
For those scripting automation with this plugin, note:
- The verify commands exit 0 if verification was successful or nonzero if there was an error.
- When a verification error occurs, it is sometimes necessary to serve a new challenge.
Your automation should call the command to obtain the challenge again and see if it has changed.
Installation
To install this plugin place it in ~/.terminus/plugins/
.
On Mac OS/Linux:
Help
Run terminus help alpha:https:challenge:dns-txt
for help.