Commit 31dcc183 authored by Mark Tearle's avatar Mark Tearle

Add example certbot hook script

parent 4da422fd
......@@ -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);
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment