| draft-shafranovich-abuse-report-00.txt | draft-shafranovich-feedback-report-00.txt | |||
|---|---|---|---|---|
| Network Working Group Y. Shafranovich | Network Working Group Y. Shafranovich | |||
| Internet-Draft SolidMatrix Technologies, Inc. | Internet-Draft SolidMatrix Technologies, Inc. | |||
| Expires: September 30, 2005 March 29, 2005 | Expires: September 2, 2005 March 2005 | |||
| An Extensible Format for Email Abuse Reports | An Extensible Format for Email Feedback Reports | |||
| draft-shafranovich-abuse-report-00.txt | draft-shafranovich-feedback-report-00.txt | |||
| Status of this Memo | Status of this Memo | |||
| This document is an Internet-Draft and is subject to all provisions | This document is an Internet-Draft and is subject to all provisions | |||
| of Section 3 of RFC 3667. By submitting this Internet-Draft, each | of Section 3 of RFC 3667. By submitting this Internet-Draft, each | |||
| author represents that any applicable patent or other IPR claims of | author represents that any applicable patent or other IPR claims of | |||
| which he or she is aware have been or will be disclosed, and any of | which he or she is aware have been or will be disclosed, and any of | |||
| which he or she become aware will be disclosed, in accordance with | which he or she become aware will be disclosed, in accordance with | |||
| RFC 3668. | RFC 3668. | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF), its areas, and its working groups. Note that | Task Force (IETF), its areas, and its working groups. Note that | |||
| other groups may also distribute working documents as | other groups may also distribute working documents as Internet- | |||
| Internet-Drafts. | Drafts. | |||
| 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." | |||
| The list of current Internet-Drafts can be accessed at | The list of current Internet-Drafts can be accessed at | |||
| http://www.ietf.org/ietf/1id-abstracts.txt. | http://www.ietf.org/ietf/1id-abstracts.txt. | |||
| The list of Internet-Draft Shadow Directories can be accessed at | The list of Internet-Draft Shadow Directories can be accessed at | |||
| http://www.ietf.org/shadow.html. | http://www.ietf.org/shadow.html. | |||
| This Internet-Draft will expire on September 30, 2005. | This Internet-Draft will expire on September 2, 2005. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (C) The Internet Society (2005). | Copyright (C) The Internet Society (2005). | |||
| Abstract | Abstract | |||
| This document defines an extensible format and MIME type that may be | This document defines an extensible format and MIME type that may be | |||
| used by network operators to report email abuse to other parties. | used by network operators to report feedback about received email to | |||
| This format is intended as a machine readable replacement for various | other parties. This format is intended as a machine readable | |||
| existing abuse report formats currently used in Internet email. | replacement for various existing report formats currently used in | |||
| Internet email. | ||||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 2. Intent . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 2. Intent . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 3. Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 3. Requirements . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 4. Format of Email Abuse Reports . . . . . . . . . . . . . . . . 3 | 4. Format of Email Feedback Reports . . . . . . . . . . . . . . 4 | |||
| 5. Format of 'message/abuse-report' Content Type . . . . . . . . 4 | 5. Format of 'message/feedback-report' Content Type . . . . . . 4 | |||
| 6. MIME Type Registration of message/abuse-report . . . . . . . . 4 | 6. MIME Type Registration of message/feedback-report . . . . . 5 | |||
| 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5 | 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . 6 | |||
| 8. Security Considerations . . . . . . . . . . . . . . . . . . . 6 | 8. Security Considerations . . . . . . . . . . . . . . . . . . 6 | |||
| 9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 6 | 9. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 9.1 Normative References . . . . . . . . . . . . . . . . . . . 6 | 10. References . . . . . . . . . . . . . . . . . . . . . . . . . 7 | |||
| 9.2 Informative References . . . . . . . . . . . . . . . . . . 6 | 10.1 Normative References . . . . . . . . . . . . . . . . . . 7 | |||
| Author's Address . . . . . . . . . . . . . . . . . . . . . . . 6 | 10.2 Informative References . . . . . . . . . . . . . . . . . 7 | |||
| A. Appendix A - An Sample Abuse Report . . . . . . . . . . . . . 6 | Author's Address . . . . . . . . . . . . . . . . . . . . . . 7 | |||
| Intellectual Property and Copyright Statements . . . . . . . . 8 | A. Appendix A - An Sample Abuse Report . . . . . . . . . . . . 8 | |||
| B. Status of This Document [To Be Removed Upon Publication] . . 9 | ||||
| B.1 Discussion Venue . . . . . . . . . . . . . . . . . . . . . 9 | ||||
| B.2 Document Repository . . . . . . . . . . . . . . . . . . . 9 | ||||
| B.3 Document History . . . . . . . . . . . . . . . . . . . . . 9 | ||||
| Intellectual Property and Copyright Statements . . . . . . . 10 | ||||
| 1. Introduction | 1. Introduction | |||
| As the spam problem has grown in the past few years, network | As the spam problem has grown in the past few years, network | |||
| operators have begun to exchange abuse reports among themselves and | operators have begun to exchange abuse reports among themselves and | |||
| other parties to combat this problem. However, different operators | other parties to combat this problem. However, different operators | |||
| define their own formats and the receivers are forced to write custom | define their own formats and the receivers are forced to write custom | |||
| software to interpret the many types of them. This memo seeks to | software to interpret the many types of them. In addition, many | |||
| define a standard extensible format and the "message/abuse-report" | operators use various other report formats to provide non-abuse | |||
| MIME type for abuse reports in accordance with RFC 2048 [4]. This | feedback about processed email. This memo seeks to define a standard | |||
| format and content type is intended to be used within the scope of | extensible format and the "message/feedback-report" MIME type for | |||
| the framework of the "multipart/report" content type defined in RFC | these reports in accordance with RFC 2048 [4]. This format and | |||
| 3462 [1]. | content type is intended to be used within the scope of the framework | |||
| of the "multipart/report" content type defined in RFC 3462 [1]. | ||||
| This document only defines the format and content type to be used for | This document only defines the format and content type to be used for | |||
| these reports. Determination of where these reports should be sent | these reports. Determination of where these reports should be sent | |||
| is outside the scope of this document. | is outside the scope of this document. | |||
| NOTE: This document may be incomplete and is intented to evolve based | ||||
| on public discussion and feedback | ||||
| 2. Intent | 2. Intent | |||
| The abuse reports defined in this document are intended for several | The reports defined in this document are intended for several | |||
| purposes: | purposes: | |||
| a. To inform ISPs about email abuse originating from their networks | a. To inform ISPs about email abuse originating from their networks | |||
| b. To provide feedback to email service providers about abuse | b. To provide feedback to email service providers about abuse | |||
| complaints | complaints | |||
| Note that the abuse reports defined in this document are limited to | c. To inform the author of the message that the receiver wants to | |||
| reporting email abuse only. | opt out. | |||
| Note that the reports defined in this document are limited to | ||||
| providing feedback about email only. | ||||
| 3. Requirements | 3. Requirements | |||
| The following requirements are necessary for abuse reports : | The following requirements are necessary for feedback reports : | |||
| a. They must be both human and machine readable | a. They must be both human and machine readable | |||
| b. Copy of the original email message or email headers must be | b. Copy of the original email message or email headers must be | |||
| enclosed in order to allow the receiver to properly handle the | enclosed in order to allow the receiver to properly handle the | |||
| report. | report. | |||
| 4. Format of Email Abuse Reports | 4. Format of Email Feedback Reports | |||
| An email abuse report is a MIME message with a top level MIME content | An email feedback report is a MIME message with a top level MIME | |||
| type of "multipart/report" (as defined in RFC 3462 [1]). The | content type of "multipart/report" (as defined in RFC 3462 [1]). The | |||
| following apply: | following apply: | |||
| a. The "report-type" parameter of "multipart/report" type is set to | a. The "report-type" parameter of "multipart/report" type is set to | |||
| "abuse-report". | "feedback-report". | |||
| b. The first MIME part of the message contains a human readable | b. The first MIME part of the message contains a human readable | |||
| description of the report | description of the report | |||
| c. The second MIME part of the message contains a machine readable | c. The second MIME part of the message contains a machine readable | |||
| abuse report with the content type of "message/abuse-report" | abuse report with the content type of "message/feedback-report" | |||
| (defined later on in this document). | (defined later on in this document). | |||
| d. The third MIME part of the message contains either a full copy of | d. The third MIME part of the message contains either a full copy of | |||
| the original message with a MIME content type of "message/rfc822" | the original message with a MIME content type of "message/rfc822" | |||
| (as defined in RFC 2046 [1]) OR a copy of the headers from the | (as defined in RFC 2046 [1]) OR a copy of the headers from the | |||
| original message with MIME content type of "text/rfc822-headers" | original message with MIME content type of "text/rfc822-headers" | |||
| (as defined in RFC 3462 [1]). | (as defined in RFC 3462 [1]). | |||
| e. Each abuse report should related to a single originating message. | e. Each abuse report should related to a single originating message. | |||
| f. The subject line of the abuse report should read as "Email Abuse | f. The subject line of the abuse report should read as "Email | |||
| Report for IP X.X.X.X" where "X.X.X.X" is the source IP of the | Feedback Report for IP X.X.X.X" where "X.X.X.X" is the source IP | |||
| MTA from which the original message was received. | of the MTA from which the original message was received. If | |||
| email authentication is used, the sender may substitute the text | ||||
| "for domain YYYYY.ZZZZ" where "YYYYY.ZZZZ" is the authenticated | ||||
| domain. | ||||
| g. Note that unlike the definition in RFC 3462 [1], all three parts | g. It is preferable that all original email headers are included | |||
| are required for abuse reports. | even though they are defined as optional in RFC 3462 [1]. | |||
| 5. Format of 'message/abuse-report' Content Type | 5. Format of 'message/feedback-report' Content Type | |||
| The message/abuse-report content type consists of several header | The message/feedback-report content type consists of several header | |||
| fields as follows: | fields as follows: | |||
| a. "Source-IP:" - contains an IPv4 or IPv6 address of the MTA from | a. "Source-IP:" - contains an IPv4 or IPv6 address of the MTA from | |||
| which the original message was received. | which the original message was received. | |||
| b. "Received-Date:" - date the original message was received. This | b. "Received-Date:" - date the original message was received. This | |||
| field is formatted in according to the definition in section 3.3 | field is formatted in according to the definition in section 3.3 | |||
| of RFC 2822 [2] | of RFC 2822 [2] | |||
| c. "Original-Message-ID:" - contains the RFC 2822 [2] Message-ID of | c. "Original-Message-ID:" - contains the RFC 2822 [2] Message-ID of | |||
| the original message | the original message | |||
| 6. MIME Type Registration of message/abuse-report | d. "Feedback-Type:" - contains the type of feedback as defined in | |||
| the corresponding IANA registry. | ||||
| e. "Authenticated-Domain:" and "Authenticated-Domain-Method:" - | ||||
| defines the authenticated domain and method used for perform that | ||||
| authentication. The list of method tokens is contained in the | ||||
| corresponding IANA registry. Note that the actual type of | ||||
| authentication used is outside the scope of this document. | ||||
| 6. MIME Type Registration of message/feedback-report | ||||
| This section provides the media type registration application (as per | This section provides the media type registration application (as per | |||
| RFC 2048 [4], which will be submitted to IANA after IESG approval of | RFC 2048 [4], which will be submitted to IANA after IESG approval of | |||
| this document. | this document. | |||
| To: ietf-types@iana.org | To: ietf-types@iana.org | |||
| Subject: Registration of MIME media types message/abuse-report | ||||
| Subject: Registration of MIME media types message/feedback-report | ||||
| MIME media type name: message | MIME media type name: message | |||
| MIME subtype name: abuse-report | MIME subtype name: feedback-report | |||
| Required parameters: none | Required parameters: none | |||
| Optional parameters: none | Optional parameters: none | |||
| Encoding considerations: | Encoding considerations: | |||
| "7bit" encoding is sufficient and MUST be used to maintain | "7bit" encoding is sufficient and MUST be used to maintain | |||
| readability when viewed by non-MIME mail readers. | readability when viewed by non-MIME mail readers. | |||
| skipping to change at page 5, line 38 | skipping to change at page 6, line 11 | |||
| ISPs | ISPs | |||
| Additional information: | Additional information: | |||
| Magic number(s): none | Magic number(s): none | |||
| File extension(s): none | File extension(s): none | |||
| Macintosh File Type Code(s): none | Macintosh File Type Code(s): none | |||
| Person & email address to contact for further information: | Person and email address to contact for further information: | |||
| Yakov Shafranovich <ietf@shaftek.org> | Yakov Shafranovich <ietf@shaftek.org> | |||
| Intended usage: COMMON | Intended usage: COMMON | |||
| Author/Change controller: IESG | Author/Change controller: IESG | |||
| 7. IANA Considerations | 7. IANA Considerations | |||
| After IESG approval, IANA is expected to register MIME type | After IESG approval, IANA is expected to register MIME type "message/ | |||
| "message/abuse-report" using the application provided in this | feedback-report" using the application provided in this document and | |||
| document. | setup two registries for "Feedback-Type" and "Authentication-Domain- | |||
| Method" headers. Below are the initial values for these registries. | ||||
| Initial values for the "Feedback-Type" registry: | ||||
| abuse - spam or some other kind of email abuse | ||||
| opt-out - a request to opt out from a mailing list. | ||||
| virus - report of a virus found in the originating message | ||||
| Initial values for the "Authentication-Domain-Method" registry: | ||||
| domainkeys - as defined in delany-domainkeys-base [5] | ||||
| iim - as defined in fenton-identified-mail [6] | ||||
| sender-id - as defined in lyon-senderid-core [7] | ||||
| spf - as defined in schlitt-spf-classic [8] | ||||
| 8. Security Considerations | 8. Security Considerations | |||
| See section 3 of RFC 3462 [1] | See section 3 of RFC 3462 [1] | |||
| 9. References | 9. Acknowledgments | |||
| 9.1 Normative References | The author would like to thank many of the members of the email | |||
| community who provided helpful comments and suggestions for this | ||||
| document including many of the participants in ASRG, IETF and MAAWG | ||||
| activities. | ||||
| 10. References | ||||
| 10.1 Normative References | ||||
| [1] Vaudreuil, G., "The Multipart/Report Content Type for the | [1] Vaudreuil, G., "The Multipart/Report Content Type for the | |||
| Reporting of Mail System Administrative Messages", RFC 3462, | Reporting of Mail System Administrative Messages", RFC 3462, | |||
| January 2003. | January 2003. | |||
| [2] Resnick, P., "Internet Message Format", RFC 2822, April 2001. | [2] Resnick, P., "Internet Message Format", RFC 2822, April 2001. | |||
| [3] Freed, N. and N. Borenstein, "Multipurpose Internet Mail | [3] Freed, N. and N. Borenstein, "Multipurpose Internet Mail | |||
| Extensions (MIME) Part Two: Media Types", RFC 2046, November | Extensions (MIME) Part Two: Media Types", RFC 2046, | |||
| 1996. | November 1996. | |||
| 9.2 Informative References | 10.2 Informative References | |||
| [4] Freed, N., Klensin, J. and J. Postel, "Multipurpose Internet | [4] Freed, N., Klensin, J., and J. Postel, "Multipurpose Internet | |||
| Mail Extensions (MIME) Part Four: Registration Procedures", | Mail Extensions (MIME) Part Four: Registration Procedures", | |||
| BCP 13, RFC 2048, November 1996. | BCP 13, RFC 2048, November 1996. | |||
| [5] Delany, M., "Domain-based Email Authentication Using Public-Keys | ||||
| Advertised in the DNS (DomainKeys)", | ||||
| draft-delany-domainkeys-base-02 (work in progress), March 2005. | ||||
| [6] Fenton, J. and M. Thomas, "Identified Internet Mail", | ||||
| draft-fenton-identified-mail-01 (work in progress), | ||||
| October 2004. | ||||
| [7] Lyon, J., "Sender ID: Authenticating E-Mail", | ||||
| draft-lyon-senderid-core-00 (work in progress), November 2004. | ||||
| [8] Wong, M., "Sender Policy Framework: Authorizing Use of Domains | ||||
| in E-MAIL", draft-schlitt-spf-classic-00 (work in progress), | ||||
| January 2005. | ||||
| Author's Address | Author's Address | |||
| Yakov Shafranovich | Yakov Shafranovich | |||
| SolidMatrix Technologies, Inc. | SolidMatrix Technologies, Inc. | |||
| Email: ietf@shaftek.org | Email: ietf@shaftek.org | |||
| URI: http://www.shaftek.org | URI: http://www.shaftek.org | |||
| Appendix A. Appendix A - An Sample Abuse Report | Appendix A. Appendix A - An Sample Abuse Report | |||
| From: <abusedesk@example.com> | From: <abusedesk@example.com> | |||
| Date: Thu, 8 Mar 2005 17:40:36 EDT | Date: Thu, 8 Mar 2005 17:40:36 EDT | |||
| Subject: Email Abuse Report for IP 10.67.41.167 | Subject: Email Abuse Report for IP 10.67.41.167 | |||
| To: <abuse@example.net> | To: <abuse@example.net> | |||
| MIME-Version: 1.0 | MIME-Version: 1.0 | |||
| Content-Type: multipart/report; report-type=abuse-report; boundary="part1_13d.2e68ed54_boundary" | Content-Type: multipart/report; report-type=feedback-report; boundary="part1_13d.2e68ed54_boundary" | |||
| --part1_13d.2e68ed54_boundary | --part1_13d.2e68ed54_boundary | |||
| Content-Type: text/plain; charset="US-ASCII" | Content-Type: text/plain; charset="US-ASCII" | |||
| Content-Transfer-Encoding: 7bit | Content-Transfer-Encoding: 7bit | |||
| This is an email abuse report for an email message received from IP 10.67.41.167 on Thu, 8 Mar 2005 14:00:00 EDT. | This is an email abuse report for an email message received from IP 10.67.41.167 on Thu, 8 Mar 2005 14:00:00 EDT. | |||
| --part1_13d.2e68ed54_boundary | --part1_13d.2e68ed54_boundary | |||
| Content-Type: message/abuse-report | Content-Type: message/feedback-report | |||
| Source-IP: 10.67.41.167 | Source-IP: 10.67.41.167 | |||
| Received-Date: Thu, 8 Mar 2005 14:00:00 EDT | Received-Date: Thu, 8 Mar 2005 14:00:00 EDT | |||
| Original-Message-ID: 8787KJKJ3K4J3K4J3K4J3.mail@example.net | Original-Message-ID: 8787KJKJ3K4J3K4J3K4J3.mail@example.net | |||
| Feedback-Type: abuse | ||||
| --part1_13d.2e68ed54_boundary | --part1_13d.2e68ed54_boundary | |||
| Content-Type: message/rfc822 | Content-Type: message/rfc822 | |||
| Content-Disposition: inline | Content-Disposition: inline | |||
| From: <somespammer@example.netglt; | From: <somespammer@example.net> | |||
| Received: from mailserver.example.net (mailserver.example.net [10.67.41.167]) | Received: from mailserver.example.net (mailserver.example.net [10.67.41.167]) | |||
| by example.com with ESMTP id M63d4137594e46; Thu, 08 Mar 2005 14:00:00 -0400 | by example.com with ESMTP id M63d4137594e46; Thu, 08 Mar 2005 14:00:00 -0400 | |||
| To: <Undisclosed Recipients> | To: <Undisclosed Recipients> | |||
| Subject: Earn money | Subject: Earn money | |||
| MIME-Version: 1.0 | MIME-Version: 1.0 | |||
| Content-type: text/plain | Content-type: text/plain | |||
| Message-ID: 8787KJKJ3K4J3K4J3K4J3.mail@example.net | Message-ID: 8787KJKJ3K4J3K4J3K4J3.mail@example.net | |||
| Date: Thu, 02 Sep 2004 12:31:03 -0500 | Date: Thu, 02 Sep 2004 12:31:03 -0500 | |||
| Spam Spam Spam | Spam Spam Spam | |||
| Spam Spam Spam | Spam Spam Spam | |||
| Spam Spam Spam | Spam Spam Spam | |||
| Spam Spam Spam | Spam Spam Spam | |||
| --part1_13d.2e68ed54_boundary-- | --part1_13d.2e68ed54_boundary-- | |||
| Appendix B. Status of This Document [To Be Removed Upon Publication] | ||||
| B.1 Discussion Venue | ||||
| Comments about this document should be sent directly to the author at | ||||
| via <ietf@shaftek.org>. | ||||
| B.2 Document Repository | ||||
| Copies of this and earlier versions including multiple formats can be | ||||
| found at <http://www.shaftek.org/publications/drafts/abuse-report/>. | ||||
| B.3 Document History | ||||
| Changes from draft-shafranovich-abuse-report-00 to | ||||
| draft-shafranovich-feedback-report-00: | ||||
| o Name of the format and report changed to 'feedback-report' | ||||
| o Minor spelling corrections | ||||
| o Added authentication headers and registry | ||||
| o Added feedback-type header and registry. | ||||
| Intellectual Property Statement | Intellectual Property Statement | |||
| The IETF takes no position regarding the validity or scope of any | The IETF takes no position regarding the validity or scope of any | |||
| Intellectual Property Rights or other rights that might be claimed to | Intellectual Property Rights or other rights that might be claimed to | |||
| pertain to the implementation or use of the technology described in | pertain to the implementation or use of the technology described in | |||
| this document or the extent to which any license under such rights | this document or the extent to which any license under such rights | |||
| might or might not be available; nor does it represent that it has | might or might not be available; nor does it represent that it has | |||
| made any independent effort to identify any such rights. Information | made any independent effort to identify any such rights. Information | |||
| on the procedures with respect to rights in RFC documents can be | on the procedures with respect to rights in RFC documents can be | |||
| End of changes. | ||||
This html diff was produced by rfcdiff 1.23, available from http://www.levkowetz.com/ietf/tools/rfcdiff/ | ||||