res_pjsip_config_wizard: Module that provides simple configuration wizard capabilities.¶

This configuration documentation is for functionality provided by res_pjsip_config_wizard.

Overview¶

PJSIP Configuration Wizard

This module allows creation of common PJSIP configuration scenarios without having to specify individual endpoint, aor, auth, identify and registration objects.

For example, the following configuration snippet would create the endpoint, aor, contact, auth and phoneprov objects necessary for a phone to get phone provisioning information, register, and make and receive calls. A hint is also created in the default context for extension 1000.

[myphone]

type = wizard

sends_auth = no

accepts_auth = yes

sends_registrations = no

accepts_registrations = yes

has_phoneprov = yes

transport = ipv4

has_hint = yes

hint_exten = 1000

inbound_auth/username = testname

inbound_auth/password = test password

endpoint/allow = ulaw

endpoint/context = default

phoneprov/MAC = 001122aa4455

phoneprov/PROFILE = profile1

The first 8 items are specific to the wizard. The rest of the items are passed verbatim to the underlying objects.

The following configuration snippet would create the endpoint, aor, contact, auth, identify and registration objects necessary for a trunk to another pbx or ITSP that requires registration.

[mytrunk]

type = wizard

sends_auth = yes

accepts_auth = no

sends_registrations = yes

accepts_registrations = no

transport = ipv4

remote_hosts = sip1.myitsp.com:5060,sip2.myitsp.com:5060

outbound_auth/username = testname

outbound_auth/password = test password

endpoint/allow = ulaw

endpoint/context = default

Of course, any of the items in either example could be placed into templates and shared among wizard objects.

For more information, visit:

https://wiki.asterisk.org/wiki/display/AST/PJSIP+Configuration+Wizard

Configuration File: pjsip_wizard.conf¶

[wizard]: Provides config wizard.¶

For more information, visit:

https://wiki.asterisk.org/wiki/display/AST/PJSIP+Configuration+Wizard

Configuration Option Reference¶

Configuration Option Descriptions¶

accepts_auth¶

At least inbound_auth/username is required.

accepts_registrations¶

An AOR with dynamic contacts will be created. If the number of contacts nneds to be limited, set aor/max_contacts.

aor/*¶

If an aor/contact is explicitly defined then remote_hosts will not be used to create contacts automatically.

client_uri_pattern¶

The literals '${REMOTE_HOST}' and '${USERNAME}' will be substituted with the appropriate remote_host and outbound_auth/username.

contact_pattern¶

The literal '${REMOTE_HOST}' will be substituted with the appropriate remote_host for each contact.

has_hint¶

Create hint and optionally a default application.

has_phoneprov¶

A phoneprov object will be created. phoneprov/MAC must be specified.

hint_application¶

Ignored if 'hint_exten' isn't specified otherwise will create the following priority 1 extension in 'hint_context':

'exten => ,1,'

You can specify any valid extensions.conf application expression.

Examples:

'Dial(${HINT})'

'Gosub(stdexten,${EXTEN},1(${HINT}))'

Any extensions.conf style variables specified are passed directly to the dialplan.

Normal dialplan precedence rules apply so if there's already a priority 1 application for this specific extension in 'hint_context', this one will be ignored. For more information, visit:

https://wiki.asterisk.org/wiki/display/AST/PJSIP+Configuration+Wizard

hint_context¶

Ignored if 'hint_exten' is not specified otherwise specifies the context into which the dialplan hints will be placed. If not specified, defaults to the endpoint's context or 'default' if that isn't found.

hint_exten¶

Will create the following entry in 'hint_context':

'exten => ,hint,PJSIP/'

Normal dialplan precedence rules apply so if there's already a hint for this extension in 'hint_context', this one will be ignored. For more information, visit:

https://wiki.asterisk.org/wiki/display/AST/PJSIP+Configuration+Wizard

identify/*¶

If an identify/match is explicitly defined then remote_hosts will not be used to create matches automatically.

outbound_proxy¶

Shortcut for specifying endpoint/outbound_proxy, aor/outbound_proxy, and registration/outbound_proxy individually.

phoneprov/*¶

To activate phoneprov, at least phoneprov/MAC must be set.

remote_hosts¶

A comma-separated list of remote hosts in the form of host[:port]. If set, an aor static contact and an identify match will be created for each entry in the list. If send_registrations is also set, a registration will also be created for each.

sends_auth¶

At least outbound_auth/username is required.

sends_line_with_registrations¶

Setting this to true will cause the wizard to skip the creation of an identify object to match incoming requests to the endpoint and instead add the line and endpoint parameters to the outbound registration object.

sends_registrations¶

remote_hosts is required and a registration object will be created for each host in the remote _hosts string. If authentication is required, sends_auth and an outbound_auth/username must also be supplied.

server_uri_pattern¶

The literal '${REMOTE_HOST}' will be substituted with the appropriate remote_host for each registration.

transport¶

If not specified, the default will be used.

Generated Version¶

This documentation was generated from Asterisk branch certified/18.9 using version GIT