acme-dns-01-vercel

Vercel 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.

Install

1npm install --save acme-dns-01-vercel

Generate Vercel API Token:

• https://vercel.com/guides/how-do-i-use-a-vercel-api-access-token

Usage

First you create an instance with your credentials:

1var dns01 = require('acme-dns-01-digitalocean').create({
2	token: 'xxxx'
3});

Then you can use it with any compatible ACME library, such as Greenlock.js or ACME.js.

Greenlock.js

1var Greenlock = require('greenlock-express');
2var greenlock = Greenlock.create({
3	challenges: {
4		'dns-01': dns01
5		// ...
6	}
7});

See Greenlock Express and/or Greenlock.js documentation for more details.

ACME.js

1// TODO

See the ACME.js for more details.

Build your own

There are only 5 methods:

• init(config)
• zones(opts)
• set(opts)
• get(opts)
• remove(opts)

1dns01
2	.set({
3		identifier: { value: 'foo.example.co.uk' },
4		wildcard: false,
5		dnsZone: 'example.co.uk',
6		dnsPrefix: '_acme-challenge.foo',
7		dnsAuthorization: 'xxx_secret_xxx'
8	})
9	.then(function() {
10		console.log('TXT record set');
11	})
12	.catch(function() {
13		console.log('Failed to set TXT record');
14	});

See acme-dns-01-test for more implementation details.

Tests

You will need to add environment variables:

VERCEL_TOKEN
DOMAIN

1npm test

Authors

• Freddie Ergatoudis

See AUTHORS for contact info.

Legal

MIT License | Terms of Use | Privacy Policy

Copyright 2023