123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232 |
- <!DOCTYPE html>
- <html>
- <head>
- <title>Asterisk Project : Asterisk 13 Configuration_res_pjsip_outbound_registration</title>
- <link rel="stylesheet" href="styles/site.css" type="text/css" />
- <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
- </head>
- <body class="theme-default aui-theme-default">
- <div id="page">
- <div id="main" class="aui-page-panel">
- <div id="main-header">
- <div id="breadcrumb-section">
- <ol id="breadcrumbs">
- <li class="first">
- <span><a href="index.html">Asterisk Project</a></span>
- </li>
- <li>
- <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
- </li>
- <li>
- <span><a href="Asterisk-13-Module-Configuration_29394289.html">Asterisk 13 Module Configuration</a></span>
- </li>
- </ol>
- </div>
- <h1 id="title-heading" class="pagetitle">
- <span id="title-text">
- Asterisk Project : Asterisk 13 Configuration_res_pjsip_outbound_registration
- </span>
- </h1>
- </div>
- <div id="content" class="view">
- <div class="page-metadata">
-
-
-
-
-
-
-
- Created by <span class='author'> wikibot</span> on Aug 08, 2014
- </div>
- <div id="main-content" class="wiki-content group">
- <h1 id="Asterisk13Configuration_res_pjsip_outbound_registration-SIPresourceforoutboundregistrations">SIP resource for outbound registrations</h1>
- <p>This configuration documentation is for functionality provided by <code>res_pjsip_outbound_registration</code>.</p>
- <h2 id="Asterisk13Configuration_res_pjsip_outbound_registration-Overview">Overview</h2>
- <p><strong>Outbound Registration</strong></p>
- <p>This module allows <code>res_pjsip</code> to register to other SIP servers.</p>
- <h2 id="Asterisk13Configuration_res_pjsip_outbound_registration-pjsip.conf">pjsip.conf</h2>
- <h3 id="Asterisk13Configuration_res_pjsip_outbound_registration-registration">registration</h3>
- <p>The configuration for outbound registration</p>
- <h4 id="Asterisk13Configuration_res_pjsip_outbound_registration-ConfigurationOptionReference">Configuration Option Reference</h4>
- <div class="table-wrap"><table class="confluenceTable"><tbody>
- <tr>
- <th class="confluenceTh"><p> Option Name </p></th>
- <th class="confluenceTh"><p> Type </p></th>
- <th class="confluenceTh"><p> Default Value </p></th>
- <th class="confluenceTh"><p> Regular Expression </p></th>
- <th class="confluenceTh"><p> Description </p></th>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>auth_rejection_permanent</code></a> </p></td>
- <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
- <td class="confluenceTd"><p> <code>yes</code> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Determines whether failed authentication challenges are treated as permanent failures. </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>client_uri</code></a> </p></td>
- <td class="confluenceTd"><p> <code>String</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Client SIP URI used when attemping outbound registration </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>contact_user</code> </p></td>
- <td class="confluenceTd"><p> <code>String</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Contact User to use in request </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>expiration</code> </p></td>
- <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
- <td class="confluenceTd"><p> <code>3600</code> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Expiration time for registrations in seconds </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>max_retries</code> </p></td>
- <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
- <td class="confluenceTd"><p> <code>10</code> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Maximum number of registration attempts. </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>outbound_auth</code> </p></td>
- <td class="confluenceTd"><p> <code>Custom</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Authentication object to be used for outbound registrations. </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>outbound_proxy</code> </p></td>
- <td class="confluenceTd"><p> <code>String</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Outbound Proxy used to send registrations </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>retry_interval</code> </p></td>
- <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
- <td class="confluenceTd"><p> <code>60</code> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Interval in seconds between retries if outbound registration is unsuccessful </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>forbidden_retry_interval</code></a> </p></td>
- <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
- <td class="confluenceTd"><p> <code>0</code> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Interval used when receiving a 403 Forbidden response. </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>server_uri</code></a> </p></td>
- <td class="confluenceTd"><p> <code>String</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> SIP URI of the server to register against </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>transport</code></a> </p></td>
- <td class="confluenceTd"><p> <code>String</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Transport used for outbound authentication </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <code>type</code> </p></td>
- <td class="confluenceTd"><p> <code>None</code> </p></td>
- <td class="confluenceTd"><p> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Must be of type 'registration'. </p></td>
- </tr>
- <tr>
- <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_pjsip_outbound_registration_29394801.html"><code>support_path</code></a> </p></td>
- <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
- <td class="confluenceTd"><p> <code>no</code> </p></td>
- <td class="confluenceTd"><p> <code>false</code> </p></td>
- <td class="confluenceTd"><p> Enables Path support for outbound REGISTER requests. </p></td>
- </tr>
- </tbody></table></div>
- <h4 id="Asterisk13Configuration_res_pjsip_outbound_registration-ConfigurationOptionDescriptions">Configuration Option Descriptions</h4>
- <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_auth_rejection_permanent"></span></p>
- <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-auth_rejection_permanent">auth_rejection_permanent</h5>
- <p>If this option is enabled and an authentication challenge fails, registration will not be attempted again until the configuration is reloaded.</p>
- <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_client_uri"></span></p>
- <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-client_uri">client_uri</h5>
- <p>This is the address-of-record for the outbound registration (i.e. the URI in the To header of the REGISTER).</p>
- <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>
- <p>For registration to generic registrars, the client SIP URI will depend on networking specifics and configuration of the registrar.</p>
- <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_forbidden_retry_interval"></span></p>
- <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-forbidden_retry_interval">forbidden_retry_interval</h5>
- <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 "SHOULD NOT" in RFC3261, but can be used to work around buggy registrars.</p>
- <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_server_uri"></span></p>
- <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-server_uri">server_uri</h5>
- <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>
- <p>For registration with an ITSP, the setting may often be just the domain of the registrar, e.g. sip:sip.example.com.</p>
- <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_transport"></span></p>
- <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-transport">transport</h5>
- <div class="aui-message hint shadowed information-macro">
- <p class="title">Note</p>
- <span class="aui-icon icon-hint">Icon</span>
- <div class="message-content">
-
- <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>
- </div>
- </div>
- <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_pjsip_outbound_registration-registration_support_path"></span></p>
- <h5 id="Asterisk13Configuration_res_pjsip_outbound_registration-support_path">support_path</h5>
- <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>
- <h3 id="Asterisk13Configuration_res_pjsip_outbound_registration-ImportVersion">Import Version</h3>
- <p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
- </div>
-
-
- </div> </div>
- <div id="footer">
- <section class="footer-body">
- <p>Document generated by Confluence on Aug 11, 2014 13:49</p>
- </section>
- </div>
- </div> </body>
- </html>
|