adulau/pdns-qof
1
0
Fork 0
mirror of https://github.com/adulau/pdns-qof.git synced 2024-11-22 18:17:04 +00:00
Code Issues Projects Releases Packages Wiki Activity

typos, initials, minor re-phrasing

Browse source
This commit is contained in:
Aaron Kaplan 2013-12-25 15:36:38 +01:00
parent 14011911a6
commit ee596ae2b1
2 changed files with 28 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
i-d/pdns-qof.txt
View file

@ -1,25 +1,28 @@
Internet Engineering Task Force Dulaunoy Internet Engineering Task Force A. Dulaunoy
Internet-Draft CIRCL Internet-Draft CIRCL
Intended status: Informational Kaplan Intended status: Informational A. Kaplan
Expires: June 28, 2014 CERT.at Expires: June 28, 2014 CERT.at
Vixie P. Vixie
Farsight Security, Inc. Farsight Security, Inc.
hs. Stern H. Stern
Cisco Cisco
December 25, 2013 December 25, 2013
Passive DNS - Common Output Format Passive DNS - Common Output Format
draft-ietf-dulaunoy-passive-dns-cof-00 draft-ietf-dulaunoy-kaplan-pDNS-cof-00
Abstract Abstract
This document describes the output format used between Passive DNS This document describes a common output format of Passive DNS Servers
query interfaces. The output format description includes also a which clients can query. The output format description includes also
common meaning per Passive DNS system. in addition a common semantic for each Passive DNS system. By having
multiple Passive DNS Systems adhere to the same output format for
queries, users of multiple Passive DNS servers will be able to
combine result sets easily.
Status of this Memo Status of this Memo
@ -46,9 +49,6 @@ Copyright Notice
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://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
@ -57,6 +57,9 @@ Dulaunoy, et al. Expires June 28, 2014 [Page 1]
Internet-Draft Passive DNS - Common Output Format December 2013 Internet-Draft Passive DNS - Common Output Format December 2013
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 include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
@ -105,9 +108,6 @@ Table of Contents
Dulaunoy, et al. Expires June 28, 2014 [Page 2] Dulaunoy, et al. Expires June 28, 2014 [Page 2]
Internet-Draft Passive DNS - Common Output Format December 2013 Internet-Draft Passive DNS - Common Output Format December 2013
@ -119,10 +119,10 @@ Internet-Draft Passive DNS - Common Output Format December 2013
Passive DNS replication, F Weimer - 17th Annual FIRST Conference on Passive DNS replication, F Weimer - 17th Annual FIRST Conference on
Computer Security [WEINERPDNS]. Since then multiple Passive DNS Computer Security [WEINERPDNS]. Since then multiple Passive DNS
implementations evolved over time. Users of these Passive DNS implementations evolved over time. Users of these Passive DNS
servers query a server (often via WHOIS [RFC3912] or HTTP REST servers may query a server (often via WHOIS [RFC3912] or HTTP REST
[REST]), parse the results and process them in other applications. [REST]), parse the results and process them in other applications.
There are multiple implementation of Passive DNS software. Users of There are multiple implementations of Passive DNS software. Users of
passive DNS query each implementation and aggregate the results for passive DNS query each implementation and aggregate the results for
their search. This document describes the output format of four their search. This document describes the output format of four
Passive DNS Systems ([DNSDB],[PDNSCERTAT], [PDNSCIRCL] and [PDNSCOF]) Passive DNS Systems ([DNSDB],[PDNSCERTAT], [PDNSCIRCL] and [PDNSCOF])
@ -130,8 +130,8 @@ Internet-Draft Passive DNS - Common Output Format December 2013
output format. As the format and the meaning of output fields from output format. As the format and the meaning of output fields from
each Passive DNS need to be consistent, we propose in this document a each Passive DNS need to be consistent, we propose in this document a
solution to commonly name each field along with their corresponding solution to commonly name each field along with their corresponding
interpretation. The format is following a simple key-value structure interpretation. The format follows a simple key-value structure in
in JSON [RFC4627] format. The benefit of having a consistent Passive JSON [RFC4627] format. The benefit of having a consistent Passive
DNS output format is that multiple client implementations can query DNS output format is that multiple client implementations can query
different servers without having to have a separate parser for each different servers without having to have a separate parser for each
individual server. passivedns-client [PDNSCLIENT]currently implements individual server. passivedns-client [PDNSCLIENT]currently implements
@ -449,7 +449,7 @@ Dulaunoy, et al. Expires June 28, 2014 [Page 8]
Internet-Draft Passive DNS - Common Output Format December 2013 Internet-Draft Passive DNS - Common Output Format December 2013
Leon Aaron Kaplan L. Aaron Kaplan
CERT.at CERT.at
Karlsplatz 1/2/9 Karlsplatz 1/2/9
Vienna, A-1010 Vienna, A-1010

18
i-d/pdns-qof.xml
View file

