No Description
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

xep-0063.xml 3.8KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <!DOCTYPE xep SYSTEM 'xep.dtd' [
  3. <!ENTITY % ents SYSTEM "xep.ent">
  4. %ents;
  5. ]>
  6. <?xml-stylesheet type='text/xsl' href='xep.xsl'?>
  7. <xep>
  8. <header>
  9. <title>Basic Filtering Operations</title>
  10. <abstract>A module that provides basic conditions and actions for packet filtering.</abstract>
  11. &LEGALNOTICE;
  12. <number>0063</number>
  13. <status>Deferred</status>
  14. <type>Informational</type>
  15. <sig>Standards</sig>
  16. <dependencies><spec>XEP-0062</spec></dependencies>
  17. <supersedes/>
  18. <supersededby/>
  19. <shortname>Not yet assigned</shortname>
  20. <author>
  21. <firstname>Robert</firstname>
  22. <surname>Norris</surname>
  23. <email>rob@cataclysm.cx</email>
  24. <jid>rob@cataclysm.cx</jid>
  25. </author>
  26. <revision>
  27. <version>0.2</version>
  28. <date>2003-09-30</date>
  29. <initials>psa</initials>
  30. <remark>At the request of the author, changed the status of this document to Deferred pending development of an implementation; also changed the type to Informational.</remark>
  31. </revision>
  32. <revision>
  33. <version>0.1</version>
  34. <date>2002-12-05</date>
  35. <initials>rn</initials>
  36. <remark>Initial version.</remark>
  37. </revision>
  38. </header>
  39. <section1 topic='Introduction'>
  40. <p>This document defines a module for &xep0062; that provides some basic conditions and actions to perform common packet filtering tasks.</p>
  41. <p>This module operates in the "http://jabber.org/protocol/filter/basic" namespace.</p>
  42. </section1>
  43. <section1 topic='Conditions'>
  44. <p>This module defines the fullowing conditions:</p>
  45. <ul>
  46. <li>&lt;message/> - true if the packet is a &lt;message/> packet.</li>
  47. <li>&lt;presence/> - true if the packet is a &lt;presence/> packet.</li>
  48. <li>&lt;iq/> - true if the packet is a &lt;iq/> packet. If this element contains CDATA, then it must match the namespace of the first element inside the packet (typically &lt;query/>) in order to be true.</li>
  49. <li>&lt;to/> - true when the CDATA of this element matches the "to" attribute of the packet.</li>
  50. <li>&lt;from/> - true when the CDATA of this element matches the "from" attribute of the packet.</li>
  51. <li>&lt;type/> - true when the CDATA of this element matches the "type" attribute of the packet.</li>
  52. </ul>
  53. <example caption='Matches all presence packets'><![CDATA[
  54. <presence xmlns='http://jabber.org/protocol/filter/basic'/>
  55. ]]></example>
  56. <example caption='Matches all jabber:iq:version IQ packets'><![CDATA[
  57. <iq xmlns='http://jabber.org/protocol/filter/basic'>jabber:iq:version</iq>
  58. ]]></example>
  59. <example caption='Matches all packets from user@company.com'><![CDATA[
  60. <from xmlns='http://jabber.org/protocol/filter/basic'>user@company.com</from>
  61. ]]></example>
  62. </section1>
  63. <section1 topic='Actions'>
  64. <p>This module defines the fullowing actions:</p>
  65. <ul>
  66. <li>&lt;drop/> - drops the packet</li>
  67. <li>&lt;bounce/> - bounces the packet with the error specified in the "code" attribute of this element.</li>
  68. <li>&lt;redirect/> - redirects the packet to the JID specified in the CDATA of this element.</li>
  69. <li>&lt;copy/> - sends a copy of the packet to the JID specified in the CDATA of this element, while giving the original packet to the user.</li>
  70. </ul>
  71. <example caption='Pretend that we don&apos;t exist'><![CDATA[
  72. <bounce xmlns='http://jabber.org/protocol/filter/basic' code='404'/>
  73. ]]></example>
  74. <example caption='Send a copy to our home account'><![CDATA[
  75. <copy xmlns='http://jabber.org/protocol/filter/basic'>me@home.com</copy>
  76. ]]></example>
  77. </section1>
  78. <section1 topic='Security Considerations'>
  79. <p>There are no security features or concerns related to this proposal.</p>
  80. </section1>
  81. <section1 topic='IANA Considerations'>
  82. <p>This document requires no interaction with the IANA.</p>
  83. </section1>
  84. <section1 topic='JANA Considerations'>
  85. <p>No namespaces or parameters need to be registered with JANA as a result of this document.</p>
  86. </section1>
  87. </xep>