diff --git a/quovadis/quovadis.php b/quovadis/quovadis.php index 0c4a0a5ba240c4afad2a350746364770f1850068..9e727f48546dc4b9c43aa8a6146a8fd1fe07e3b1 100644 --- a/quovadis/quovadis.php +++ b/quovadis/quovadis.php @@ -163,6 +163,19 @@ Rough API usage is: curl -X POST -d username=accmurphy https://quovadis.ucc.asn.au/quovadis/register curl -X POST -d username=accmurphy -d api_key=foo -d new_api_key=bar https://quovadis.ucc.asn.au/quovadis/update-api-key curl -X POST -d username=accmurphy -d api_key=foo -d challenge=thingy -d value=123456abcdef https://quovadis.ucc.asn.au/quovadis/update-challenge + +This API can be used by a certbot hook script. + +certbot certonly --server https://acme-v02.api.letsencrypt.org/directory \ + --manual \ + --preferred-challenges=dns \ + --manual-auth-hook /etc/letsencrypt/ucc-hooks/certbot-hook-quovadis.sh \ + -d thehostname.ucc.asn.au + +The hook script can be downloaded from: + +* https://gitlab.ucc.asn.au/UCC/quovadis/-/blob/master/scripts/certbot-hook-quovadis.sh +* https://gitlab.ucc.asn.au/UCC/quovadis/-/blob/master/scripts/config.sh END; // In case any of our lines are larger than 70 characters, we should use wordwrap() @@ -194,6 +207,35 @@ curl -X POST -d username=accmurphy https://quovadis.ucc.asn.au/quovadis/register curl -X POST -d username=accmurphy -d api_key=foo -d new_api_key=bar https://quovadis.ucc.asn.au/quovadis/update-api-key curl -X POST -d username=accmurphy -d api_key=foo -d challenge=thingy -d value=123456abcdef https://quovadis.ucc.asn.au/quovadis/update-challenge </pre> + +<p> +This API can be used by a certbot hook script. +</p> + +<pre> +certbot certonly --server https://acme-v02.api.letsencrypt.org/directory \ + --manual \ + --preferred-challenges=dns \ + --manual-auth-hook /etc/letsencrypt/ucc-hooks/certbot-hook-quovadis.sh \ + -d thehostname.ucc.asn.au +</pre> + +<p> +The hook script can be downloaded from: +</p> + +<ul> +<li> +<a href="https://gitlab.ucc.asn.au/UCC/quovadis/-/blob/master/scripts/certbot-hook-quovadis.sh"> +https://gitlab.ucc.asn.au/UCC/quovadis/-/blob/master/scripts/certbot-hook-quovadis.sh +</a> +</li> +<li> +<a href="https://gitlab.ucc.asn.au/UCC/quovadis/-/blob/master/scripts/config.sh"> +https://gitlab.ucc.asn.au/UCC/quovadis/-/blob/master/scripts/config.sh +</a> +</li> +</ul> END; $leaf->response()->markup($html);