mirror of
https://github.com/asterisk/asterisk.git
synced 2025-10-31 02:37:10 +00:00
4d8ab20a8a
Looking at the Super Awesome Company sample reminded me that creating hints is just plain gruntwork. So you can now have the pjsip conifg wizard auto-create them for you. Specifying 'hint_exten' in the wizard will create 'exten => <hint_exten>,hint/PJSIP/<wizard_id>' in whatever is specified for 'hint_context'. Specifying 'hint_application' in the wizard will create 'exten => <hint_exten>,1,<hint_application>' in whatever is specified for 'hint_context'. The default for 'hint_context' is the endpoint's context. There's no default for 'hint_application'. If not specified, no app is added. There's no default for 'hint_exten'. If not specified, neither the hint itself nor the application will be created. Some may think this is the slippery slope to users.conf but hints are a basic necessity for phones unlike voicemail, manager, etc that users.conf creates. Tested-by: George Joseph Review: https://reviewboard.asterisk.org/r/4383/ git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/13@431643 65c4cc65-6c06-0410-ace0-fbb531ad65f3
148 lines
5.9 KiB
Plaintext
148 lines
5.9 KiB
Plaintext
; PJSIP Wizard Configuration Samples and Quick Reference
|
|
;
|
|
; This file has several very basic configuration examples, to serve as a quick
|
|
; reference to jog your memory when you need to write up a new configuration.
|
|
; It is not intended to teach PJSIP configuration or serve as an exhaustive
|
|
; reference of options and potential scenarios.
|
|
;
|
|
; This file has two main sections.
|
|
; First, manually written examples to serve as a handy reference.
|
|
; Second, a list of all possible PJSIP config options by section. This is
|
|
; pulled from the XML config help. It only shows the synopsis for every item.
|
|
; If you want to see more detail please check the documentation sources
|
|
; mentioned at the top of this file.
|
|
|
|
; Documentation
|
|
;
|
|
; The official documentation is at http://wiki.asterisk.org
|
|
; You can read the XML configuration help via Asterisk command line with
|
|
; "config show help res_pjsip_config_wizard", then you can drill down through
|
|
; the various sections and their options.
|
|
;
|
|
|
|
|
|
;============EXAMPLE WIZARD CONFIGURATION FOR A PHONE=======================
|
|
|
|
; This config would create an endpoint, aor with dynamic contact, inbound
|
|
; auth, a phoneprov object and a dialplan hint for extension 1000.
|
|
|
|
;[myphone]
|
|
;type = wizard
|
|
;accepts_auth = yes
|
|
;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
|
|
|
|
|
|
;============EXAMPLE WIZARD CONFIGURATION FOR AN ITSP TRUNK=================
|
|
|
|
; This ITSP has 2 servers available and requires registration.
|
|
|
|
; This config would create an endpoint, an aor with 2 static contacts, an
|
|
; outbound auth, an identify with 2 matches, and 2 registrations.
|
|
|
|
;[mytrunk]
|
|
;type = wizard
|
|
;sends_auth = yes
|
|
;sends_registrations = yes
|
|
;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
|
|
|
|
|
|
;========================WIZARD SECTION OPTIONS===============================
|
|
;[wizard]
|
|
; SYNOPSIS: Provides configuration wizard for common scenarios.
|
|
;sends_auth= ; Will create an outbound auth object for the endpoint and
|
|
; registration.
|
|
; If yes, outbound/username must be specified.
|
|
; (default = "no")
|
|
|
|
;accepts_auth= ; Will create an inbound auth object for the endpoint.
|
|
; If yes, inbound/username must be specified.
|
|
; (default = "no")
|
|
|
|
;sends_registrations= ; Will create an outbound registration object and an
|
|
; identify match for each host in remote_hosts (which
|
|
; must be specified).
|
|
; sends_auth must also be specified.
|
|
; (default: "no")
|
|
|
|
;accepts_registrations= ; Will create an aor with dynamic contacts which will
|
|
; accept registrations.
|
|
; accepts_auth must also be specified.
|
|
; (default: "no")
|
|
|
|
;remote_hosts= ; A comma separated list of remote hosts in the form of
|
|
; <ipaddress | hostname>[:port] [,<ipaddress | hostname>[:port] ] ...
|
|
; If specified, a static contact for each host will be created
|
|
; in the aor. If accepts_registrations is no, an identify
|
|
; object is also created with a match line for each remote host.
|
|
; If an aor/contact or match/identify is explicitly supplied,
|
|
; remote_hosts will not be used to automatically create contacts
|
|
; or matches respectively.
|
|
; Hostnames must resolve to A, AAAA or CNAME records.
|
|
; SRV records are not currently supported.
|
|
; (default: "")
|
|
|
|
;transport= ; The transport to use for the endpoint and registrations
|
|
; (default: the pjsip default)
|
|
|
|
;server_uri_pattern= ; The pattern used to construct the registration
|
|
; server_uri. The replaceable parameter ${REMOTE_HOST} isa
|
|
; available for use.
|
|
; (default: "sip:${REMOTE_HOST}")
|
|
|
|
;client_uri_pattern= ; The pattern used to construct the registration client_uri.
|
|
; The replaceable parameters ${REMOTE_HOST} and ${USERNAME}
|
|
; are available for use.
|
|
; (default: "sip:${USERNAME}@${REMOTE_HOST}")
|
|
|
|
;contact_pattern= ; The pattern used to construct the aor contact.
|
|
; The replaceable parameter ${REMOTE_HOST} is available
|
|
; for use.
|
|
; (default: "sip:${REMOTE_HOST}")
|
|
|
|
;has_phoneprov= ; Will create a phoneprov object.
|
|
; If yes, phoneprov/MAC must be specified.
|
|
; (default: "no")
|
|
|
|
;has_hint= ; Create hint and optionally a default application.
|
|
; (default: "no")
|
|
|
|
;hint_context ; Any hints created for this wizard will be placed in this
|
|
; context.
|
|
; (default: endpoint/context)
|
|
|
|
;hint_exten ; If specified, a PJSIP/<wizard_id> hint will be created
|
|
; for this extension in 'hint_context'.
|
|
; context.
|
|
; (default: none)
|
|
|
|
;hint_application ; If specified, an extension will be placed in 'hint_context'
|
|
; at priority 1 that calls this application. Could be any
|
|
; valid dialplan expression like
|
|
; "Gosub(stdexten,${EXTEN},1(${HINT}))"
|
|
; (default: "Dial(${HINT})")
|
|
|
|
;endpoint/<param> ; Any parameters to be passed directly to and validated
|
|
;aor/<param> ; by their respective objects.
|
|
;inbound_auth/<param>
|
|
;outbound_auth/<param>
|
|
;identify/<param>
|
|
;registration/<param>
|
|
;phoneprov/<param>
|
|
|
|
;type= ; Must be of type wizard (default: "")
|