1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Julius Rickert 20dad35167 Replace Jekyll highlight tags with fenced code blocks (#1412)
* Replace Jekyll highlight tags with fenced code blocks

Replace Jekyll highlight tags with fenced code blocks.
Canonicalize javascript to js.
Correct highlighting languages.
Add highlighting to code blocks.
Remove leading $ from bash blocks.
Remove empty lines at start and end of code blocks.
Stripped trailing whitespace.

* Fix language of code highlighting
2022-02-17 12:22:31 -05:00

2.2 KiB

name parameters
getConfiguredDomains
name
modifiers...

getConfiguredDomains getConfiguredDomains is a helper function that returns the domain names configured at the time the function is called. Calling this function early or later in dnsconfig.js may return different results. Typical usage is to iterate over all domains at the end of your configuration file.

Example for adding records to all configured domains: {% include startExample.html %}

var domains = getConfiguredDomains();
for(i = 0; i < domains.length; i++) {
  D_EXTEND(domains[i],
    TXT('_important', 'BLA') // I know, not really creative.
  )
}

This will end up in following modifications:

******************** Domain: domain1.tld
----- Getting nameservers from: registrar
----- DNS Provider: registrar...2 corrections
#1: CREATE TXT _important.domain1.tld "BLA" ttl=43200
#2: REFRESH zone domain1.tld

******************** Domain: domain2.tld
----- Getting nameservers from: registrar
----- DNS Provider: registrar...2 corrections
#1: CREATE TXT _important.domain2.tld "BLA" ttl=43200
#2: REFRESH zone domain2.tld

{% include endExample.html %}

Example for adding DMARC report records: {% include startExample.html %} This example might be more useful, specially for configuring the DMARC report records. According to DMARC RFC you need to specify domain2.tld._report.dmarc.domain1.tld to allow domain2.tld to send aggregate/forensic email reports to domain1.tld. This can be used to do this in an easy way, without using the wildcard from the RFC.

var domains = getConfiguredDomains();
for(i = 0; i < domains.length; i++) {
	D_EXTEND("domain1.tld",
		TXT(domains[i] + '._report._dmarc', 'v=DMARC1')
	);
}

This will end up in following modifications:

******************** Domain: domain2.tld
----- Getting nameservers from: registrar
----- DNS Provider: registrar...4 corrections
#1: CREATE TXT domain1.tld._report._dmarc.domain2.tld "v=DMARC1" ttl=43200
#2: CREATE TXT domain3.tld._report._dmarc.domain2.tld "v=DMARC1" ttl=43200
#3: CREATE TXT domain4.tld._report._dmarc.domain2.tld "v=DMARC1" ttl=43200
#4: REFRESH zone domain2.tld

{% include endExample.html %}