| < draft-ietf-repute-query-http-08.txt | draft-ietf-repute-query-http-09.txt > | |||
|---|---|---|---|---|
| REPUTE Working Group N. Borenstein | REPUTE Working Group N. Borenstein | |||
| Internet-Draft Mimecast | Internet-Draft Mimecast | |||
| Intended status: Standards Track M. Kucherawy | Intended status: Standards Track M. Kucherawy | |||
| Expires: January 4, 2014 July 3, 2013 | Expires: January 13, 2014 July 12, 2013 | |||
| A Reputation Query Protocol | A Reputation Query Protocol | |||
| draft-ietf-repute-query-http-08 | draft-ietf-repute-query-http-09 | |||
| Abstract | Abstract | |||
| This document defines a mechanism to conduct queries for reputation | This document defines a mechanism to conduct queries for reputation | |||
| information over the Hypertext Transfer Protocol using JSON as the | information over the Hypertext Transfer Protocol using JSON as the | |||
| payload meta-format. | payload meta-format. | |||
| Status of this Memo | Status of this Memo | |||
| This Internet-Draft is submitted in full conformance with the | This Internet-Draft is submitted in full conformance with the | |||
| skipping to change at page 1, line 32 ¶ | skipping to change at page 1, line 32 ¶ | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
| working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
| Drafts is at http://datatracker.ietf.org/drafts/current/. | Drafts is at http://datatracker.ietf.org/drafts/current/. | |||
| Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
| and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
| time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
| material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
| This Internet-Draft will expire on January 4, 2014. | This Internet-Draft will expire on January 13, 2014. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2013 IETF Trust and the persons identified as the | Copyright (c) 2013 IETF Trust and the persons identified as the | |||
| document authors. All rights reserved. | document authors. All rights reserved. | |||
| 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 | publication of this document. Please review these documents | |||
| skipping to change at page 2, line 15 ¶ | skipping to change at page 2, line 15 ¶ | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 2. Terminology and Definitions . . . . . . . . . . . . . . . . . . 3 | 2. Terminology and Definitions . . . . . . . . . . . . . . . . . . 3 | |||
| 2.1. Key Words . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 2.1. Key Words . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 2.2. Other Definitions . . . . . . . . . . . . . . . . . . . . . 3 | 2.2. Other Definitions . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 3. Description . . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 3. Description . . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 3.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 3.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 3.2. URI Template . . . . . . . . . . . . . . . . . . . . . . . 4 | 3.2. URI Template . . . . . . . . . . . . . . . . . . . . . . . 4 | |||
| 3.3. Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 3.3. Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 3.4. Response . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 3.4. Response . . . . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 3.5. Protocol Support . . . . . . . . . . . . . . . . . . . . . 6 | 3.5. Protocol Support . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 6 | 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 5. Security Considerations . . . . . . . . . . . . . . . . . . . . 6 | 5. Security Considerations . . . . . . . . . . . . . . . . . . . . 6 | |||
| 6. References . . . . . . . . . . . . . . . . . . . . . . . . . . 7 | 6. References . . . . . . . . . . . . . . . . . . . . . . . . . . 7 | |||
| 6.1. Normative References . . . . . . . . . . . . . . . . . . . 7 | 6.1. Normative References . . . . . . . . . . . . . . . . . . . 7 | |||
| 6.2. Informative References . . . . . . . . . . . . . . . . . . 7 | 6.2. Informative References . . . . . . . . . . . . . . . . . . 8 | |||
| Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . . 8 | Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . . 8 | |||
| Appendix B. Public Discussion . . . . . . . . . . . . . . . . . . 8 | Appendix B. Public Discussion . . . . . . . . . . . . . . . . . . 8 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 8 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 1. Introduction | 1. Introduction | |||
| This document defines a method to query a reputation data service for | This document defines a method to query a reputation data service for | |||
| information about an entity, using the HyperText Transfer Protocol | information about an entity, using the HyperText Transfer Protocol | |||
| (HTTP) as the transport mechanism and JSON as the payload meta- | (HTTP) as the transport mechanism and JSON as the payload meta- | |||
| format. | format. | |||
| The mechanism is a two-stage query: | ||||
| 1. A client retrieves a template from a server that describes the | ||||
| construction of a Universal Resource Identifier (URI) which will | ||||
| be the actual query; | ||||
| 2. The client then uses the constructed URI to request the | ||||
| reputation data from the server. | ||||
| 2. Terminology and Definitions | 2. Terminology and Definitions | |||
| This section defines terms used in the rest of the document. | This section defines terms used in the rest of the document. | |||
| 2.1. Key Words | 2.1. Key Words | |||
| The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | |||
| "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | |||
| document are to be interpreted as described in [KEYWORDS]. | document are to be interpreted as described in [KEYWORDS]. | |||
| End of changes. 6 change blocks. | ||||
| 5 lines changed or deleted | 14 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||