Extended DNS Errors
RFC 8914
Document | Type | RFC - Proposed Standard (October 2020; No errata) | |
---|---|---|---|
Authors | Warren Kumari , Evan Hunt , Roy Arends , Wes Hardaker , David Lawrence | ||
Last updated | 2020-10-23 | ||
Replaces | draft-wkumari-dnsop-extended-error | ||
Stream | IETF | ||
Formats | plain text html xml pdf htmlized bibtex | ||
Reviews | |||
Stream | WG state | Submitted to IESG for Publication | |
Document shepherd | Tim Wicinski | ||
Shepherd write-up | Show (last changed 2020-03-08) | ||
IESG | IESG state | RFC 8914 (Proposed Standard) | |
Action Holders |
(None)
|
||
Consensus Boilerplate | Yes | ||
Telechat date | |||
Responsible AD | Barry Leiba | ||
Send notices to | Tim Wicinski <tjw.ietf@gmail.com> | ||
IANA | IANA review state | Version Changed - Review Needed | |
IANA action state | RFC-Ed-Ack | ||
IANA expert review state | Expert Reviews OK |
Internet Engineering Task Force (IETF) W. Kumari Request for Comments: 8914 Google Category: Standards Track E. Hunt ISSN: 2070-1721 ISC R. Arends ICANN W. Hardaker USC/ISI D. Lawrence Salesforce October 2020 Extended DNS Errors Abstract This document defines an extensible method to return additional information about the cause of DNS errors. Though created primarily to extend SERVFAIL to provide additional information about the cause of DNS and DNSSEC failures, the Extended DNS Errors option defined in this document allows all response types to contain extended error information. Extended DNS Error information does not change the processing of RCODEs. Status of This Memo 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. 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/rfc8914. Copyright Notice Copyright (c) 2020 IETF Trust and the persons identified as the document authors. All rights reserved. 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 Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction and Background 1.1. Requirements Notation 2. Extended DNS Error EDNS0 Option Format 3. Extended DNS Error Processing 4. Defined Extended DNS Errors 4.1. Extended DNS Error Code 0 - Other 4.2. Extended DNS Error Code 1 - Unsupported DNSKEY Algorithm 4.3. Extended DNS Error Code 2 - Unsupported DS Digest Type 4.4. Extended DNS Error Code 3 - Stale Answer 4.5. Extended DNS Error Code 4 - Forged Answer 4.6. Extended DNS Error Code 5 - DNSSEC Indeterminate 4.7. Extended DNS Error Code 6 - DNSSEC Bogus 4.8. Extended DNS Error Code 7 - Signature Expired 4.9. Extended DNS Error Code 8 - Signature Not Yet Valid 4.10. Extended DNS Error Code 9 - DNSKEY Missing 4.11. Extended DNS Error Code 10 - RRSIGs Missing 4.12. Extended DNS Error Code 11 - No Zone Key Bit Set 4.13. Extended DNS Error Code 12 - NSEC Missing 4.14. Extended DNS Error Code 13 - Cached Error 4.15. Extended DNS Error Code 14 - Not Ready 4.16. Extended DNS Error Code 15 - Blocked 4.17. Extended DNS Error Code 16 - Censored 4.18. Extended DNS Error Code 17 - Filtered 4.19. Extended DNS Error Code 18 - Prohibited 4.20. Extended DNS Error Code 19 - Stale NXDOMAIN Answer 4.21. Extended DNS Error Code 20 - Not Authoritative 4.22. Extended DNS Error Code 21 - Not Supported 4.23. Extended DNS Error Code 22 - No Reachable Authority 4.24. Extended DNS Error Code 23 - Network Error 4.25. Extended DNS Error Code 24 - Invalid Data 5. IANA Considerations 5.1. A New Extended DNS Error Code EDNS Option 5.2. New Registry for Extended DNS Error Codes 6. Security Considerations 7. References 7.1. Normative References 7.2. Informative References Acknowledgements Authors' Addresses 1. Introduction and Background There are many reasons that a DNS query may fail -- some of them transient, some permanent; some can be resolved by querying another server, some are likely best handled by stopping resolution. Unfortunately, the error signals that a DNS server can return are very limited and are not very expressive. This means that applications and resolvers often have to "guess" at what the issue is, e.g., was the answer marked REFUSED because of a lame delegation or because the nameserver is still starting up and loading zones? IsShow full document text