From 8f13081270e415e84625aed33dba78509254f363 Mon Sep 17 00:00:00 2001 From: AJ ONeal Date: Sat, 13 Aug 2016 15:28:52 -0600 Subject: [PATCH] add README.md --- README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d257b6f --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +# le-store-SPEC + +The reference implementation, specification, template, and tests for creating an le-store- strategy. + +The reference implementation is completely in-memory. + +See [Help Wanted: Database Plugins (for saving certs)](https://github.com/Daplie/node-letsencrypt/issues/39) + +API +=== + +``` +* getOptions() +* accounts. + * checkKeypair(opts, cb) + * setKeypair(opts, keypair, cb) + * check(opts, cb) + * set(opts, reg, cb) +* certificates. + * checkKeypair(opts, cb) + * setKeypair(opts, keypair, cb) + * check(opts, cb) + * set(opts, certs, cb) +``` + +Keypairs +-------- + +For convenience, the keypair object will always contain **both** PEM and JWK +versions of the private and/or public keys when being passed to the `*Keypair` functions. + +**set** + +`setKeypair` will always be called with `email` and **all three** forms of the keypair: +`privateKeyPem`, `publicKeyPem`, and `privateKeyJwk`. It's easy to generate `publicKeyJwk` +from `privateKeyJwk` because it is just a copy of the public fields `e` and `n`. + +**check** + +`checkKeypair` may be called with any of `email`, `accountId`, and `keypair` - which will +contain only `publicKeyPem` and `publicKeyJwk`.