Internet Engineering Task Force (IETF) G. Brown
Request for Comments: 10037 ICANN
Category: Standards Track August 2026
ISSN: 2070-1721
This document specifies an extension to the Registration Data Access Protocol (RDAP), which allows the Time-to-Live (TTL) values for relevant DNS record types to be included in RDAP responses.
この文書では、登録データ アクセス プロトコル (RDAP) の拡張機能を指定します。これにより、関連する DNS レコード タイプの Time-to-Live (TTL) 値を RDAP 応答に含めることが可能になります。
This is an Internet Standards Track document.
これはインターネット標準化トラックの文書です。
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841.
このドキュメントは Internet Engineering Task Force (IETF) の成果物です。これは IETF コミュニティのコンセンサスを表しています。この文書は公開レビューを受け、Internet Engineering Steering Group (IESG) によって公開が承認されています。インターネット標準の詳細については、RFC 7841 のセクション 2 を参照してください。
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc10037.
この文書の現在のステータス、正誤表、およびそれに対するフィードバックの提供方法に関する情報は、https://www.rfc-editor.org/info/rfc10037 で入手できます。
Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved.
Copyright (c) 2026 IETF Trust および文書の著者として特定された人物。無断転載を禁じます。
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.
この文書は、BCP 78 およびこの文書の発行日に有効な IETF 文書に関する IETF トラストの法的規定 (https://trustee.ietf.org/license-info) の対象となります。これらの文書には、この文書に関するお客様の権利と制限が記載されているため、注意深くお読みください。このドキュメントから抽出されたコード コンポーネントには、トラスト法的規定のセクション 4.e に記載されている改訂 BSD ライセンス テキストが含まれている必要があり、改訂 BSD ライセンスに記載されているように保証なしで提供されます。
1. Introduction
2. Conventions Used in This Document
3. RDAP Response Specification
3.1. DNS Record Types and TTL Values
3.2. RDAP Conformance
4. Operational Considerations
4.1. RDAP Servers
4.2. RDAP Clients
5. IANA Considerations
6. Security Considerations
7. References
7.1. Normative References
7.2. Informative References
Acknowledgements
Author's Address
The Registration Data Access Protocol (RDAP) [STD95] provides access to information about Internet resources (domain names, autonomous system numbers, and IP addresses). While RFC 9083 [STD95] allows RDAP server operators to provide information about the content of the "NS", "DS", "A", and "AAAA" RRset(s) (see Section 5 of [RFC9499]), which are published in the DNS for a given registry object (domain or host object), it does not provide a mechanism to allow the Time-to-Live (TTL) values (see Section 5 of [RFC9499]) of those RRsets to be included in responses. Inclusion of these values in RDAP responses (in addition to nameservers, glue IP addresses, and Delegation Signer (DS) records) allows out-of-band debugging of the DNS configuration of troublesome domain names.
登録データ アクセス プロトコル (RDAP) [STD95] は、インターネット リソース (ドメイン名、自律システム番号、および IP アドレス) に関する情報へのアクセスを提供します。RFC 9083 [STD95] では、RDAP サーバーオペレータが、特定のレジストリオブジェクト (ドメインまたはホストオブジェクト) の DNS で公開される「NS」、「DS」、「A」、および「AAAA」RRset の内容に関する情報を提供することを許可していますが ([RFC9499] のセクション 5 を参照)、Time-to-Live (TTL) 値を許可するメカニズムは提供していません (RFC9499 のセクション 5 を参照)。[RFC9499]) 応答に含まれる RRset の。これらの値を RDAP 応答 (ネームサーバー、グルー IP アドレス、および委任署名者 (DS) レコードに加えて) に含めると、問題のあるドメイン名の DNS 構成のアウトオブバンド デバッグが可能になります。
This document describes how TTL information can be included in domain and nameserver objects in RDAP responses. As per Section 5.2 of [RFC2181], TTL values are applicable to RRsets rather than individual records.
このドキュメントでは、RDAP 応答のドメインおよびネームサーバー オブジェクトに TTL 情報を含める方法について説明します。[RFC2181] のセクション 5.2 に従って、TTL 値は個々のレコードではなく RRset に適用されます。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
このドキュメント内のキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「NOT RECOMMENDED」、「MAY」、および「OPTIONAL」は、ここに示すようにすべて大文字で表示されている場合にのみ、BCP 14 [RFC2119] [RFC8174] で説明されているように解釈されます。
This document uses terms defined in Section 1.1 of RFC 9083 [STD95].
この文書では、RFC 9083 [STD95] のセクション 1.1 で定義されている用語を使用します。
Servers that support this extension MAY include a "ttl0_data" member in any domain (Section 5.3 of RFC 9083 [STD95]) and nameserver (Section 5.2 of RFC 9083 [STD95]) objects included in RDAP responses. As per Section 2.1 of RFC 9083 [STD95], clients that do not implement this specification SHOULD ignore the "ttl0_data" member.
この拡張をサポートするサーバーは、RDAP 応答に含まれる任意のドメイン (RFC 9083 [STD95] のセクション 5.3) およびネームサーバー (RFC 9083 [STD95] のセクション 5.2) オブジェクトに「ttl0_data」メンバーを含めてもよい(MAY)。RFC 9083 [STD95] のセクション 2.1 に従って、この仕様を実装していないクライアントは「ttl0_data」メンバーを無視すべきです(SHOULD)。
The "ttl0_data" member is an object that has the following members:
「ttl0_data」メンバーは、次のメンバーを持つオブジェクトです。
* A "values" member, which is an object that maps DNS record type mnemonics to TTL values; and
* 「values」メンバー。DNS レコード タイプのニーモニックを TTL 値にマップするオブジェクトです。そして
* An OPTIONAL "remarks" member, which is an array of remarks (see Section 4.3 of RFC 9083 [STD95]).
* オプションの「remarks」メンバー。コメントの配列です (RFC 9083 [STD95] のセクション 4.3 を参照)。
As specified in Section 8 of [RFC2181], a TTL value is "an unsigned number, with a minimum value of 0, and a maximum value of 2147483647. That is, a maximum of 2^31 - 1". TTL values MUST be represented as JSON numbers with no fractional component and no exponent notation.
[RFC2181] のセクション 8 で規定されているように、TTL 値は「最小値が 0、最大値が 2147483647 の符号なしの数値です。つまり、最大値は 2^31 - 1」です。TTL 値は、小数部分や指数表記を持たない JSON 数値として表現する必要があります。
The TTL values included in "ttl0_data" members MUST reflect the TTL values as provisioned in the registry database, not the remaining TTL of DNS records as observed from live DNS queries.
「ttl0_data」メンバーに含まれる TTL 値は、ライブ DNS クエリから観察される DNS レコードの残りの TTL ではなく、レジストリ データベースにプロビジョニングされた TTL 値を反映しなければなりません (MUST)。
An example domain object with a valid "ttl0_data" member is provided below. Readers should refer to RFC 9083 [STD95] for a description of the other objects listed in the example.
有効な「ttl0_data」メンバーを持つドメイン オブジェクトの例を以下に示します。この例にリストされている他のオブジェクトの説明については、RFC 9083 [STD95] を参照してください。
{
"objectClassName": "domain",
"rdapConformance": ["rdap_level_0", "ttl0"],
"ldhName": "domain.example",
"ttl0_data": {
"values": {
"NS": 3600,
"DS": 300
},
"remarks": [
{
"description": [
"For more information about the .example",
" registry policy relating to DS record TTL changes,",
"see https://domain.example"
],
"links": [
{
"rel": "related",
"title": ".Example Registry DNS TTL Policy",
"href": "https://domain.example"
}
]
}
]
}
}
An example nameserver object with a valid "ttl0_data" member is provided below.
有効な「ttl0_data」メンバーを持つネームサーバー オブジェクトの例を以下に示します。
{
"objectClassName": "nameserver",
"rdapConformance": ["rdap_level_0", "ttl0"],
"ldhName": "ns1.domain.example",
"ttl0_data": {
"values": {
"A": 86400,
"AAAA": 86400
},
"remarks": [
{
"description": [
"The .example registry does not permit TTL ",
"values for nameservers to be changed."
]
}
]
}
}
The DNS record type mnemonics that appear as the member names in "values" objects MUST be in all capitals and MUST be registered with IANA in [IANA-RRTYPES]. TTL values MUST be unsigned integers in the range 0-2147483647 as per Section 8 of [RFC2181].
「値」オブジェクトのメンバー名として表示される DNS レコード タイプのニーモニックはすべて大文字でなければならず、[IANA-RRTYPES] で IANA に登録されなければなりません。[RFC2181] のセクション 8 に従って、TTL 値は 0-2147483647 の範囲の符号なし整数でなければなりません (MUST)。
Servers returning responses containing TTL values MUST include the string "ttl0" in the "rdapConformance" array.
TTL 値を含む応答を返すサーバーは、「rdapConformance」配列に文字列「ttl0」を含める必要があります。
This specification is complementary to the Extensible Provisioning Protocol (EPP) [RFC5730] and the EPP Mapping for DNS Time-to-Live (TTL) Values [RFC9803], but registry operators do not need to implement that extension in their EPP servers in order to implement this RDAP extension.
この仕様は、Extensible Provisioning Protocol (EPP) [RFC5730] および DNS Time-to-Live (TTL) 値の EPP マッピング [RFC9803] を補完するものですが、レジストリ オペレータは、この RDAP 拡張機能を実装するために EPP サーバーにその拡張機能を実装する必要はありません。
Many RDAP clients make use of frameworks, which automatically "hydrate" objects using JSON data received in RDAP responses. As a result, RDAP clients that use these frameworks should explicitly carve out the "values" member of "ttl0_data" members.
多くの RDAP クライアントは、RDAP 応答で受信した JSON データを使用してオブジェクトを自動的に「ハイドレート」するフレームワークを利用します。結果として、これらのフレームワークを使用する RDAP クライアントは、「ttl0_data」メンバーの「values」メンバーを明示的に切り出す必要があります。
Since the list of record types appearing in "ttl0_data" members may change with time, clients that implement this extension MUST accept responses containing values for all valid DNS record types and SHOULD periodically update the list of valid DNS record types to align with [IANA-RRTYPES], to avoid discarding a recently added record type.
"ttl0_data" メンバーに表示されるレコード タイプのリストは時間とともに変更される可能性があるため、この拡張機能を実装するクライアントは、すべての有効な DNS レコード タイプの値を含む応答を受け入れなければなりません (MUST)。また、最近追加されたレコード タイプが破棄されることを避けるために、有効な DNS レコード タイプのリストを [IANA-RRTYPES] に合わせて定期的に更新する必要があります (SHOULD)。
IANA has registered the following value in the "RDAP Extensions" registry [IANA-RDAP-EXTENSIONS]:
IANA は、「RDAP Extensions」レジストリ [IANA-RDAP-EXTENSIONS] に次の値を登録しました。
Extension Identifier:
拡張機能の識別子:
ttl0
ttl0
Registry Operator:
レジストリオペレーター:
Any
どれでも
Specification:
仕様:
RFC 10037
RFC 10037
Contact:
接触:
IETF <mailto:iesg@ietf.org>
IETF <mailto:iesg@ietf.org>
Intended Usage:
使用目的:
This extension describes how DNS TTL values can be included in RDAP responses.
この拡張機能では、DNS TTL 値を RDAP 応答に含める方法について説明します。
Security services for the extension specified in this document are described in RFC 7481 [STD95].
この文書で指定された拡張機能のセキュリティ サービスは、RFC 7481 [STD95] で説明されています。
This document only concerns itself with the representation of configured TTL values for domain and host objects. The security implications of how those TTL values are determined, assigned, or modified within a registry system are out of scope. Readers are referred to Section 6 of [RFC9803] for further discussion.
このドキュメントは、ドメインおよびホスト オブジェクトに対して構成された TTL 値の表現のみに関係します。レジストリ システム内でこれらの TTL 値がどのように決定、割り当て、または変更されるかによるセキュリティへの影響は範囲外です。詳細については、[RFC9803] のセクション 6 を参照してください。
[IANA-RDAP-EXTENSIONS]
IANA, "RDAP Extensions",
<https://www.iana.org/assignments/rdap-extensions>.
[IANA-RRTYPES]
IANA, "Resource Record (RR) TYPEs",
<https://www.iana.org/assignments/dns-parameters>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
[RFC2181] Elz, R. and R. Bush, "Clarifications to the DNS
Specification", RFC 2181, DOI 10.17487/RFC2181, July 1997,
<https://www.rfc-editor.org/info/rfc2181>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC9499] Hoffman, P. and K. Fujiwara, "DNS Terminology", BCP 219,
RFC 9499, DOI 10.17487/RFC9499, March 2024,
<https://www.rfc-editor.org/info/rfc9499>.
[STD95] Internet Standard 95,
<https://www.rfc-editor.org/info/std95>.
At the time of writing, this STD comprises the following:
Newton, A., Ellacott, B., and N. Kong, "HTTP Usage in the
Registration Data Access Protocol (RDAP)", STD 95,
RFC 7480, DOI 10.17487/RFC7480, March 2015,
<https://www.rfc-editor.org/info/rfc7480>.
Hollenbeck, S. and N. Kong, "Security Services for the
Registration Data Access Protocol (RDAP)", STD 95,
RFC 7481, DOI 10.17487/RFC7481, March 2015,
<https://www.rfc-editor.org/info/rfc7481>.
Hollenbeck, S. and A. Newton, "Registration Data Access
Protocol (RDAP) Query Format", STD 95, RFC 9082,
DOI 10.17487/RFC9082, June 2021,
<https://www.rfc-editor.org/info/rfc9082>.
Hollenbeck, S. and A. Newton, "JSON Responses for the
Registration Data Access Protocol (RDAP)", STD 95,
RFC 9083, DOI 10.17487/RFC9083, June 2021,
<https://www.rfc-editor.org/info/rfc9083>.
Blanchet, M., "Finding the Authoritative Registration Data
Access Protocol (RDAP) Service", STD 95, RFC 9224,
DOI 10.17487/RFC9224, March 2022,
<https://www.rfc-editor.org/info/rfc9224>.
[RFC5730] Hollenbeck, S., "Extensible Provisioning Protocol (EPP)",
STD 69, RFC 5730, DOI 10.17487/RFC5730, August 2009,
<https://www.rfc-editor.org/info/rfc5730>.
[RFC9803] Brown, G., "Extensible Provisioning Protocol (EPP) Mapping
for DNS Time-to-Live (TTL) Values", RFC 9803,
DOI 10.17487/RFC9803, June 2025,
<https://www.rfc-editor.org/info/rfc9803>.
The author wishes to thank the following for their constructive feedback and advice during the development of this document: Andy Newton, Pawel Kowalik, Maarten Wullink, Mohamed Boucadair, Vijay K. Gurbani, Di Ma, Nabeel Cocker, Ketan Talaulikar, Ralf Weber, Mike Bishop, Mahesh Jethanandani, and Éric Vyncke.
著者は、この文書の作成中に建設的なフィードバックとアドバイスをいただいた次の方々に感謝します: Andy Newton、Pawel Kowalik、Maarten Wullink、Mohamed Boucadair、Vijay K. Gurbani、Di Ma、Nabeel Cocker、Ketan Talaulikar、Ralf Weber、Mike Bishop、Mahesh Jethanandani、および Éric Vyncke。
Gavin Brown
ICANN
12025 Waterfront Drive, Suite 300
Los Angeles, CA 90094-2536
United States of America
Email: gavin.brown@icann.org