Update 'README.md'

This commit is contained in:
jarombridges 2019-07-12 02:31:25 +00:00
parent ee5a21f1b8
commit cce28b38e8
1 changed files with 43 additions and 34 deletions

View File

@ -1,36 +1,39 @@
# acme-dns-01-gandi.js # [acme-dns-01-gandi.js](https://git.rootprojects.org/root/acme-dns-01-gandi.js) | a [Root](https://rootprojects.org/) project
Gandi LiveDNS + Let's Encrypt for Node.js - ACME dns-01 challenges w/ ACME.js and Greenlock.js ###### Gandi LiveDNS + Let's Encrypt for Node.js - ACME dns-01 challenges w/ ACME.js and Greenlock.js
###### This handles ACME dns-01 challenges, compatible with ACME.js and Greenlock.js. Passes acme-dns-01-test.
Features # Features
Compatible * Compatible
Lets Encrypt v2.1 / ACME draft 18 (2019) * Lets Encrypt v2.1 / ACME draft 18 (2019)
Gandi.net LiveDNS API * Gandi.net LiveDNS API
ACME.js, Greenlock.js, and others * ACME.js, Greenlock.js, and others
Quality * Quality
node v6 compatible VanillaJS * node v6 compatible VanillaJS
< 150 lines of code * < 150 lines of code
Zero Dependencies * Zero Dependencies
Install
npm install --save acme-dns-01-gandi # Install
`npm install --save acme-dns-01-gandi`
Generate Gandi LiveDNS API Token: Generate Gandi LiveDNS API Token:
Login to your account at: * Login to your account at: https://account.gandi.net/
https://account.gandi.net/ * Under the Security section, click the link next to 'Production API key' to generate a token.
Under the Security section, click the link next to 'Production API key' to generate a token. # Usage
Usage
First you create an instance with your credentials: First you create an instance with your credentials:
```
var dns01 = require('acme-dns-01-gandi').create({ var dns01 = require('acme-dns-01-gandi').create({
baseUrl: 'https://dns.api.gandi.net/api/v5/', // default baseUrl: 'https://dns.api.gandi.net/api/v5/', // default
token: 'xxxx' token: 'xxxx'
}); });
```
Then you can use it with any compatible ACME library, such as Greenlock.js or ACME.js. Then you can use it with any compatible ACME library, such as Greenlock.js or ACME.js.
Greenlock.js ## Greenlock.js
```
var Greenlock = require('greenlock-express'); var Greenlock = require('greenlock-express');
var greenlock = Greenlock.create({ var greenlock = Greenlock.create({
challenges: { challenges: {
@ -38,20 +41,23 @@ var greenlock = Greenlock.create({
// ... // ...
} }
}); });
See Greenlock Express and/or Greenlock.js documentation for more details. ```
See [Greenlock Express](https://git.rootprojects.org/root/greenlock-express.js) and/or [Greenlock.js](https://git.rootprojects.org/root/greenlock.js) documentation for more details.
ACME.js ## ACME.js
// TODO `// TODO`
See the ACME.js for more details. See the ACME.js for more details.
Build your own ## Build your own
There are only 5 methods: There are only 5 methods:
init(config) * ```init(config)```
zones(opts) * ```zones(opts)```
set(opts) * ```set(opts)```
get(opts) * ```get(opts)```
remove(opts) * ```remove(opts)```
```
dns01 dns01
.set({ .set({
identifier: { value: 'foo.example.co.uk' }, identifier: { value: 'foo.example.co.uk' },
@ -66,17 +72,20 @@ dns01
.catch(function() { .catch(function() {
console.log('Failed to set TXT record'); console.log('Failed to set TXT record');
}); });
```
See acme-dns-01-test for more implementation details. See acme-dns-01-test for more implementation details.
Tests # Tests
```
# node ./test.js domain-zone api-token # node ./test.js domain-zone api-token
node ./test.js example.com xxxxxx node ./test.js example.com xxxxxx
Authors ```
Jarom Bridges # Authors
AJ ONeal * Jarom Bridges
* AJ ONeal
See AUTHORS for contact info. See AUTHORS for contact info.
Legal # Legal
acme-dns-01-gandi.js | MPL-2.0 | Terms of Use | Privacy Policy [acme-dns-01-gandi.js](https://git.coolaj86.com/coolaj86/acme-dns-01-gandi.js) | MPL-2.0 | [Terms of Use](https://therootcompany.com/legal/#terms) | [Privacy Policy](https://therootcompany.com/legal/#privacy)
Copyright 2019 The Root Group LLC Copyright 2019 The Root Group LLC