mirror of
				https://git.coolaj86.com/coolaj86/acme-challenge-test.js.git
				synced 2025-11-04 02:22:49 +00:00 
			
		
		
		
	make Prettier
This commit is contained in:
		
							parent
							
								
									d2fca0eea7
								
							
						
					
					
						commit
						fa912800b4
					
				
							
								
								
									
										157
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										157
									
								
								README.md
									
									
									
									
									
								
							@ -55,36 +55,37 @@ See `example.js` (it works).
 | 
			
		||||
Here's what you could start with.
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
var tester = require("acme-challenge-test");
 | 
			
		||||
var tester = require('acme-challenge-test');
 | 
			
		||||
 | 
			
		||||
// The dry-run tests can pass on, literally, 'example.com'
 | 
			
		||||
// but the integration tests require that you have control over the domain
 | 
			
		||||
var domain = "example.com";
 | 
			
		||||
var domain = 'example.com';
 | 
			
		||||
 | 
			
		||||
tester.test("http-01", domain, {
 | 
			
		||||
tester
 | 
			
		||||
  .test('http-01', domain, {
 | 
			
		||||
    // Should set a TXT record for dnsHost with dnsAuthorization and ttl || 300
 | 
			
		||||
    set: function(opts) {
 | 
			
		||||
      console.log('set opts:', opts);
 | 
			
		||||
      throw new Error('set not implemented');
 | 
			
		||||
    },
 | 
			
		||||
 | 
			
		||||
  // Should set a TXT record for opts.dnsHost with opts.dnsAuthorization for opts.ttl || 300
 | 
			
		||||
  set: function (opts) {
 | 
			
		||||
    console.log("set opts:", opts);
 | 
			
		||||
    throw new Error("set not implemented");
 | 
			
		||||
  },
 | 
			
		||||
    // Should remove the *one* TXT record for dnsHost with dnsAuthorization
 | 
			
		||||
    // Should NOT remove otherrecords for dnsHost (wildcard shares dnsHost with
 | 
			
		||||
    // non-wildcard)
 | 
			
		||||
    remove: function(opts) {
 | 
			
		||||
      console.log('remove opts:', opts);
 | 
			
		||||
      throw new Error('remove not implemented');
 | 
			
		||||
    },
 | 
			
		||||
 | 
			
		||||
  // Should remove the *one* TXT record for opts.dnsHost with opts.dnsAuthorization
 | 
			
		||||
  // Should NOT remove otherrecords for opts.dnsHost (wildcard shares dnsHost with non-wildcard)
 | 
			
		||||
  remove: function (opts) {
 | 
			
		||||
    console.log("remove opts:", opts);
 | 
			
		||||
    throw new Error("remove not implemented");
 | 
			
		||||
  },
 | 
			
		||||
  
 | 
			
		||||
  // Should get the record via the DNS server's API
 | 
			
		||||
  get: function (opts) {
 | 
			
		||||
    console.log("get opts:", opts);
 | 
			
		||||
    throw new Error("get not implemented");
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
}).then(function() {
 | 
			
		||||
	console.info("PASS");
 | 
			
		||||
});
 | 
			
		||||
    // Should get the record via the DNS server's API
 | 
			
		||||
    get: function(opts) {
 | 
			
		||||
      console.log('get opts:', opts);
 | 
			
		||||
      throw new Error('get not implemented');
 | 
			
		||||
    }
 | 
			
		||||
  })
 | 
			
		||||
  .then(function() {
 | 
			
		||||
    console.info('PASS');
 | 
			
		||||
  });
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## dns-01 vs http-01
 | 
			
		||||
@ -105,48 +106,80 @@ For `type` dns-01:
 | 
			
		||||
Here's a quick pseudo stub-out of what a test-passing plugin object might look like:
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
tester.test('http-01', 'example.com', {
 | 
			
		||||
  set: function (opts) {
 | 
			
		||||
    var ch = opts.challenge;
 | 
			
		||||
    // { type: 'http-01' // or 'dns-01'
 | 
			
		||||
    // , identifier: { type: 'dns', value: 'example.com' }
 | 
			
		||||
    // , wildcard: false
 | 
			
		||||
    // , token: 'xxxx'
 | 
			
		||||
    // , keyAuthorization: 'xxxx.yyyy'
 | 
			
		||||
    // , dnsHost: '_acme-challenge.example.com'
 | 
			
		||||
    // , dnsAuthorization: 'zzzz' }
 | 
			
		||||
tester
 | 
			
		||||
  .test('http-01', 'example.com', {
 | 
			
		||||
  
 | 
			
		||||
    return API.set(...);
 | 
			
		||||
  }
 | 
			
		||||
, get: function (query) {
 | 
			
		||||
    var ch = query.challenge;
 | 
			
		||||
    // { type: 'http-01' // or 'dns-01', 'tls-alpn-01', etc
 | 
			
		||||
    // , identifier: { type: 'dns', value: 'example.com' }
 | 
			
		||||
    //   // http-01 only
 | 
			
		||||
    // , token: 'xxxx'
 | 
			
		||||
    // , url: '...' // for testing and debugging
 | 
			
		||||
    //   // dns-01 only, for testing / dubgging
 | 
			
		||||
    // , altname: '...'
 | 
			
		||||
    // , dnsHost: '...'
 | 
			
		||||
    // , wildcard: false }
 | 
			
		||||
    // Note: query.identifier.value is different for http-01 than for dns-01
 | 
			
		||||
    set: function(opts) {
 | 
			
		||||
      var ch = opts.challenge;
 | 
			
		||||
      // { type: 'http-01' // or 'dns-01'
 | 
			
		||||
      // , identifier: { type: 'dns', value: 'example.com' }
 | 
			
		||||
      // , wildcard: false
 | 
			
		||||
      // , token: 'xxxx'
 | 
			
		||||
      // , keyAuthorization: 'xxxx.yyyy'
 | 
			
		||||
      // , dnsHost: '_acme-challenge.example.com'
 | 
			
		||||
      // , dnsAuthorization: 'zzzz' }
 | 
			
		||||
 | 
			
		||||
    return API.get(...).then(function (secret) {
 | 
			
		||||
      // http-01
 | 
			
		||||
      return { keyAuthorization: secret };
 | 
			
		||||
      // dns-01
 | 
			
		||||
      //return { dnsAuthorization: secret };
 | 
			
		||||
      return YourApi('POST', 'https://example.com/api/dns/txt', {
 | 
			
		||||
        host: ch.dnsHost,
 | 
			
		||||
        record: ch.dnsAuthorization
 | 
			
		||||
      });
 | 
			
		||||
    },
 | 
			
		||||
    
 | 
			
		||||
    get: function(query) {
 | 
			
		||||
      var ch = query.challenge;
 | 
			
		||||
      // { type: 'http-01' // or 'dns-01', 'tls-alpn-01', etc
 | 
			
		||||
      // , identifier: { type: 'dns', value: 'example.com' }
 | 
			
		||||
      //   // http-01 only
 | 
			
		||||
      // , token: 'xxxx'
 | 
			
		||||
      // , url: '...' // for testing and debugging
 | 
			
		||||
      //   // dns-01 only, for testing / dubgging
 | 
			
		||||
      // , altname: '...'
 | 
			
		||||
      // , dnsHost: '...'
 | 
			
		||||
      // , wildcard: false }
 | 
			
		||||
      // Note: query.identifier.value is different for http-01 than for dns-01
 | 
			
		||||
 | 
			
		||||
      return YourApi('GET', 'https://example.com/api/dns/txt', {
 | 
			
		||||
        host: ch.dnsHost
 | 
			
		||||
      }).then(function(secret) {
 | 
			
		||||
        // http-01
 | 
			
		||||
        return { keyAuthorization: secret };
 | 
			
		||||
        // dns-01
 | 
			
		||||
        //return { dnsAuthorization: secret };
 | 
			
		||||
      });
 | 
			
		||||
    },
 | 
			
		||||
    
 | 
			
		||||
    remove: function(opts) {
 | 
			
		||||
      var ch = opts.challenge;
 | 
			
		||||
      // same options as in `set()` (which are not the same as `get()`
 | 
			
		||||
 | 
			
		||||
      return YourApi('DELETE', 'https://example.com/api/dns/txt/' + ch.dnsHost);
 | 
			
		||||
    }
 | 
			
		||||
  })
 | 
			
		||||
  .then(function() {
 | 
			
		||||
    console.info('PASS');
 | 
			
		||||
  });
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Where `YourApi` might look something like this:
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
var YourApi = function createApi(config) {
 | 
			
		||||
  var request = require('@root/request');
 | 
			
		||||
  request = require('util').promisify(request);
 | 
			
		||||
    
 | 
			
		||||
  return function (method, url, body) {
 | 
			
		||||
    return request({
 | 
			
		||||
      method: method,
 | 
			
		||||
      url: url,
 | 
			
		||||
      json: body || true,
 | 
			
		||||
      headers: {
 | 
			
		||||
        Authorization: 'Bearer ' + config.apiToken
 | 
			
		||||
      }
 | 
			
		||||
    }).then(function(resp) {
 | 
			
		||||
      return resp.body;
 | 
			
		||||
    });
 | 
			
		||||
  }
 | 
			
		||||
, remove: function (opts) {
 | 
			
		||||
    var ch = opts.challenge;
 | 
			
		||||
    // same options as in `set()` (which are not the same as `get()`
 | 
			
		||||
 | 
			
		||||
    return API.remove(...);
 | 
			
		||||
  }
 | 
			
		||||
}).then(function () {
 | 
			
		||||
  console.info("PASS");
 | 
			
		||||
});
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Two notes:
 | 
			
		||||
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user