Asterisk-13-Configuration_res_xmpp_29394900.html 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Asterisk Project : Asterisk 13 Configuration_res_xmpp</title>
  5. <link rel="stylesheet" href="styles/site.css" type="text/css" />
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. </head>
  8. <body class="theme-default aui-theme-default">
  9. <div id="page">
  10. <div id="main" class="aui-page-panel">
  11. <div id="main-header">
  12. <div id="breadcrumb-section">
  13. <ol id="breadcrumbs">
  14. <li class="first">
  15. <span><a href="index.html">Asterisk Project</a></span>
  16. </li>
  17. <li>
  18. <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
  19. </li>
  20. <li>
  21. <span><a href="Asterisk-13-Module-Configuration_29394289.html">Asterisk 13 Module Configuration</a></span>
  22. </li>
  23. </ol>
  24. </div>
  25. <h1 id="title-heading" class="pagetitle">
  26. <span id="title-text">
  27. Asterisk Project : Asterisk 13 Configuration_res_xmpp
  28. </span>
  29. </h1>
  30. </div>
  31. <div id="content" class="view">
  32. <div class="page-metadata">
  33. Created by <span class='author'> wikibot</span> on Aug 08, 2014
  34. </div>
  35. <div id="main-content" class="wiki-content group">
  36. <h1 id="Asterisk13Configuration_res_xmpp-XMPPMessaging">XMPP Messaging</h1>
  37. <p>This configuration documentation is for functionality provided by <code>res_xmpp</code>.</p>
  38. <h2 id="Asterisk13Configuration_res_xmpp-xmpp.conf">xmpp.conf</h2>
  39. <h3 id="Asterisk13Configuration_res_xmpp-global">global</h3>
  40. <p>Global configuration settings</p>
  41. <h4 id="Asterisk13Configuration_res_xmpp-ConfigurationOptionReference">Configuration Option Reference</h4>
  42. <div class="table-wrap"><table class="confluenceTable"><tbody>
  43. <tr>
  44. <th class="confluenceTh"><p> Option Name </p></th>
  45. <th class="confluenceTh"><p> Type </p></th>
  46. <th class="confluenceTh"><p> Default Value </p></th>
  47. <th class="confluenceTh"><p> Regular Expression </p></th>
  48. <th class="confluenceTh"><p> Description </p></th>
  49. </tr>
  50. <tr>
  51. <td class="confluenceTd"><p> <code>debug</code> </p></td>
  52. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  53. <td class="confluenceTd"><p> <code>no</code> </p></td>
  54. <td class="confluenceTd"><p> <code>false</code> </p></td>
  55. <td class="confluenceTd"><p> Enable/disable XMPP message debugging </p></td>
  56. </tr>
  57. <tr>
  58. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_xmpp_29394900.html"><code>autoprune</code></a> </p></td>
  59. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  60. <td class="confluenceTd"><p> <code>no</code> </p></td>
  61. <td class="confluenceTd"><p> <code>false</code> </p></td>
  62. <td class="confluenceTd"><p> Auto-remove users from buddy list. </p></td>
  63. </tr>
  64. <tr>
  65. <td class="confluenceTd"><p> <code>autoregister</code> </p></td>
  66. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  67. <td class="confluenceTd"><p> <code>yes</code> </p></td>
  68. <td class="confluenceTd"><p> <code>false</code> </p></td>
  69. <td class="confluenceTd"><p> Auto-register users from buddy list </p></td>
  70. </tr>
  71. <tr>
  72. <td class="confluenceTd"><p> <code>collection_nodes</code> </p></td>
  73. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  74. <td class="confluenceTd"><p> <code>no</code> </p></td>
  75. <td class="confluenceTd"><p> <code>false</code> </p></td>
  76. <td class="confluenceTd"><p> Enable support for XEP-0248 for use with distributed device state </p></td>
  77. </tr>
  78. <tr>
  79. <td class="confluenceTd"><p> <code>pubsub_autocreate</code> </p></td>
  80. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  81. <td class="confluenceTd"><p> <code>no</code> </p></td>
  82. <td class="confluenceTd"><p> <code>false</code> </p></td>
  83. <td class="confluenceTd"><p> Whether or not the PubSub server supports/is using auto-create for nodes </p></td>
  84. </tr>
  85. <tr>
  86. <td class="confluenceTd"><p> <code>auth_policy</code> </p></td>
  87. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  88. <td class="confluenceTd"><p> <code>accept</code> </p></td>
  89. <td class="confluenceTd"><p> <code>false</code> </p></td>
  90. <td class="confluenceTd"><p> Whether to automatically accept or deny users' subscription requests </p></td>
  91. </tr>
  92. </tbody></table></div>
  93. <h4 id="Asterisk13Configuration_res_xmpp-ConfigurationOptionDescriptions">Configuration Option Descriptions</h4>
  94. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_xmpp-global_autoprune"></span></p>
  95. <h5 id="Asterisk13Configuration_res_xmpp-autoprune">autoprune</h5>
  96. <p>Auto-remove users from buddy list. Depending on the setup (e.g., using your personal Gtalk account for a test) this could cause loss of the contact list.</p>
  97. <h3 id="Asterisk13Configuration_res_xmpp-client">client</h3>
  98. <p>Configuration options for an XMPP client</p>
  99. <h4 id="Asterisk13Configuration_res_xmpp-ConfigurationOptionReference.1">Configuration Option Reference</h4>
  100. <div class="table-wrap"><table class="confluenceTable"><tbody>
  101. <tr>
  102. <th class="confluenceTh"><p> Option Name </p></th>
  103. <th class="confluenceTh"><p> Type </p></th>
  104. <th class="confluenceTh"><p> Default Value </p></th>
  105. <th class="confluenceTh"><p> Regular Expression </p></th>
  106. <th class="confluenceTh"><p> Description </p></th>
  107. </tr>
  108. <tr>
  109. <td class="confluenceTd"><p> <code>username</code> </p></td>
  110. <td class="confluenceTd"><p> <code>String</code> </p></td>
  111. <td class="confluenceTd"><p> </p></td>
  112. <td class="confluenceTd"><p> <code>false</code> </p></td>
  113. <td class="confluenceTd"><p> XMPP username with optional resource </p></td>
  114. </tr>
  115. <tr>
  116. <td class="confluenceTd"><p> <code>secret</code> </p></td>
  117. <td class="confluenceTd"><p> <code>String</code> </p></td>
  118. <td class="confluenceTd"><p> </p></td>
  119. <td class="confluenceTd"><p> <code>false</code> </p></td>
  120. <td class="confluenceTd"><p> XMPP password </p></td>
  121. </tr>
  122. <tr>
  123. <td class="confluenceTd"><p> <code>serverhost</code> </p></td>
  124. <td class="confluenceTd"><p> <code>String</code> </p></td>
  125. <td class="confluenceTd"><p> </p></td>
  126. <td class="confluenceTd"><p> <code>false</code> </p></td>
  127. <td class="confluenceTd"><p> Route to server, e.g. talk.google.com </p></td>
  128. </tr>
  129. <tr>
  130. <td class="confluenceTd"><p> <code>statusmessage</code> </p></td>
  131. <td class="confluenceTd"><p> <code>String</code> </p></td>
  132. <td class="confluenceTd"><p> <code>Online and Available</code> </p></td>
  133. <td class="confluenceTd"><p> <code>false</code> </p></td>
  134. <td class="confluenceTd"><p> Custom status message </p></td>
  135. </tr>
  136. <tr>
  137. <td class="confluenceTd"><p> <code>pubsub_node</code> </p></td>
  138. <td class="confluenceTd"><p> <code>String</code> </p></td>
  139. <td class="confluenceTd"><p> </p></td>
  140. <td class="confluenceTd"><p> <code>false</code> </p></td>
  141. <td class="confluenceTd"><p> Node for publishing events via PubSub </p></td>
  142. </tr>
  143. <tr>
  144. <td class="confluenceTd"><p> <code>context</code> </p></td>
  145. <td class="confluenceTd"><p> <code>String</code> </p></td>
  146. <td class="confluenceTd"><p> <code>default</code> </p></td>
  147. <td class="confluenceTd"><p> <code>false</code> </p></td>
  148. <td class="confluenceTd"><p> Dialplan context to send incoming messages to </p></td>
  149. </tr>
  150. <tr>
  151. <td class="confluenceTd"><p> <code>priority</code> </p></td>
  152. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  153. <td class="confluenceTd"><p> <code>1</code> </p></td>
  154. <td class="confluenceTd"><p> <code>false</code> </p></td>
  155. <td class="confluenceTd"><p> XMPP resource priority </p></td>
  156. </tr>
  157. <tr>
  158. <td class="confluenceTd"><p> <code>port</code> </p></td>
  159. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  160. <td class="confluenceTd"><p> <code>5222</code> </p></td>
  161. <td class="confluenceTd"><p> <code>false</code> </p></td>
  162. <td class="confluenceTd"><p> XMPP server port </p></td>
  163. </tr>
  164. <tr>
  165. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_xmpp_29394900.html"><code>timeout</code></a> </p></td>
  166. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  167. <td class="confluenceTd"><p> <code>5</code> </p></td>
  168. <td class="confluenceTd"><p> <code>false</code> </p></td>
  169. <td class="confluenceTd"><p> Timeout in seconds to hold incoming messages </p></td>
  170. </tr>
  171. <tr>
  172. <td class="confluenceTd"><p> <code>debug</code> </p></td>
  173. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  174. <td class="confluenceTd"><p> <code>no</code> </p></td>
  175. <td class="confluenceTd"><p> <code>false</code> </p></td>
  176. <td class="confluenceTd"><p> Enable debugging </p></td>
  177. </tr>
  178. <tr>
  179. <td class="confluenceTd"><p> <code>type</code> </p></td>
  180. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  181. <td class="confluenceTd"><p> <code>client</code> </p></td>
  182. <td class="confluenceTd"><p> <code>false</code> </p></td>
  183. <td class="confluenceTd"><p> Connection is either a client or a component </p></td>
  184. </tr>
  185. <tr>
  186. <td class="confluenceTd"><p> <code>distribute_events</code> </p></td>
  187. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  188. <td class="confluenceTd"><p> <code>no</code> </p></td>
  189. <td class="confluenceTd"><p> <code>false</code> </p></td>
  190. <td class="confluenceTd"><p> Whether or not to distribute events using this connection </p></td>
  191. </tr>
  192. <tr>
  193. <td class="confluenceTd"><p> <code>usetls</code> </p></td>
  194. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  195. <td class="confluenceTd"><p> <code>yes</code> </p></td>
  196. <td class="confluenceTd"><p> <code>false</code> </p></td>
  197. <td class="confluenceTd"><p> Whether to use TLS for the connection or not </p></td>
  198. </tr>
  199. <tr>
  200. <td class="confluenceTd"><p> <code>usesasl</code> </p></td>
  201. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  202. <td class="confluenceTd"><p> <code>yes</code> </p></td>
  203. <td class="confluenceTd"><p> <code>false</code> </p></td>
  204. <td class="confluenceTd"><p> Whether to use SASL for the connection or not </p></td>
  205. </tr>
  206. <tr>
  207. <td class="confluenceTd"><p> <code>forceoldssl</code> </p></td>
  208. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  209. <td class="confluenceTd"><p> <code>no</code> </p></td>
  210. <td class="confluenceTd"><p> <code>false</code> </p></td>
  211. <td class="confluenceTd"><p> Force the use of old-style SSL for the connection </p></td>
  212. </tr>
  213. <tr>
  214. <td class="confluenceTd"><p> <code>keepalive</code> </p></td>
  215. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  216. <td class="confluenceTd"><p> <code>yes</code> </p></td>
  217. <td class="confluenceTd"><p> <code>false</code> </p></td>
  218. <td class="confluenceTd"><p> If enabled, periodically send an XMPP message from this client with an empty message </p></td>
  219. </tr>
  220. <tr>
  221. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_xmpp_29394900.html"><code>autoprune</code></a> </p></td>
  222. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  223. <td class="confluenceTd"><p> <code>no</code> </p></td>
  224. <td class="confluenceTd"><p> <code>false</code> </p></td>
  225. <td class="confluenceTd"><p> Auto-remove users from buddy list. </p></td>
  226. </tr>
  227. <tr>
  228. <td class="confluenceTd"><p> <code>autoregister</code> </p></td>
  229. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  230. <td class="confluenceTd"><p> <code>yes</code> </p></td>
  231. <td class="confluenceTd"><p> <code>false</code> </p></td>
  232. <td class="confluenceTd"><p> Auto-register users bfrom buddy list </p></td>
  233. </tr>
  234. <tr>
  235. <td class="confluenceTd"><p> <code>auth_policy</code> </p></td>
  236. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  237. <td class="confluenceTd"><p> <code>accept</code> </p></td>
  238. <td class="confluenceTd"><p> <code>false</code> </p></td>
  239. <td class="confluenceTd"><p> Whether to automatically accept or deny users' subscription requests </p></td>
  240. </tr>
  241. <tr>
  242. <td class="confluenceTd"><p> <code>sendtodialplan</code> </p></td>
  243. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  244. <td class="confluenceTd"><p> <code>no</code> </p></td>
  245. <td class="confluenceTd"><p> <code>false</code> </p></td>
  246. <td class="confluenceTd"><p> Send incoming messages into the dialplan </p></td>
  247. </tr>
  248. <tr>
  249. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_xmpp_29394900.html"><code>status</code></a> </p></td>
  250. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  251. <td class="confluenceTd"><p> <code>available</code> </p></td>
  252. <td class="confluenceTd"><p> <code>false</code> </p></td>
  253. <td class="confluenceTd"><p> Default XMPP status for the client </p></td>
  254. </tr>
  255. <tr>
  256. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_xmpp_29394900.html"><code>buddy</code></a> </p></td>
  257. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  258. <td class="confluenceTd"><p> </p></td>
  259. <td class="confluenceTd"><p> <code>false</code> </p></td>
  260. <td class="confluenceTd"><p> Manual addition of buddy to list </p></td>
  261. </tr>
  262. </tbody></table></div>
  263. <h4 id="Asterisk13Configuration_res_xmpp-ConfigurationOptionDescriptions.1">Configuration Option Descriptions</h4>
  264. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_xmpp-client_timeout"></span></p>
  265. <h5 id="Asterisk13Configuration_res_xmpp-timeout">timeout</h5>
  266. <p>Timeout (in seconds) on the message stack. Messages stored longer than this value will be deleted by Asterisk. This option applies to incoming messages only which are intended to be processed by the <code>JABBER_RECEIVE</code> dialplan function.</p>
  267. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_xmpp-client_autoprune"></span></p>
  268. <h5 id="Asterisk13Configuration_res_xmpp-autoprune.1">autoprune</h5>
  269. <p>Auto-remove users from buddy list. Depending on the setup (e.g., using your personal Gtalk account for a test) this could cause loss of the contact list.</p>
  270. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_xmpp-client_status"></span></p>
  271. <h5 id="Asterisk13Configuration_res_xmpp-status">status</h5>
  272. <p>Can be one of the following XMPP statuses:</p>
  273. <ul>
  274. <li><code>chat</code></li>
  275. <li><code>available</code></li>
  276. <li><code>away</code></li>
  277. <li><code>xaway</code></li>
  278. <li><code>dnd</code></li>
  279. </ul>
  280. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_xmpp-client_buddy"></span></p>
  281. <h5 id="Asterisk13Configuration_res_xmpp-buddy">buddy</h5>
  282. <p>Manual addition of buddy to the buddy list. For distributed events, these budies are automatically added in the whitelist as 'owners' of the node(s).</p>
  283. <h3 id="Asterisk13Configuration_res_xmpp-ImportVersion">Import Version</h3>
  284. <p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
  285. </div>
  286. </div> </div>
  287. <div id="footer">
  288. <section class="footer-body">
  289. <p>Document generated by Confluence on Aug 11, 2014 13:49</p>
  290. </section>
  291. </div>
  292. </div> </body>
  293. </html>