summaryrefslogtreecommitdiff
path: root/configs/samples/pjsip_wizard.conf.sample
blob: 8c8572e4d34f9d2cc66790b313b6562e70638e4d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
; 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")

;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.
                         ; (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: "")

;outbound_proxy= ; Setting this is a shortcut for setting
                 ; endpoint/outbound_proxy
                 ; aor/outbound_proxy
                 ; registration/outbound_proxy

;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: "")