Compare commits

..

No commits in common. "master" and "zones-api" have entirely different histories.

7 changed files with 101 additions and 152 deletions

1
.gitignore vendored
View File

@ -1,3 +1,2 @@
.env
*secret*
node_modules

View File

@ -1,77 +1,10 @@
# [acme-dns-01-vultr](https://git.rootprojects.org/root/acme-dns-01-vultr.js) | a [Root](https://rootprojects.org) project
# [acme-dns-01-vultr](https://git.rootprojects.org/root/acme-dns-01-vultr) | a [Root](https://rootrpojects.org) project
Vultr DNS + Let's Encrypt for Node.js
This handles ACME dns-01 challenges, compatible with ACME.js and Greenlock.js.
Passes [acme-dns-01-test](https://git.rootprojects.org/root/acme-dns-01-test.js).
# Install
```bash
npm install --save acme-dns-01-vultr@3.x
```
# Usage
First you create an instance with your API token:
```js
var dns01 = require('acme-dns-01-vultr').create({
baseUrl: 'https://api.vultr.com/v1/dns', // default
token: 'xxxx'
});
```
Then you can use it with any compatible ACME module,
such as Greenlock.js or ACME.js.
### Greenlock.js
```js
var Greenlock = require('greenlock-express');
var greenlock = Greenlock.create({
challenges: {
'dns-01': dns01
// ...
}
});
```
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
```js
// TODO
```
See the [ACME.js](https://git.rootprojects.org/root/acme-v2.js) for more details.
### Build your own
```js
dns01
.set({
identifier: { value: 'foo.example.com' },
wildcard: false,
dnsHost: '_acme-challenge.foo.example.com',
dnsAuthorization: 'xxx_secret_xxx'
})
.then(function() {
console.log('TXT record set');
})
.catch(function() {
console.log('Failed to set TXT record');
});
```
See [acme-dns-01-test](https://git.rootprojects.org/root/acme-dns-01-test.js)
for more implementation details.
Vultr DNS for Let's Encrypt / ACME dns-01 challenges with ACME.js and Greenlock.js (Node.js).
# Tests
```bash
# node ./test.js domain-zone api-key
```
# node ./test.js domain-zone api-token
node ./test.js example.com xxxxxx
```

View File

@ -1,2 +0,0 @@
ZONE=example.co.uk
TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

View File

@ -4,74 +4,78 @@ var request = require('@root/request');
request = require('util').promisify(request);
var defaults = {
baseUrl: 'https://api.vultr.com/v1/dns'
baseUrl: 'https://api.vultr.com/'
};
module.exports.create = function(config) {
var baseUrl = (config.baseUrl || defaults.baseUrl).replace(/\/$/, '');
// In all of the other modules the API token is called token,
// but here we support both.
var apiKey = config.token || config.apiKey;
function api(method, path, form) {
var baseUrl = config.baseUrl || defaults.baseUrl;
var apiKey = config.apiKey;
return {
zones: function(data) {
var url = baseUrl + 'v1/dns/list';
return request({
method: method,
url: baseUrl + path,
method: 'GET',
url: url,
headers: {
'API-Key': apiKey
},
json: true,
form: form
json: true
}).then(function(resp) {
if (resp.statusCode == 200) {
return resp.body.map(function(x) {
return x.domain;
});
}
return {
zones: function(data) {
return api('GET', '/list').then(function(resp) {
if (200 !== resp.statusCode) {
} else {
console.error(resp.statusCode);
console.error(resp.body);
throw new Error('Could not get list of zones. Check api key, etc');
}
return resp.body.map(function(x) {
return x.domain;
});
});
},
set: function(data) {
var ch = data.challenge;
var txt = ch.dnsAuthorization;
// If the domain to be verified is
var url = baseUrl + 'v1/dns/create_record';
//console.debug('adding txt', data);
return api('POST', '/create_record', {
return request({
method: 'POST',
url: url,
headers: {
'API-Key': apiKey
},
form: {
type: 'TXT',
name: ch.dnsPrefix,
data: '"' + txt + '"', // vultr requires the TXT record wraped in quotes
domain: ch.dnsZone,
ttl: 300
}
}).then(function(resp) {
if (200 !== resp.statusCode) {
if (resp.statusCode == 200) {
return true;
} else {
console.error(resp.statusCode);
console.error(resp.body);
throw new Error('record did not set. check subdomain, api key, etc');
}
return true;
});
},
remove: function(data) {
var ch = data.challenge;
var url = baseUrl + 'v1/dns/records';
return api('GET', '/records?domain=' + ch.dnsZone)
.then(function(resp) {
if (200 !== resp.statusCode) {
throw new Error(
'record did not set. check subdomain, api key, etc'
);
return request({
method: 'GET',
url: url + '?domain=' + ch.dnsZone,
json: true,
headers: {
'API-Key': apiKey
}
})
.then(function(resp) {
if (resp.statusCode == 200) {
resp = resp.body;
//console.debug(resp);
var entries = resp.filter(function(x) {
@ -86,38 +90,60 @@ module.exports.create = function(config) {
})[0];
if (entry) {
return entry.RECORDID;
return entry['RECORDID'];
} else {
throw new Error(
"Couldn't remove record. check subdomain, api key, etc"
);
}
} else {
throw new Error(
'record did not set. check subdomain, api key, etc'
);
}
})
.then(function(recordId) {
return api('POST', '/delete_record', {
var url = baseUrl + 'v1/dns/delete_record';
return request({
method: 'POST',
url: url,
headers: {
'API-Key': apiKey
},
form: {
domain: ch.dnsZone,
RECORDID: recordId
}
}).then(function(resp) {
if (200 !== resp.statusCode) {
if (resp.statusCode == 200) {
return true;
} else {
console.error(resp.statusCode);
console.error(resp.body);
throw new Error(
'record did not remove. check subdomain, api key, etc'
);
}
return true;
});
});
},
get: function(data) {
var ch = data.challenge;
var url = baseUrl + 'v1/dns/records';
//console.debug('getting txt', data);
// Digital ocean provides the api to fetch records by ID. Since we do not have id, we fetch all the records,
// filter the required TXT record
return api('GET', '/records?domain=' + ch.dnsZone).then(function(resp) {
return request({
method: 'GET',
url: url + '?domain=' + ch.dnsZone,
json: true,
headers: {
'API-Key': apiKey
}
}).then(function(resp) {
resp = resp.body;
var entries = resp.filter(function(x) {

8
package-lock.json generated
View File

@ -1,6 +1,6 @@
{
"name": "acme-dns-01-vultr",
"version": "3.0.2",
"version": "3.0.0",
"lockfileVersion": 1,
"requires": true,
"dependencies": {
@ -23,12 +23,6 @@
"requires": {
"acme-challenge-test": "^3.2.0"
}
},
"dotenv": {
"version": "8.0.0",
"resolved": "https://registry.npmjs.org/dotenv/-/dotenv-8.0.0.tgz",
"integrity": "sha512-30xVGqjLjiUOArT4+M5q9sYdvuR4riM6yK9wMcas9Vbp6zZa+ocC9dp6QoftuhTPhFAiLK/0C5Ni2nou/Bk8lg==",
"dev": true
}
}
}

View File

@ -1,6 +1,6 @@
{
"name": "acme-dns-01-vultr",
"version": "3.0.2",
"version": "3.0.0",
"description": "Vultr DNS for Let's Encrypt / ACME dns-01 challenges with ACME.js and Greenlock.js",
"main": "index.js",
"scripts": {
@ -24,7 +24,6 @@
"@root/request": "^1.3.11"
},
"devDependencies": {
"acme-dns-01-test": "^3.2.1",
"dotenv": "^8.0.0"
"acme-dns-01-test": "^3.2.1"
}
}

10
test.js Executable file → Normal file
View File

@ -1,14 +1,13 @@
#!/usr/bin/env node
'use strict';
// See https://git.coolaj86.com/coolaj86/acme-challenge-test.js
var tester = require('acme-challenge-test');
require('dotenv').config();
// https://git.rootprojects.org/root/acme-dns-01-test.js
var tester = require('acme-dns-01-test');
// Usage: node ./test.js example.com xxxxxxxxx
var zone = process.argv[2] || process.env.ZONE;
var zone = process.argv[2];
var challenger = require('./index.js').create({
token: process.argv[3] || process.env.TOKEN
apiKey: process.argv[3]
});
// The dry-run tests can pass on, literally, 'example.com'
@ -19,6 +18,7 @@ tester
console.info('PASS', zone);
})
.catch(function(e) {
console.info('FAIL', zone);
console.error(e.message);
console.error(e.stack);
});