[要約] RFC 5231は、Sieveメールフィルタリングの拡張であり、関係性を利用したフィルタリングを提供します。このRFCの目的は、Sieveスクリプトの柔軟性と効率性を向上させ、メールの自動処理を容易にすることです。
Network Working Group W. Segmuller
Request for Comments: 5231 B. Leiba
Obsoletes: 3431 IBM T.J. Watson Research Center
Category: Standards Track January 2008
Sieve Email Filtering: Relational Extension
Sieveメールフィルタリング：リレーショナル拡張
Status of This Memo
本文書の状態
This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited.
このドキュメントは、インターネットコミュニティのインターネット標準トラックプロトコルを指定し、改善のための議論と提案を要求します。このプロトコルの標準化状態とステータスについては、「インターネット公式プロトコル標準」（STD 1）の最新版を参照してください。このメモの配布は無制限です。
Abstract
概要
This document describes the RELATIONAL extension to the Sieve mail filtering language defined in RFC 3028. This extension extends existing conditional tests in Sieve to allow relational operators. In addition to testing their content, it also allows for testing of the number of entities in header and envelope fields.
このドキュメントでは、RFC 3028で定義されているSieveメールフィルタリング言語のRELATIONAL拡張について説明します。この拡張は、Sieveの既存の条件テストを拡張して、関係演算子を許可します。コンテンツのテストに加えて、ヘッダーフィールドとエンベロープフィールドのエンティティの数をテストすることもできます。
This document obsoletes RFC 3431.
このドキュメントはRFC 3431を廃止します。
Table of Contents
目次
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Conventions Used in This Document . . . . . . . . . . . . . . . 2
3. Comparators . . . . . . . . . . . . . . . . . . . . . . . . . . 2
4. Match Types . . . . . . . . . . . . . . . . . . . . . . . . . . 3
4.1. Match Type VALUE . . . . . . . . . . . . . . . . . . . . . 3
4.2. Match Type COUNT . . . . . . . . . . . . . . . . . . . . . 3
5. Interaction with Other Sieve Actions . . . . . . . . . . . . . 4
6. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7. Extended Example . . . . . . . . . . . . . . . . . . . . . . . 6
8. Changes since RFC 3431 . . . . . . . . . . . . . . . . . . . . 6
9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 7
10. Security Considerations . . . . . . . . . . . . . . . . . . . . 7
11. Normative References . . . . . . . . . . . . . . . . . . . . . 7
The RELATIONAL extension to the Sieve mail filtering language [Sieve] provides relational operators on the address, envelope, and header tests. This extension also provides a way of counting the entities in a message header or address field.
Sieveメールフィルタリング言語[Sieve]のRELATIONAL拡張機能は、アドレス、エンベロープ、ヘッダーのテストに関係演算子を提供します。この拡張機能は、メッセージヘッダーまたはアドレスフィールドのエンティティをカウントする方法も提供します。
With this extension, the Sieve script may now determine if a field is greater than or less than a value instead of just equivalent. One use is for the x-priority field: move messages with a priority greater than 3 to the "work on later" folder. Mail could also be sorted by the from address. Those userids that start with 'a'-'m' go to one folder, and the rest go to another folder.
この拡張により、Sieveスクリプトは、フィールドが単なる同等値ではなく、値より大きいか小さいかを判断できるようになりました。 1つの用途はx-priorityフィールドの使用です。優先度が3より大きいメッセージを「後から作業」フォルダーに移動します。メールは、送信元アドレスでソートすることもできます。 「a」〜「m」で始まるユーザーIDは1つのフォルダーに移動し、残りは別のフォルダーに移動します。
The Sieve script can also determine the number of fields in the header, or the number of addresses in a recipient field, for example, whether there are more than 5 addresses in the to and cc fields.
Sieveスクリプトは、ヘッダーのフィールド数、または受信者フィールドのアドレス数（たとえば、toおよびccフィールドに5つを超えるアドレスがあるかどうか）も判別できます。
The capability string associated with the extension defined in this document is "relational".
このドキュメントで定義されている拡張機能に関連付けられている機能文字列は「リレーショナル」です。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14, RFC 2119.
このドキュメントのキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、 BCP 14、RFC 2119で説明されているように解釈されます。
Conventions for notations are as in [Sieve] section 1.1, including the use of [Kwds] and the use of [ABNF].
表記法の表記法は、[Keves]の使用と[ABNF]の使用を含め、[Sieve]セクション1.1と同じです。
This document does not define any comparators or exempt any comparators from the require clause. Any comparator used must be treated as defined in [Sieve].
このドキュメントでは、コンパレータを定義したり、コンパレータをrequire節から除外したりしていません。使用するコンパレータは、[Sieve]で定義されているとおりに処理する必要があります。
The "i;ascii-numeric" comparator, as defined in [RFC4790], MUST be supported for any implementation of this extension. The comparator "i;ascii-numeric" MUST support at least 32-bit unsigned integers.
[RFC4790]で定義されている「i; ascii-numeric」コンパレータは、この拡張機能の実装でサポートされている必要があります。コンパレータ「i; ascii-numeric」は、少なくとも32ビットの符号なし整数をサポートする必要があります。
Larger integers MAY be supported. Note: the "i;ascii-numeric" comparator does not support negative numbers.
より大きな整数がサポートされる場合があります。注：「i; ascii-numeric」コンパレータは負の数をサポートしていません。
This document defines two new match types. They are the VALUE match type and the COUNT match type.
このドキュメントでは、2つの新しいマッチタイプを定義しています。これらは、VALUEマッチタイプとCOUNTマッチタイプです。
The syntax is:
構文は次のとおりです。
MATCH-TYPE =/ COUNT / VALUE
COUNT = ":count" relational-match
COUNT = "：count"リレーショナル一致
VALUE = ":value" relational-match
VALUE = "：value"関係一致
relational-match = DQUOTE
("gt" / "ge" / "lt" / "le" / "eq" / "ne") DQUOTE
; "gt" means "greater than", the C operator ">".
; "ge" means "greater than or equal", the C operator ">=".
; "lt" means "less than", the C operator "<".
; "le" means "less than or equal", the C operator "<=".
; "eq" means "equal to", the C operator "==".
; "ne" means "not equal to", the C operator "!=".
The VALUE match type does a relational comparison between strings.
VALUEマッチタイプは、文字列間の関係比較を行います。
The VALUE match type may be used with any comparator that returns sort information.
VALUEマッチタイプは、ソート情報を返すコンパレータと一緒に使用できます。
A value from the message is considered the left side of the relation. A value from the test expression, the key-list for address, envelope, and header tests, is the right side of the relation.
メッセージの値は、関係の左側と見なされます。テスト式の値、アドレス、エンベロープ、およびヘッダーテストのキーリストは、関係の右側です。
If there are multiple values on either side or both sides, the test is considered true if any pair is true.
片側または両側に複数の値がある場合、いずれかのペアが真であれば、テストは真と見なされます。
The COUNT match type first determines the number of the specified entities in the message and does a relational comparison of the number of entities, as defined below, to the values specified in the test expression.
COUNTマッチタイプは、最初にメッセージ内の指定されたエンティティの数を決定し、以下に定義されているように、エンティティの数とテスト式で指定された値との関係比較を行います。
The COUNT match type SHOULD only be used with numeric comparators.
COUNTマッチタイプは、数値コンパレータでのみ使用する必要があります（SHOULD）。
The Address Test counts the number of addresses (the number of "mailbox" elements, as defined in [RFC2822]) in the specified fields. Group names are ignored, but the contained mailboxes are counted.
アドレステストは、指定されたフィールドのアドレスの数（[RFC2822]で定義されている「メールボックス」要素の数）をカウントします。グループ名は無視されますが、含まれているメールボックスはカウントされます。
The Envelope Test counts the number of addresses in the specified envelope parts. The envelope "to" will always have only one entry, which is the address of the user for whom the Sieve script is running. Using this test, there is no way a Sieve script can determine if the message was actually sent to someone else. The envelope "from" will be 0 if the MAIL FROM is empty, or 1 if MAIL FROM is not empty.
エンベロープテストは、指定されたエンベロープパーツのアドレス数をカウントします。エンベロープの「to」には常に1つのエントリしかありません。これは、Sieveスクリプトを実行しているユーザーのアドレスです。このテストを使用すると、メッセージが実際に誰かに送信されたかどうかをSieveスクリプトが判別する方法はありません。エンベロープの「from」は、MAIL FROMが空の場合は0、MAIL FROMが空でない場合は1になります。
The Header Test counts the total number of instances of the specified fields. This does not count individual addresses in the "to", "cc", and other recipient fields.
ヘッダーテストは、指定されたフィールドのインスタンスの総数をカウントします。これは、「to」、「cc」、およびその他の受信者フィールドの個々のアドレスはカウントしません。
In all cases, if more than one field name is specified, the counts for all specified fields are added together to obtain the number for comparison. Thus, specifying ["to", "cc"] in an address COUNT test compares the total number of "to" and "cc" addresses; if separate counts are desired, they must be done in two comparisons, perhaps joined by "allof" or "anyof".
いずれの場合も、複数のフィールド名が指定されている場合、指定されたすべてのフィールドのカウントが合計され、比較のための数が取得されます。したがって、アドレスCOUNTテストで["to"、 "cc"]を指定すると、「to」アドレスと「cc」アドレスの総数が比較されます。個別のカウントが必要な場合は、2つの比較で実行する必要があります。おそらく「allof」または「anyof」で結合されます。
This specification adds two match types. The VALUE match type only works with comparators that return sort information. The COUNT match type only makes sense with numeric comparators.
この仕様は、2つの一致タイプを追加します。 VALUEマッチタイプは、並べ替え情報を返すコンパレータでのみ機能します。 COUNT一致タイプは、数値コンパレータでのみ意味があります。
There is no interaction with any other Sieve operations, nor with any known extensions. In particular, this specification has no effect on implicit KEEP, nor on any explicit message actions.
他のSieve操作や既知の拡張機能との相互作用はありません。特に、この仕様は、暗黙のKEEPにも、明示的なメッセージアクションにも影響を与えません。
Using the message:
メッセージの使用：
received: ...
received: ...
subject: example
to: foo@example.com, baz@example.com
cc: qux@example.com
The test:
テスト：
address :count "ge" :comparator "i;ascii-numeric" ["to", "cc"] ["3"]
アドレス：count "ge"：comparator "i; ascii-numeric" ["to"、 "cc"] ["3"]
would evaluate to true, and the test
trueと評価され、テスト
anyof ( address :count "ge" :comparator "i;ascii-numeric"
["to"] ["3"],
address :count "ge" :comparator "i;ascii-numeric"
["cc"] ["3"] )
would evaluate to false.
falseと評価されます。
To check the number of received fields in the header, the following test may be used:
ヘッダーの受信フィールド数を確認するには、次のテストを使用できます。
header :count "ge" :comparator "i;ascii-numeric" ["received"] ["3"]
header：count "ge"：comparator "i; ascii-numeric" ["received"] ["3"]
This would evaluate to false. But
これはfalseと評価されます。だが
header :count "ge" :comparator "i;ascii-numeric" ["received", "subject"] ["3"]
header：count "ge"：comparator "i; ascii-numeric" ["received"、 "subject"] ["3"]
would evaluate to true.
trueと評価されます。
The test:
テスト：
header :count "ge" :comparator "i;ascii-numeric" ["to", "cc"] ["3"]
header：count "ge"：comparator "i; ascii-numeric" ["to"、 "cc"] ["3"]
will always evaluate to false on an RFC 2822 compliant message [RFC2822], since a message can have at most one "to" field and at most one "cc" field. This test counts the number of fields, not the number of addresses.
メッセージは最大で1つの「宛先」フィールドと最大で1つの「cc」フィールドを持つことができるため、RFC 2822準拠メッセージ[RFC2822]では常にfalseと評価されます。このテストでは、住所の数ではなく、フィールドの数がカウントされます。
require ["relational", "comparator-i;ascii-numeric", "fileinto"];
require ["relational"、 "comparator-i; ascii-numeric"、 "fileinto"];
if header :value "lt" :comparator "i;ascii-numeric"
["x-priority"] ["3"]
{
fileinto "Priority";
}
elsif address :count "gt" :comparator "i;ascii-numeric"
["to"] ["5"]
{
# everything with more than 5 recipients in the "to" field
# is considered SPAM
fileinto "SPAM";
}
elsif address :value "gt" :all :comparator "i;ascii-casemap"
["from"] ["M"]
{
fileinto "From N-Z";
} else {
fileinto "From A-M";
}
if allof ( address :count "eq" :comparator "i;ascii-numeric"
["to", "cc"] ["1"] ,
address :all :comparator "i;ascii-casemap"
["to", "cc"] ["me@foo.example.com"] )
{
fileinto "Only me";
}
Apart from several minor editorial/wording changes, the following list describes the notable changes to this specification since RFC 3431.
いくつかのマイナーな編集/表現の変更は別として、次のリストは、RFC 3431以降のこの仕様への注目すべき変更を説明しています。
o Updated references, including changing the comparator reference from the Application Configuration Access Protocol (ACAP) to the "Internet Application Protocol Collation Registry" document [RFC4790].
o コンパレータの参照をアプリケーション構成アクセスプロトコル（ACAP）から「インターネットアプリケーションプロトコル照合レジストリ」ドキュメント[RFC4790]に変更するなど、参照を更新しました。
o Updated and corrected the examples.
o 例を更新および修正しました。
o Added definition comments to ABNF for "gt", "lt", etc.
o 「gt」、「lt」などの定義コメントをABNFに追加しました。
o Clarified what RFC 2822 elements are counted in the COUNT test.
o COUNTテストでカウントされるRFC 2822要素を明確にしました。
o Removed the requirement to strip white space from header fields before comparing; a more general version of this requirement has been added to the Sieve base spec.
o 比較する前にヘッダーフィールドから空白を削除する必要がなくなりました。この要件のより一般的なバージョンがSieve基本仕様に追加されました。
The following template specifies the IANA registration of the relational Sieve extension specified in this document:
次のテンプレートは、このドキュメントで指定されているリレーショナルSieve拡張のIANA登録を指定しています。
To: iana@iana.org Subject: Registration of new Sieve extension
宛先：iana@iana.org件名：新しいSieve拡張の登録
Capability name: relational
Description: Extends existing conditional tests in Sieve language
to allow relational operators
RFC number: RFC 5231
Contact address: The Sieve discussion list <ietf-mta-filters@imc.org>
An implementation MUST ensure that the test for envelope "to" only reflects the delivery to the current user. Using this test, it MUST not be possible for a user to determine if this message was delivered to someone else.
実装は、エンベロープ「to」のテストが現在のユーザーへの配信のみを反映していることを確認する必要があります。このテストを使用して、このメッセージが他の誰かに配信されたかどうかをユーザーが判断できないようにする必要があります。
Additional security considerations are discussed in [Sieve].
セキュリティに関するその他の考慮事項は、[Sieve]で説明されています。
[ABNF] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax Specifications: ABNF", RFC 4234, October 2005.
[ABNF]クロッカー、D。、エド。およびP. Overell、「構文仕様の拡張BNF：ABNF」、RFC 4234、2005年10月。
[Kwds] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, March 1997.
[Kwds] Bradner、S。、「RFCで使用して要件レベルを示すためのキーワード」、RFC 2119、1997年3月。
[RFC2822] Resnick, P., "Internet Message Format", RFC 2822, April 2001.
[RFC2822] Resnick、P。、「インターネットメッセージ形式」、RFC 2822、2001年4月。
[RFC4790] Newman, C., Duerst, M., and A. Gulbrandsen, "Internet Application Protocol Collation Registry", RFC 4790, March 2007.
[RFC4790]ニューマン、C。、デュエルスト、M。、およびA.グルブランドセン、「インターネットアプリケーションプロトコル照合レジストリ」、RFC 4790、2007年3月。
[Sieve] Guenther, P., Ed. and T. Showalter, Ed., "Sieve: An Email Filtering Language", RFC 5228, January 2008.
[ふるい] Guenther、P。、エド。 T. Showalter編、「Sieve：An Email Filtering Language」、RFC 5228、2008年1月。
Authors' Addresses
著者のアドレス
Wolfgang Segmuller IBM T.J. Watson Research Center 19 Skyline Drive Hawthorne, NY 10532 US
Wolfgang Segmuller IBM T.J.ワトソンリサーチセンター19 Skyline Drive Hawthorne、NY 10532 US
Phone: +1 914 784 7408
EMail: werewolf@us.ibm.com
Barry Leiba IBM T.J. Watson Research Center 19 Skyline Drive Hawthorne, NY 10532 US
バリーレイバIBM T.J.ワトソンリサーチセンター19 Skyline Drive Hawthorne、NY 10532 US
Phone: +1 914 784 7941
EMail: leiba@watson.ibm.com
Full Copyright Statement
完全な著作権表示
Copyright (C) The IETF Trust (2008).
Copyright（C）IETF Trust（2008）。
This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.
このドキュメントは、BCP 78に含まれる権利、ライセンス、および制限の対象であり、そこに記載されている場合を除き、著者はすべての権利を保持します。
This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
このドキュメントとここに含まれる情報は、「現状のまま」で提供され、寄稿者、彼/彼女の代理人、または（もしあれば）組織、インターネット社会、IETFトラスト、およびインターネットエンジニアリングタスクフォースはすべてを否認します。明示または黙示を問わず、ここに含まれる情報の使用が商品性または特定の目的への適合性に関するいかなる権利または黙示の保証も侵害しないことを保証するものではありません。
Intellectual Property
知的財産
The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in 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 made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.
IETFは、このドキュメントに記載されているテクノロジーの実装または使用に関連すると主張される可能性がある知的財産権またはその他の権利の有効性または範囲、またはそのような権利に基づくライセンスが適用されるかどうかに関係なく、いかなる立場も取りません。利用できる;また、そのような権利を特定するために独立した取り組みを行ったことを表すものでもありません。 RFC文書の権利に関する手順に関する情報は、BCP 78およびBCP 79にあります。
Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.
IETF事務局に対して行われたIPR開示のコピー、および使用可能にされるライセンスの保証、または一般ライセンスを取得する試みの結果、またはこの仕様の実装者またはユーザーがそのような所有権を使用するための許可を取得できるhttp://www.ietf.org/iprのIETFオンラインIPRリポジトリから。
The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org.
IETFは、この規格を実装するために必要となる可能性のある技術をカバーする可能性のある著作権、特許、特許出願、またはその他の所有権に注意を向けるよう、利害関係者に呼びかけます。 IEETのietf-ipr@ietf.orgに情報を送信してください。