mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2024-05-11 05:55:12 +00:00
33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
|
---
|
||
|
|
name: HTTPS
|
||
|
|
parameters:
|
||
|
|
- name
|
||
|
|
- priority
|
||
|
|
- target
|
||
|
|
- params
|
||
|
|
- modifiers...
|
||
|
|
parameter_types:
|
||
|
|
name: string
|
||
|
|
priority: number
|
||
|
|
target: string
|
||
|
|
params: string
|
||
|
|
"modifiers...": 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](../top-level-functions/IP.md).
|
||
|
|
|
||
|
|
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](https://docs.dnscontrol.org/language-reference/record-modifiers) or JSON objects, which will be merged into the record's metadata.
|
||
|
|
|
||
|
|
{% code title="dnsconfig.js" %}
|
||
|
|
```javascript
|
||
|
|
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 %}
|