mirror/stackexchange-dnscontrol
1
0
Fork 0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Code Issues Releases Activity

MSDNS: Fix failing DNS integration tests (#2734)

Browse Source
This commit is contained in:
Tom Limoncelli
2023-12-18 12:39:48 -05:00
committed by GitHub
parent 0ca55815f8
commit 258654532a
4 changed files with 80 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
commands/types/dnscontrol.d.ts vendored
View File

@@ -377,7 +377,7 @@ declare function CAA(name: string, tag: "issue" | "issuewild" | "iodef", value:
*
* ## Example
*
* For example you can use:
* ### Simple example
*
* ```javascript
* CAA_BUILDER({
@@ -392,7 +392,62 @@ declare function CAA(name: string, tag: "issue" | "issuewild" | "iodef", value:
* })
* ```
*
* The parameters are:
* `CAA_BUILDER()` builds multiple records:
*
* ```javascript
* CAA("@", "iodef", "mailto:test@example.com", CAA_CRITICAL)
* CAA("@", "issue", "letsencrypt.org")
* CAA("@", "issue", "comodoca.com")
* CAA("@", "issuewild", ";")
* ```
*
* which in turns yield the following records:
*
* ```text
* @ 300 IN CAA 128 iodef "mailto:test@example.com"
* @ 300 IN CAA 0 issue "letsencrypt.org"
* @ 300 IN CAA 0 issue "comodoca.com"
* @ 300 IN CAA 0 issuewild ";"
* ```
*
* ### Example with CAA_CRITICAL flag on all records
*
* The same example can be enriched with CAA_CRITICAL on all records:
*
* ```javascript
* CAA_BUILDER({
* label: "@",
* iodef: "mailto:test@example.com",
* iodef_critical: true,
* issue: [
* "letsencrypt.org",
* "comodoca.com",
* ],
* issue_critical: true,
* issuewild: "none",
* issuewild_critical: true,
* })
* ```
*
* `CAA_BUILDER()` then builds (the same) multiple records - all with CAA_CRITICAL flag set:
*
* ```javascript
* CAA("@", "iodef", "mailto:test@example.com", CAA_CRITICAL)
* CAA("@", "issue", "letsencrypt.org", CAA_CRITICAL)
* CAA("@", "issue", "comodoca.com", CAA_CRITICAL)
* CAA("@", "issuewild", ";", CAA_CRITICAL)
* ```
*
* which in turns yield the following records:
*
* ```text
* @ 300 IN CAA 128 iodef "mailto:test@example.com"
* @ 300 IN CAA 128 issue "letsencrypt.org"
* @ 300 IN CAA 128 issue "comodoca.com"
* @ 300 IN CAA 128 issuewild ";"
* ```
*
* ### Parameters
*
* * `label:` The label of the CAA record. (Optional. Default: `"@"`)
* * `iodef:` Report all violation to configured mail address.
@@ -402,15 +457,6 @@ declare function CAA(name: string, tag: "issue" | "issuewild" | "iodef", value:
* * `issuewild:` An array of CAs which are allowed to issue wildcard certificates. (Can be simply `"none"` to refuse issuing wildcard certificates for all CAs)
* * `issuewild_critical:` This can be `true` or `false`. If enabled and CA does not support this record, then certificate issue will be refused. (Optional. Default: `false`)
*
* `CAA_BUILDER()` returns multiple records (when configured as example above):
*
* ```javascript
* CAA("@", "iodef", "mailto:test@example.com", CAA_CRITICAL)
* CAA("@", "issue", "letsencrypt.org")
* CAA("@", "issue", "comodoca.com")
* CAA("@", "issuewild", ";")
* ```
*
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/caa_builder
*/
declare function CAA_BUILDER(opts: { label?: string; iodef: string; iodef_critical?: boolean; issue: string[]; issue_critical?: boolean; issuewild: string[]; issuewild_critical?: boolean }): DomainModifier;