Home Explore Help
Register Sign In
dingyu
/
Asterisk
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Branch: master
Branches Tags
Asterisk
/
doc
/
Asterisk-Admin-Guide
/
Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html

Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html 12 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232 
  1. <!DOCTYPE html>
    2. 

  2. <html>
    3. 

  3.     <head>
    4. 

  4.         <title>Asterisk Project : Asterisk 13 Configuration_res_pjsip_outbound_registration</title>
    5. 

  5.         <link rel="stylesheet" href="styles/site.css" type="text/css" />
    6. 

  6.         <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
    7. 

  7.     </head>
    8. 

  8. 

  9.     <body class="theme-default aui-theme-default">
    10. 

  10.         <div id="page">
    11. 

  11.             <div id="main" class="aui-page-panel">
    12. 

  12.                 <div id="main-header">
    13. 

  13.                     <div id="breadcrumb-section">
    14. 

  14.                         <ol id="breadcrumbs">
    15. 

  15.                             <li class="first">
    16. 

  16.                                 <span><a href="index.html">Asterisk Project</a></span>
    17. 

  17.                             </li>
    18. 

  18.                                                     <li>
    19. 

  19.                                 <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
    20. 

  20.                             </li>
    21. 

  21.                                                     <li>
    22. 

  22.                                 <span><a href="Asterisk-13-Module-Configuration_29394289.html">Asterisk 13 Module Configuration</a></span>
    23. 

  23.                             </li>
    24. 

  24.                                                 </ol>
    25. 

  25.                     </div>
    26. 

  26.                     <h1 id="title-heading" class="pagetitle">
    27. 

  27.                                                 <span id="title-text">
    28. 

  28.                             Asterisk Project : Asterisk 13 Configuration_res_pjsip_outbound_registration
    29. 

  29.                         </span>
    30. 

  30.                     </h1>
    31. 

  31.                 </div>
    32. 

  32. 

  33.                 <div id="content" class="view">
    34. 

  34.                     <div class="page-metadata">
    35. 

  35.                         
    36. 

  36.         
    37. 

  37.     
    38. 

  38.         
    39. 

  39.     
    40. 

  40.         
    41. 

  41.     
    42. 

  42.             Created by <span class='author'> wikibot</span> on Aug 08, 2014
    43. 

  43.                         </div>
    44. 

  44.                     <div id="main-content" class="wiki-content group">
    45. 

  45.                     <h1 id="Asterisk13Configuration_res_pjsip_outbound_registration-SIPresourceforoutboundregistrations">SIP resource for outbound registrations</h1>
    46. 

  46. 

  47. <p>This configuration documentation is for functionality provided by <code>res_pjsip_outbound_registration</code>.</p>
    48. 

  48. 

  49. <h2 id="Asterisk13Configuration_res_pjsip_outbound_registration-Overview">Overview</h2>
    50. 

  50. 

  51. <p><strong>Outbound Registration</strong></p>
    52. 

  52. 

  53. <p>This module allows <code>res_pjsip</code> to register to other SIP servers.</p>
    54. 

  54. 

  55. 

  56. <h2 id="Asterisk13Configuration_res_pjsip_outbound_registration-pjsip.conf">pjsip.conf</h2>
    57. 

  57. 

  58. <h3 id="Asterisk13Configuration_res_pjsip_outbound_registration-registration">registration</h3>
    59. 

  59. 

  60. <p>The configuration for outbound registration</p>
    61. 

  61. 

  62. <h4 id="Asterisk13Configuration_res_pjsip_outbound_registration-ConfigurationOptionReference">Configuration Option Reference</h4>
    63. 

  63. 

  64. <div class="table-wrap"><table class="confluenceTable"><tbody>
    65. 

  65. <tr>
    66. 

  66. <th class="confluenceTh"><p> Option Name </p></th>
    67. 

  67. <th class="confluenceTh"><p> Type </p></th>
    68. 

  68. <th class="confluenceTh"><p> Default Value </p></th>
    69. 

  69. <th class="confluenceTh"><p> Regular Expression </p></th>
    70. 

  70. <th class="confluenceTh"><p> Description </p></th>
    71. 

  71. </tr>
    72. 

  72. <tr>
    73. 

  73. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>auth_rejection_permanent</code></a> </p></td>
    74. 

  74. <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
    75. 

  75. <td class="confluenceTd"><p> <code>yes</code> </p></td>
    76. 

  76. <td class="confluenceTd"><p> <code>false</code> </p></td>
    77. 

  77. <td class="confluenceTd"><p> Determines whether failed authentication challenges are treated as permanent failures. </p></td>
    78. 

  78. </tr>
    79. 

  79. <tr>
    80. 

  80. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>client_uri</code></a> </p></td>
    81. 

  81. <td class="confluenceTd"><p> <code>String</code> </p></td>
    82. 

  82. <td class="confluenceTd"><p> </p></td>
    83. 

  83. <td class="confluenceTd"><p> <code>false</code> </p></td>
    84. 

  84. <td class="confluenceTd"><p> Client SIP URI used when attemping outbound registration </p></td>
    85. 

  85. </tr>
    86. 

  86. <tr>
    87. 

  87. <td class="confluenceTd"><p> <code>contact_user</code> </p></td>
    88. 

  88. <td class="confluenceTd"><p> <code>String</code> </p></td>
    89. 

  89. <td class="confluenceTd"><p> </p></td>
    90. 

  90. <td class="confluenceTd"><p> <code>false</code> </p></td>
    91. 

  91. <td class="confluenceTd"><p> Contact User to use in request </p></td>
    92. 

  92. </tr>
    93. 

  93. <tr>
    94. 

  94. <td class="confluenceTd"><p> <code>expiration</code> </p></td>
    95. 

  95. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
    96. 

  96. <td class="confluenceTd"><p> <code>3600</code> </p></td>
    97. 

  97. <td class="confluenceTd"><p> <code>false</code> </p></td>
    98. 

  98. <td class="confluenceTd"><p> Expiration time for registrations in seconds </p></td>
    99. 

  99. </tr>
    100. 

  100. <tr>
    101. 

  101. <td class="confluenceTd"><p> <code>max_retries</code> </p></td>
    102. 

  102. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
    103. 

  103. <td class="confluenceTd"><p> <code>10</code> </p></td>
    104. 

  104. <td class="confluenceTd"><p> <code>false</code> </p></td>
    105. 

  105. <td class="confluenceTd"><p> Maximum number of registration attempts. </p></td>
    106. 

  106. </tr>
    107. 

  107. <tr>
    108. 

  108. <td class="confluenceTd"><p> <code>outbound_auth</code> </p></td>
    109. 

  109. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
    110. 

  110. <td class="confluenceTd"><p> </p></td>
    111. 

  111. <td class="confluenceTd"><p> <code>false</code> </p></td>
    112. 

  112. <td class="confluenceTd"><p> Authentication object to be used for outbound registrations. </p></td>
    113. 

  113. </tr>
    114. 

  114. <tr>
    115. 

  115. <td class="confluenceTd"><p> <code>outbound_proxy</code> </p></td>
    116. 

  116. <td class="confluenceTd"><p> <code>String</code> </p></td>
    117. 

  117. <td class="confluenceTd"><p> </p></td>
    118. 

  118. <td class="confluenceTd"><p> <code>false</code> </p></td>
    119. 

  119. <td class="confluenceTd"><p> Outbound Proxy used to send registrations </p></td>
    120. 

  120. </tr>
    121. 

  121. <tr>
    122. 

  122. <td class="confluenceTd"><p> <code>retry_interval</code> </p></td>
    123. 

  123. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
    124. 

  124. <td class="confluenceTd"><p> <code>60</code> </p></td>
    125. 

  125. <td class="confluenceTd"><p> <code>false</code> </p></td>
    126. 

  126. <td class="confluenceTd"><p> Interval in seconds between retries if outbound registration is unsuccessful </p></td>
    127. 

  127. </tr>
    128. 

  128. <tr>
    129. 

  129. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>forbidden_retry_interval</code></a> </p></td>
    130. 

  130. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
    131. 

  131. <td class="confluenceTd"><p> <code>0</code> </p></td>
    132. 

  132. <td class="confluenceTd"><p> <code>false</code> </p></td>
    133. 

  133. <td class="confluenceTd"><p> Interval used when receiving a 403 Forbidden response. </p></td>
    134. 

  134. </tr>
    135. 

  135. <tr>
    136. 

  136. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>server_uri</code></a> </p></td>
    137. 

  137. <td class="confluenceTd"><p> <code>String</code> </p></td>
    138. 

  138. <td class="confluenceTd"><p> </p></td>
    139. 

  139. <td class="confluenceTd"><p> <code>false</code> </p></td>
    140. 

  140. <td class="confluenceTd"><p> SIP URI of the server to register against </p></td>
    141. 

  141. </tr>
    142. 

  142. <tr>
    143. 

  143. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>transport</code></a> </p></td>
    144. 

  144. <td class="confluenceTd"><p> <code>String</code> </p></td>
    145. 

  145. <td class="confluenceTd"><p> </p></td>
    146. 

  146. <td class="confluenceTd"><p> <code>false</code> </p></td>
    147. 

  147. <td class="confluenceTd"><p> Transport used for outbound authentication </p></td>
    148. 

  148. </tr>
    149. 

  149. <tr>
    150. 

  150. <td class="confluenceTd"><p> <code>type</code> </p></td>
    151. 

  151. <td class="confluenceTd"><p> <code>None</code> </p></td>
    152. 

  152. <td class="confluenceTd"><p> </p></td>
    153. 

  153. <td class="confluenceTd"><p> <code>false</code> </p></td>
    154. 

  154. <td class="confluenceTd"><p> Must be of type 'registration'. </p></td>
    155. 

  155. </tr>
    156. 

  156. <tr>
    157. 

  157. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>support_path</code></a> </p></td>
    158. 

  158. <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
    159. 

  159. <td class="confluenceTd"><p> <code>no</code> </p></td>
    160. 

  160. <td class="confluenceTd"><p> <code>false</code> </p></td>
    161. 

  161. <td class="confluenceTd"><p> Enables Path support for outbound REGISTER requests. </p></td>
    162. 

  162. </tr>
    163. 

  163. </tbody></table></div>
    164. 

  164. 

  165. <h4 id="Asterisk13Configuration_res_pjsip_outbound_registration-ConfigurationOptionDescriptions">Configuration Option Descriptions</h4>
    166. 

  166. 

  167. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_auth_rejection_permanent"></span></p>
    168. 

  168. <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-auth_rejection_permanent">auth_rejection_permanent</h5>
    169. 

  169. 

  170. <p>If this option is enabled and an authentication challenge fails, registration will not be attempted again until the configuration is reloaded.</p>
    171. 

  171. 

  172. 

  173. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_client_uri"></span></p>
    174. 

  174. <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-client_uri">client_uri</h5>
    175. 

  175. 

  176. <p>This is the address-of-record for the outbound registration (i.e. the URI in the To header of the REGISTER).</p>
    177. 

  177. 

  178. <p>For registration with an ITSP, the client SIP URI may need to consist of an account name or number and the provider's hostname for their registrar, e.g. client_uri=1234567890@example.com. This may differ between providers.</p>
    179. 

  179. 

  180. <p>For registration to generic registrars, the client SIP URI will depend on networking specifics and configuration of the registrar.</p>
    181. 

  181. 

  182. 

  183. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_forbidden_retry_interval"></span></p>
    184. 

  184. <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-forbidden_retry_interval">forbidden_retry_interval</h5>
    185. 

  185. 

  186. <p>If a 403 Forbidden is received, chan_pjsip will wait <em>forbidden_retry_interval</em> seconds before attempting registration again. If 0 is specified, chan_pjsip will not retry after receiving a 403 Forbidden response. Setting this to a non-zero value goes against a &quot;SHOULD NOT&quot; in RFC3261, but can be used to work around buggy registrars.</p>
    187. 

  187. 

  188. 

  189. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_server_uri"></span></p>
    190. 

  190. <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-server_uri">server_uri</h5>
    191. 

  191. 

  192. <p>This is the URI at which to find the registrar to send the outbound REGISTER. This URI is used as the request URI of the outbound REGISTER request from Asterisk.</p>
    193. 

  193. 

  194. <p>For registration with an ITSP, the setting may often be just the domain of the registrar, e.g. sip:sip.example.com.</p>
    195. 

  195. 

  196. 

  197. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_transport"></span></p>
    198. 

  198. <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-transport">transport</h5>
    199. 

  199. 

  200.     <div class="aui-message hint shadowed information-macro">
    201. 

  201.                     <p class="title">Note</p>
    202. 

  202.                             <span class="aui-icon icon-hint">Icon</span>
    203. 

  203.                 <div class="message-content">
    204. 

  204.                             
    205. 

  205. <p>A <em>transport</em> configured in <code>pjsip.conf</code>. As with other <code>res_pjsip</code> modules, this will use the first available transport of the appropriate type if unconfigured.</p>
    206. 

  206. 

  207.                     </div>
    208. 

  208.     </div>
    209. 

  209. 

  210. 

  211. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_support_path"></span></p>
    212. 

  212. <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-support_path">support_path</h5>
    213. 

  213. 

  214. <p>When this option is enabled, outbound REGISTER requests will advertise support for Path headers so that intervening proxies can add to the Path header as necessary.</p>
    215. 

  215. 

  216. 

  217. 

  218. <h3 id="Asterisk13Configuration_res_pjsip_outbound_registration-ImportVersion">Import Version</h3>
    219. 

  219. 

  220. <p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
    221. 

  221.                     </div>
    222. 

  222. 

  223.                     
    224. 

  224.                  
    225. 

  225.                 </div>             </div> 
    226. 

  226.             <div id="footer">
    227. 

  227.                 <section class="footer-body">
    228. 

  228.                     <p>Document generated by Confluence on Aug 11, 2014 13:49</p>
    229. 

  229.                 </section>
    230. 

  230.             </div>
    231. 

  231.         </div>     </body>
    232. 

  232. </html>
    233.