Skip to content

Feature/dns caa #35466

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
lxdicted wants to merge 11 commits into from
Closed

Feature/dns caa #35466

Changes from 1 commit
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
b5de9b4
Backport CAA parsing from c-ares
lxdicted Oct 2, 2020
08d2e88
Added support for resolving DNS CAA records
lxdicted Oct 2, 2020
5a08eaa
Fixed a typo
lxdicted Oct 2, 2020
9218871
Whitespace changes
lxdicted Oct 2, 2020
eaafda6
Added missing types
lxdicted Oct 2, 2020
71f350b
Partially reverted change
lxdicted Oct 2, 2020
bb9a6ec
Documentation update
lxdicted Oct 2, 2020
87db47d
MacOS compile fix
lxdicted Oct 3, 2020
5e52515
Fixed documentation version
lxdicted Oct 4, 2020
d1e115f
Allow parsing of CAA records when queying ANY
lxdicted Oct 4, 2020
1e18c47
Documentation update
lxdicted Oct 4, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Documentation update
  • Loading branch information
@lxdicted
lxdicted committed Oct 2, 2020
commit bb9a6ecdc26dc857b421eb8d059af8beb69e2afa
20 changes: 18 additions & 2 deletions doc/api/dns.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -290,8 +290,8 @@ records. The type and structure of individual results varies based on `rrtype`:
| `'A'` | IPv4 addresses (default) | {string} | [`dns.resolve4()`][] |
| `'AAAA'` | IPv6 addresses | {string} | [`dns.resolve6()`][] |
| `'ANY'` | any records | {Object} | [`dns.resolveAny()`][] |
| `'CAA'` | CA authorization records | {Object} | [`dns.resolveCaa()`][] |
| `'CNAME'` | canonical name records | {string} | [`dns.resolveCname()`][] |
| `'CAA'` | CA authorization | {Object} | [`dns.resolveCaa()`][] |
| `'MX'` | mail exchange records | {Object} | [`dns.resolveMx()`][] |
| `'NAPTR'` | name authority pointer records | {Object} | [`dns.resolveNaptr()`][] |
| `'NS'` | name server records | {string} | [`dns.resolveNs()`][] |
Expand Down Expand Up @@ -418,7 +418,7 @@ will contain an array of canonical name records available for the `hostname`

## `dns.resolveCaa(hostname, callback)`
<!-- YAML
added: v0.3.2
added: v15.0.0
Comment thread
addaleax marked this conversation as resolved.
Outdated
-->

* `hostname` {string}
Expand Down Expand Up @@ -682,6 +682,7 @@ The following methods from the `dnsPromises` API are available:
* [`resolver.resolve4()`][`dnsPromises.resolve4()`]
* [`resolver.resolve6()`][`dnsPromises.resolve6()`]
* [`resolver.resolveAny()`][`dnsPromises.resolveAny()`]
* [`resolver.resolveCaa()`][`dnsPromises.resolveCaa()`]
* [`resolver.resolveCname()`][`dnsPromises.resolveCname()`]
* [`resolver.resolveMx()`][`dnsPromises.resolveMx()`]
* [`resolver.resolveNaptr()`][`dnsPromises.resolveNaptr()`]
Expand Down Expand Up @@ -823,6 +824,7 @@ based on `rrtype`:
| `'A'` | IPv4 addresses (default) | {string} | [`dnsPromises.resolve4()`][] |
| `'AAAA'` | IPv6 addresses | {string} | [`dnsPromises.resolve6()`][] |
| `'ANY'` | any records | {Object} | [`dnsPromises.resolveAny()`][] |
| `'CAA'` | CA authorization records | {Object} | [`dnsPromises.resolveCaa()`][] |
| `'CNAME'` | canonical name records | {string} | [`dnsPromises.resolveCname()`][] |
| `'MX'` | mail exchange records | {Object} | [`dnsPromises.resolveMx()`][] |
| `'NAPTR'` | name authority pointer records | {Object} | [`dnsPromises.resolveNaptr()`][] |
Expand Down Expand Up @@ -912,6 +914,18 @@ Here is an example of the result object:
minttl: 60 } ]
```

## `dnsPromises.resolveCaa(hostname)`
<!-- YAML
added: v15.0.0
Comment thread
addaleax marked this conversation as resolved.
Outdated
-->

* `hostname` {string}

Uses the DNS protocol to resolve `CAA` records for the `hostname`. The
`addresses` argument passed to the `callback` function
Comment thread
aduh95 marked this conversation as resolved.
Outdated
will contain an array of certification authority authorization records
available for the `hostname` (e.g. `[{critial: 0, iodef: 'letsencrypt.org']`).

### `dnsPromises.resolveCname(hostname)`
<!-- YAML
added: v10.6.0
Expand Down Expand Up @@ -1186,6 +1200,7 @@ uses. For instance, _they do not use the configuration from `/etc/hosts`_.
[`dns.resolve4()`]: #dns_dns_resolve4_hostname_options_callback
[`dns.resolve6()`]: #dns_dns_resolve6_hostname_options_callback
[`dns.resolveAny()`]: #dns_dns_resolveany_hostname_callback
[`dns.resolveCaa()`]: #dns_dns_resolvecaa_hostname_callback
[`dns.resolveCname()`]: #dns_dns_resolvecname_hostname_callback
[`dns.resolveMx()`]: #dns_dns_resolvemx_hostname_callback
[`dns.resolveNaptr()`]: #dns_dns_resolvenaptr_hostname_callback
Expand All @@ -1202,6 +1217,7 @@ uses. For instance, _they do not use the configuration from `/etc/hosts`_.
[`dnsPromises.resolve4()`]: #dns_dnspromises_resolve4_hostname_options
[`dnsPromises.resolve6()`]: #dns_dnspromises_resolve6_hostname_options
[`dnsPromises.resolveAny()`]: #dns_dnspromises_resolveany_hostname
[`dnsPromises.resolveCaa()`]: #dns_dnspromises_resolvecaa_hostname
[`dnsPromises.resolveCname()`]: #dns_dnspromises_resolvecname_hostname
[`dnsPromises.resolveMx()`]: #dns_dnspromises_resolvemx_hostname
[`dnsPromises.resolveNaptr()`]: #dns_dnspromises_resolvenaptr_hostname
Expand Down