Skip to content

Commit 4d6216e

Browse files
authored
EAB support notes.
1 parent d43348c commit 4d6216e

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ Table of Contents
4444
* [Wildcard certificates support](#wildcard-certificates-support)
4545
* [PFX/P12 (IIS) support](#pfxp12-iis-support)
4646
* [IDN (internationalized domain names) support](#idn-internationalized-domain-names-support)
47+
* [EAB (External Account Binding) support](#eab-external-account-binding-support)
4748
* [Alternative certificates support](#alternative-certificates-support)
4849
* [Renewals](#renewals)
4950
* [Contact details updates](#contact-details-updates)
@@ -235,6 +236,14 @@ By default, exported PFX file will be seen as "Crypt::LE exported" under the "Fr
235236
If you are using IDN (Internationalized Domain Names) and generating a certificate for those, you can either encode those into "[punycode](https://www.punycoder.com/)" form by yourself, or let the client do that for you. Please note that for the
236237
conversion to work properly you need to have correct locale settings on your system. For Linux-based systems you can check that with the "locale" command, for Windows make sure that "System locale" in the Control Panel is set correctly.
237238

239+
### EAB (EXTERNAL ACCOUNT BINDING) SUPPORT
240+
241+
Some ACME-compatible Certificate Authorities manage their accounts differently from how ACME accounts are normally created, but link those to an ACME
242+
account through so-called External Account Binding. In essence, you would need to get 2 additional parameters from those CAs and use those on the command
243+
line. Those parameters are the "Key ID" (`eab-kid`) and "HMAC Key" (`eab-hmac-key`).
244+
245+
Please note that the same EAB credentials, depending on the CA, might be allowed to be used for multiple ACME accounts or just one.
246+
238247
### ALTERNATIVE CERTIFICATES SUPPORT
239248

240249
Let's Encrypt recently started offering "alternative" certificates via the "alternate links" mechanism. When your certificate is requested, LE returns just one such link at the moment of writing, where an intemediate certificate is signed by "ISRG Root X1, Internet Security Research Group" rather than "DST Root CA X3, Digital Signature Trust Co.". You can fetch that alternative certificate instead of the "default" one using the `--alternative` option with a number corresponding to the order in which that alternative certificate was listed. So for the first alternative certificate it will be:

0 commit comments

Comments
 (0)