1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Files
stackexchange-dnscontrol/documentation/language-reference/domain-modifiers/HTTPS.md
Florian Ritterhoff 3a9b413175 NEW RECORD TYPE: HTTPS & SVCB (#2919)
Thanks so much for this contribution!  I have a feeling that a lot of people are going to need these records soon!
2024-05-01 11:37:15 -04:00

1.2 KiB

name, parameters, parameter_types
name parameters parameter_types
HTTPS
name
priority
target
params
modifiers...
name priority target params modifiers...
string number string string RecordModifier[]

HTTPS adds an HTTPS record to a domain. The name should be the relative label for the record. Use @ for the domain apex. The HTTPS record is a special form of the SVCB resource record.

The priority must be a positive number, the address should be an ip address, either a string, or a numeric value obtained via IP.

The params may be configured to specify the alpn, ipv4hint, ipv6hint, ech or port setting. Several params may be joined by a space. Not existing params may be specified as an empty string ""

Modifiers can be any number of record modifiers or JSON objects, which will be merged into the record's metadata.

{% code title="dnsconfig.js" %}

D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
  HTTPS("@", 1, ".", "ipv4hint=123.123.123.123 alpn=h3,h2 port=443"),
  HTTPS("@", 1, "test.com", "")
);

{% endcode %}