# Asterisk Project : Asterisk 13 Configuration_res_pjsip_outbound_registration

Created by wikibot on Aug 08, 2014

# SIP resource for outbound registrations

This configuration documentation is for functionality provided by `res_pjsip_outbound_registration`.

## Overview

Outbound Registration

This module allows `res_pjsip` to register to other SIP servers.

## pjsip.conf

### registration

The configuration for outbound registration

#### Configuration Option Reference

Option Name | Type | Default Value | Regular Expression | Description
--- | --- | --- | --- | ---
`auth_rejection_permanent` | `Boolean` | `yes` | `false` | Determines whether failed authentication challenges are treated as permanent failures.
`client_uri` | `String` |  | `false` | Client SIP URI used when attemping outbound registration
`contact_user` | `String` |  | `false` | Contact User to use in request
`expiration` | `Unsigned Integer` | `3600` | `false` | Expiration time for registrations in seconds
`max_retries` | `Unsigned Integer` | `10` | `false` | Maximum number of registration attempts.
`outbound_auth` | `Custom` |  | `false` | Authentication object to be used for outbound registrations.
`outbound_proxy` | `String` |  | `false` | Outbound Proxy used to send registrations
`retry_interval` | `Unsigned Integer` | `60` | `false` | Interval in seconds between retries if outbound registration is unsuccessful
`forbidden_retry_interval` | `Unsigned Integer` | `0` | `false` | Interval used when receiving a 403 Forbidden response.
`server_uri` | `String` |  | `false` | SIP URI of the server to register against
`transport` | `String` |  | `false` | Transport used for outbound authentication
`type` | `None` |  | `false` | Must be of type 'registration'.
`support_path` | `Boolean` | `no` | `false` | Enables Path support for outbound REGISTER requests.

#### Configuration Option Descriptions

##### auth_rejection_permanent

If this option is enabled and an authentication challenge fails, registration will not be attempted again until the configuration is reloaded.

##### client_uri

This is the address-of-record for the outbound registration (i.e. the URI in the To header of the REGISTER).

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.

For registration to generic registrars, the client SIP URI will depend on networking specifics and configuration of the registrar.

##### forbidden_retry_interval

If a 403 Forbidden is received, chan_pjsip will wait forbidden_retry_interval 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.

##### server_uri

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.

For registration with an ITSP, the setting may often be just the domain of the registrar, e.g. sip:sip.example.com.

##### transport

Note

Icon

A transport configured in `pjsip.conf`. As with other `res_pjsip` modules, this will use the first available transport of the appropriate type if unconfigured.

##### support_path

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.

### Import Version

This documentation was imported from Asterisk Version SVN-branch-13-r420538