@ -44,7 +44,7 @@
<?rfc subcompact="no" ?> <?rfc subcompact="no" ?>
<!-- keep one blank line between list items --> <!-- keep one blank line between list items -->
<!-- end of list of popular I-D processing instructions --> <!-- end of list of popular I-D processing instructions -->
<rfc category="info" docName="draft-ietf-dulaunoy-passive-dns-cof-00" ipr="trust200902"> <rfc category="info" docName="draft-ietf-dulaunoy-kaplan-pDNS-cof-00" ipr="trust200902">
<!-- category values: std, bcp, info, exp, and historic <!-- category values: std, bcp, info, exp, and historic
ipr values: full3667, noModification3667, noDerivatives3667 ipr values: full3667, noModification3667, noDerivatives3667
you can add the attributes updates="NNNN" and obsoletes="NNNN" you can add the attributes updates="NNNN" and obsoletes="NNNN"
@ -54,7 +54,7 @@
<front> <front>
<title abbrev="Passive DNS - Common Output Format">Passive DNS - Common Output Format</title> <title abbrev="Passive DNS - Common Output Format">Passive DNS - Common Output Format</title>
<author fullname="Alexandre Dulaunoy" initials="" <author fullname="Alexandre Dulaunoy" initials="A."
surname="Dulaunoy"> surname="Dulaunoy">
<organization>CIRCL</organization> <organization>CIRCL</organization>
<address> <address>
@ -73,7 +73,7 @@
</author> </author>
<author fullname="Leon Aaron Kaplan" initials="" <author fullname="L. Aaron Kaplan" initials="A."
surname="Kaplan"> surname="Kaplan">
<organization>CERT.at</organization> <organization>CERT.at</organization>
<address> <address>
@ -90,7 +90,7 @@
</address> </address>
</author> </author>
<author fullname="Paul Vixie" initials="" <author fullname="Paul Vixie" initials="P."
surname="Vixie"> surname="Vixie">
<organization>Farsight Security, Inc.</organization> <organization>Farsight Security, Inc.</organization>
<address> <address>
@ -107,7 +107,7 @@
</address> </address>
</author> </author>
<author fullname="Henry Stern" initials="hs" surname="Stern"> <author fullname="Henry Stern" initials="H." surname="Stern">
<organization>Cisco</organization> <organization>Cisco</organization>
<address> <address>
<postal> <postal>
@ -132,17 +132,17 @@
<abstract> <abstract>
<t>This document describes the output format used between Passive DNS query interfaces. The output format description includes also a common meaning per Passive DNS system.</t> <t>This document describes a common output format of Passive DNS Servers which clients can query. The output format description includes also in addition a common semantic for each Passive DNS system. By having multiple Passive DNS Systems adhere to the same output format for queries, users of multiple Passive DNS servers will be able to combine result sets easily.</t>
</abstract> </abstract>
</front> </front>
<middle> <middle>
<section title="Introduction"> <section title="Introduction">
<t>Passive DNS is a technique described by Florian Weimer in 2005 in <xref target="WEINERPDNS">Passive DNS replication, F Weimer - 17th Annual FIRST Conference on Computer Security</xref>. Since then multiple Passive DNS implementations evolved over time. Users of these Passive DNS servers query a server (often via <xref target="RFC3912">WHOIS</xref> or HTTP <xref target="REST">REST</xref>), parse the results and process them in other applications.</t> <t>Passive DNS is a technique described by Florian Weimer in 2005 in <xref target="WEINERPDNS">Passive DNS replication, F Weimer - 17th Annual FIRST Conference on Computer Security</xref>. Since then multiple Passive DNS implementations evolved over time. Users of these Passive DNS servers may query a server (often via <xref target="RFC3912">WHOIS</xref> or HTTP <xref target="REST">REST</xref>), parse the results and process them in other applications.</t>
<t> <t>
There are multiple implementation of Passive DNS software. Users of passive DNS query each implementation and aggregate the results for their search. This document describes the output format of four Passive DNS Systems (<xref target="DNSDB"/>,<xref target="PDNSCERTAT"/>, <xref target="PDNSCIRCL"/> and <xref target="PDNSCOF"/>) which are in use today and which already share a nearly identical output format. There are multiple implementations of Passive DNS software. Users of passive DNS query each implementation and aggregate the results for their search. This document describes the output format of four Passive DNS Systems (<xref target="DNSDB"/>,<xref target="PDNSCERTAT"/>, <xref target="PDNSCIRCL"/> and <xref target="PDNSCOF"/>) which are in use today and which already share a nearly identical output format.
As the format and the meaning of output fields from each Passive DNS need to be consistent, we propose in this document a solution to commonly name each field along with their corresponding interpretation. The format is following a simple key-value structure in <xref target="RFC4627">JSON</xref> format. As the format and the meaning of output fields from each Passive DNS need to be consistent, we propose in this document a solution to commonly name each field along with their corresponding interpretation. The format follows a simple key-value structure in <xref target="RFC4627">JSON</xref> format.
The benefit of having a consistent Passive DNS output format is that multiple client implementations can query different servers without having to have a separate parser for each The benefit of having a consistent Passive DNS output format is that multiple client implementations can query different servers without having to have a separate parser for each
individual server. <xref target="PDNSCLIENT">passivedns-client</xref>currently implements multiple parsers due to a lack of standardization. individual server. <xref target="PDNSCLIENT">passivedns-client</xref>currently implements multiple parsers due to a lack of standardization.