New pjsip.conf.sample
[asterisk/asterisk.git] / configs / pjsip.conf.sample
1 ; PJSIP Configuration Samples and Quick Reference
2 ;
3 ; This file has several very basic configuration examples, to serve as a quick
4 ; reference to jog your memory when you need to write up a new configuration.
5 ; It is not intended to teach PJSIP configuration or serve as an exhaustive
6 ; reference of options and potential scenarios.
7 ;
8 ; This file has two main sections.
9 ; First, manually written examples to serve as a handy reference.
10 ; Second, a list of all possible PJSIP config options by section. This is
11 ; pulled from the XML config help. It only shows the synopsis for every item.
12 ; If you want to see more detail please check the documentation sources
13 ; mentioned at the top of this file.
14
15 ; Documentation
16 ;
17 ; The official documentation is at http://wiki.asterisk.org
18 ; You can read the XML configuration help via Asterisk command line with
19 ; "config show help res_pjsip", then you can drill down through the various
20 ; sections and their options.
21 ;
22
23 ;========!!!!!!!!!!!!!!!!!!!  SECURITY NOTICE  !!!!!!!!!!!!!!!!!!!!===========
24 ;
25 ; At a minimum please read the file "README-SERIOUSLY.bestpractices.txt",
26 ; located in the Asterisk source directory before starting Asterisk.
27 ; Otherwise you risk allowing the security of the Asterisk system to be
28 ; compromised. Beyond that please visit and read the security information on
29 ; the wiki at: https://wiki.asterisk.org/wiki/x/EwFB
30 ;
31 ; A few basics to pay attention to:
32 ;
33 ; Anonymous Calls
34 ;
35 ; By default anonymous inbound calls via PJSIP are not allowed. If you want to
36 ; route anonymous calls you'll need to define an endpoint named "anonymous".
37 ; res_pjsip_endpoint_identifier_anonymous.so handles that functionality so it
38 ; must be loaded. It is not recommended to accept anonymous calls.
39 ;
40 ; Access Control Lists
41 ;
42 ; See the example ACL configuration in this file. Read the configuration help
43 ; for the section and all of its options. Look over the samples in acl.conf
44 ; and documentation at https://wiki.asterisk.org/wiki/x/uA80AQ
45 ; If possible, restrict access to only networks and addresses you trust.
46 ;
47 ; Dialplan Contexts
48 ;
49 ; When defining configuration (such as an endpoint) that links into
50 ; dialplan configuration, be aware of what that dialplan does. It's easy to
51 ; accidentally provide access to internal or outbound dialing extensions which
52 ; could cost you severely. The "context=" line in endpoint configuration
53 ; determines which dialplan context inbound calls will enter into.
54 ;
55 ;=============================================================================
56
57 ; Overview of Configuration Section Types Used in the Examples
58 ;
59 ; * Transport "transport"
60 ;   * Configures res_pjsip transport layer interaction.
61 ; * Endpoint "endpoint"
62 ;   * Configures core SIP functionality related to SIP endpoints.
63 ; * Authentication "auth"
64 ;   * Stores inbound or outbound authentication credentials for use by trunks,
65 ;     endpoints, registrations.
66 ; * Address of Record "aor"
67 ;   * Stores contact information for use by endpoints.
68 ; * Endpoint Identification "identify"
69 ;   * Maps a host directly to an endpoint
70 ; * Access Control List "acl"
71 ;   * Defines a permission list or references one stored in acl.conf
72 ; * Registration "registration"
73 ;   * Contains information about an outbound SIP registration
74
75 ; The following sections show example configurations for various scenarios.
76 ; Most require a couple or more configuration types configured in concert.
77
78 ;===============EXAMPLE TRANSPORTS============================================
79 ;
80 ; A few examples for potential transport options.
81 ;
82 ; For the NAT transport example, be aware that the options starting with
83 ; the prefix "external_" will only apply to communication with addresses
84 ; outside the range set with "localnet=".
85 ;
86 ; IPv6: For endpoints using IPv6, remember to set "rtp_ipv6=yes" so that the RTP
87 ; engine will also be able to bind to an IPv6 address.
88 ;
89 ; You can have more than one of any type of transport, as long as it doesn't
90 ; use the same resources (bind address, port, etc) as the others.
91
92 ; Basic UDP transport
93 ;
94 ;[transport-udp]
95 ;type=transport
96 ;protocol=udp    ;udp,tcp,tls,ws,wss
97 ;bind=0.0.0.0
98
99 ; UDP transport behind NAT
100 ;
101 ;[transport-udp-nat]
102 ;type=transport
103 ;protocol=udp
104 ;bind=0.0.0.0
105 ;localnet=192.0.2.0/24
106 ;external_media_address=203.0.113.1
107 ;external_signaling_address=203.0.113.1
108
109 ; Basic IPv6 UDP transport
110 ;
111 ;[transport-udp-ipv6]
112 ;type=transport
113 ;protocol=udp
114 ;bind=::
115
116 ; Example IPv4 TLS transport
117 ;
118 ;[transport-tls]
119 ;type=transport
120 ;protocol=tls
121 ;bind=0.0.0.0
122 ;cert_file=/path/mycert.crt
123 ;privkey_file=/path/mykey.key
124 ;cipher=ALL
125 ;method=tlsv1
126
127
128 ;===============OUTBOUND REGISTRATION WITH OUTBOUND AUTHENTICATION============
129 ;
130 ; This is a simple registration that works with some SIP trunking providers.
131 ; You'll need to set up the auth example "mytrunk_auth" below to enable outbound
132 ; authentication. Note that we "outbound_auth=" use for outbound authentication
133 ; instead of "auth=", which is for inbound authentication.
134 ;
135 ; If you are registering to a server from behind NAT, be sure you assign a transport
136 ; that is appropriately configured with NAT related settings. See the NAT transport example.
137 ;
138 ; "contact_user=" sets the SIP contact header's user portion of the SIP URI
139 ; this will affect the extension reached in dialplan when the far end calls you at this
140 ; registration. The default is 's'.
141
142 ;[mytrunk]
143 ;type=registration
144 ;transport=transport-udp
145 ;outbound_auth=mytrunk_auth
146 ;server_uri=sip:sip.example.com
147 ;client_uri=sip:1234567890@sip.example.com
148 ;contact_user=1234567890
149 ;retry_interval=60
150 ;expiration=3600
151
152 ;[mytrunk_auth]
153 ;type=auth
154 ;auth_type=userpass
155 ;password=1234567890
156 ;username=1234567890
157 ;realm=sip.example.com
158
159 ;===============ENDPOINT CONFIGURED AS A TRUNK, OUTBOUND AUTHENTICATION=======
160 ;
161 ; This is one way to configure an endpoint as a trunk. It is set up with
162 ; "outbound_auth=" to enable authentication when dialing out through this
163 ; endpoint. There is no inbound authentication set up since a provider will
164 ; not normally authenticate when calling you.
165 ;
166 ; The identify configuration enables IP address matching against this endpoint.
167 ; For calls from a trunking provider, the From user may be different every time,
168 ; so we want to match against IP address instead of From user.
169 ;
170 ; If you want the provider of your trunk to know where to send your calls
171 ; you'll need to use an outbound registration as in the example above this
172 ; section.
173 ;
174 ; NAT
175 ;
176 ; At a basic level configure the endpoint with a transport that is set up
177 ; with the appropriate NAT settings. There may be some additional settings you
178 ; need here based on your NAT/Firewall scenario. Look to the CLI config help
179 ; "config show help res_pjsip endpoint" or on the wiki for other NAT related
180 ; options and configuration. We've included a few below.
181 ;
182 ; AOR
183 ;
184 ; Endpoints use one or more AOR sections to store their contact details.
185 ; You can define multiple contact addresses in SIP URI format in multiple
186 ; "contact=" entries.
187 ;
188 ; Section Naming
189 ;
190 ; Sections can have the same name as long as their "type="
191 ; options are set to different values.
192
193 ;[mytrunk]
194 ;type=endpoint
195 ;transport=transport-udp
196 ;context=from-external
197 ;disallow=all
198 ;allow=ulaw
199 ;outbound_auth=mytrunk
200 ;aors=mytrunk
201 ;                   ;A few NAT relevant options that may come in handy.
202 ;force_rport=yes    ;It's a good idea to read the configuration help for each
203 ;direct_media=no    ;of these options.
204 ;ice_support=yes
205
206 ;[mytrunk]
207 ;type=aor
208 ;contact=sip:198.51.100.1:5060
209 ;contact=sip:198.51.100.2:5060
210
211 ;[mytrunk]
212 ;type=identify
213 ;endpoint=mytrunk
214 ;match=198.51.100.1
215 ;match=198.51.100.2
216
217
218 ;=============ENDPOINT CONFIGURED AS A TRUNK, INBOUND AUTH AND REGISTRATION===
219 ;
220 ; Here we are allowing a remote device to register to Asterisk and requiring
221 ; that they authenticate for registration and calls.
222 ; You'll note that this configuration is essentially the same as configuring
223 ; an endpoint for use with a SIP phone.
224
225
226 ;[7000]
227 ;type=endpoint
228 ;context=from-external
229 ;disallow=all
230 ;allow=ulaw
231 ;transport=transport-udp
232 ;auth=7000
233 ;aors=7000
234
235 ;[7000]
236 ;type=auth
237 ;auth_type=userpass
238 ;password=7000
239 ;username=7000
240
241 ;[7000]
242 ;type=aor
243 ;max_contacts=1
244
245
246 ;===============ENDPOINT CONFIGURED FOR USE WITH A SIP PHONE==================
247 ;
248 ; This example includes the endpoint, auth and aor configurations. It
249 ; requires inbound authentication and allows registration, as well as references
250 ; a transport that you'll need to uncomment from the previous examples.
251 ;
252 ; Uncomment one of the transport lines to choose which transport you want. If
253 ; not specified then the default transport chosen is the first defined transport
254 ; in the configuration file.
255 ;
256 ; Modify the "max_contacts=" line to change how many unique registrations to allow.
257 ;
258 ; Use the "contact=" line instead of max_contacts= if you want to statically
259 ; define the location of the device.
260 ;
261 ; If using the TLS enabled transport, you may want the "media_encryption=yes"
262 ; option to additionally enable SRTP, though they are not mutually inclusive.
263 ;
264 ; Use the "rtp_ipv6=yes" option if you want to utilize RTP over an ipv6 transport.
265 ;
266 ; If this endpoint were remote, and it was using a transport configured for NAT
267 ; then you likely want to use "direct_media=no" to prevent audio issues.
268
269
270 ;[6001]
271 ;type=endpoint
272 ;transport=transport-udp
273 ;context=from-internal
274 ;disallow=all
275 ;allow=ulaw
276 ;allow=gsm
277 ;auth=6001
278 ;aors=6001
279 ;
280 ; A few more transports to pick from, and some related options below them.
281 ;
282 ;transport=transport-tls
283 ;media_encryption=yes
284 ;transport=transport-udp-ipv6
285 ;rtp_ipv6=yes
286 ;transport=transport-udp-nat
287 ;direct_media=no
288 ;
289 ; MWI related options
290
291 ;aggregate_mwi=yes
292 ;mailboxes=6001@default,7001@default
293 ;mwifromuser=6001
294 ;
295 ; Extension and Device state options
296 ;
297 ;devicestate_busy_at=1
298 ;allowsubscribe=yes
299 ;subminexpiry=30
300
301 ;[6001]
302 ;type=auth
303 ;auth_type=userpass
304 ;password=6001
305 ;username=6001
306
307 ;[6001]
308 ;type=aor
309 ;max_contacts=1
310 ;contact=sip:6001@192.0.2.1:5060
311
312
313 ;============EXAMPLE ACL CONFIGURATION==========================================
314 ;
315 ; The ACL or Access Control List section defines a set of permissions to permit
316 ; or deny access to various address or addresses. Alternatively it references an
317 ; ACL configuration already set in acl.conf.
318 ;
319 ; The ACL configuration is independent of individual endpoint configuration and
320 ; operates on all inbound SIP communication using res_pjsip.
321
322 ; Reference an ACL defined in acl.conf.
323 ;
324 ;[acl]
325 ;type=acl
326 ;acl=example_named_acl1
327
328 ; Reference a contactacl specifically.
329 ;
330 ;[acl]
331 ;type=acl
332 ;contactacl=example_contact_acl1
333
334 ; Define your own ACL here in pjsip.conf and
335 ; permit or deny by IP address or range.
336 ;
337 ;[acl]
338 ;type=acl
339 ;deny=0.0.0.0/0.0.0.0
340 ;permit=209.16.236.0/24
341 ;deny=209.16.236.1
342
343 ; Restrict based on Contact Headers rather than IP.
344 ; Define options multiple times for various addresses or use a comma-delimited string.
345 ;
346 ;[acl]
347 ;type=acl
348 ;contactdeny=0.0.0.0/0.0.0.0
349 ;contactpermit=209.16.236.0/24
350 ;contactpermit=209.16.236.1
351 ;contactpermit=209.16.236.2,209.16.236.3
352
353 ; Restrict based on Contact Headers rather than IP and use
354 ; advanced syntax. Note the bang symbol used for "NOT", so we can deny
355 ; 209.16.236.12/32 within the permit= statement.
356 ;
357 ;[acl]
358 ;type=acl
359 ;contactdeny=0.0.0.0/0.0.0.0
360 ;contactpermit=209.16.236.0
361 ;permit=209.16.236.0/24, !209.16.236.12/32
362
363
364
365 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip
366 ;==========================ENDPOINT SECTION OPTIONS=========================
367 ;[endpoint]
368 ;  SYNOPSIS: Endpoint
369 ;100rel=yes     ; Allow support for RFC3262 provisional ACK tags (default:
370                 ; "yes")
371 ;aggregate_mwi=yes      ;  (default: "yes")
372 ;allow= ; Media Codec s to allow (default: "")
373 ;aors=  ; AoR s to be used with the endpoint (default: "")
374 ;auth=  ; Authentication Object s associated with the endpoint (default: "")
375 ;callerid=      ; CallerID information for the endpoint (default: "")
376 ;callerid_privacy=      ; Default privacy level (default: "")
377 ;callerid_tag=  ; Internal id_tag for the endpoint (default: "")
378 ;context=default        ; Dialplan context for inbound sessions (default:
379                         ; "default")
380 ;direct_media_glare_mitigation=none     ; Mitigation of direct media re INVITE
381                                         ; glare (default: "none")
382 ;direct_media_method=invite     ; Direct Media method type (default: "invite")
383 ;connected_line_method=invite   ; Connected line method type (default:
384                                 ; "invite")
385 ;direct_media=yes       ; Determines whether media may flow directly between
386                         ; endpoints (default: "yes")
387 ;disable_direct_media_on_nat=no ; Disable direct media session refreshes when
388                                 ; NAT obstructs the media session (default:
389                                 ; "no")
390 ;disallow=      ; Media Codec s to disallow (default: "")
391 ;dtmfmode=rfc4733       ; DTMF mode (default: "rfc4733")
392 ;external_media_address=        ; IP used for External Media handling (default:
393                                 ; "")
394 ;force_rport=yes        ; Force use of return port (default: "yes")
395 ;ice_support=no ; Enable the ICE mechanism to help traverse NAT (default: "no")
396 ;identify_by=username   ; Way s for Endpoint to be identified (default:
397                         ; "username")
398 ;mailboxes=     ; Mailbox es to be associated with (default: "")
399 ;mohsuggest=default     ; Default Music On Hold class (default: "default")
400 ;outbound_auth= ; Authentication object used for outbound requests (default:
401                 ; "")
402 ;outbound_proxy=        ; Proxy through which to send requests (default: "")
403 ;rewrite_contact=no     ; Allow Contact header to be rewritten with the source
404                         ; IP address port (default: "no")
405 ;rtp_ipv6=no    ; Allow use of IPv6 for RTP traffic (default: "no")
406 ;rtp_symmetric=no       ; Enforce that RTP must be symmetric (default: "no")
407 ;send_diversion=yes     ; Send the Diversion header conveying the diversion
408                         ; information to the called user agent (default: "yes")
409 ;send_pai=no    ; Send the P Asserted Identity header (default: "no")
410 ;send_rpid=no   ; Send the Remote Party ID header (default: "no")
411 ;timers_min_se=90       ; Minimum session timers expiration period (default:
412                         ; "90")
413 ;timers=yes     ; Session timers for SIP packets (default: "yes")
414 ;timers_sess_expires=1800       ; Maximum session timer expiration period
415                                 ; (default: "1800")
416 ;transport=     ; Desired transport configuration (default: "")
417 ;trust_id_inbound=no    ; Accept identification information received from this
418                         ; endpoint (default: "no")
419 ;trust_id_outbound=no   ; Send private identification details to the endpoint
420                         ; (default: "no")
421 ;type=  ; Must be of type endpoint (default: "")
422 ;use_ptime=no   ; Use Endpoint s requested packetisation interval (default:
423                 ; "no")
424 ;use_avpf=no    ; Determines whether res_pjsip will use and enforce usage of
425                 ; AVPF for this endpoint (default: "no")
426 ;media_encryption=no    ; Determines whether res_pjsip will use and enforce
427                         ; usage of media encryption for this endpoint (default:
428                         ; "no")
429 ;inband_progress=no     ; Determines whether chan_pjsip will indicate ringing
430                         ; using inband progress (default: "no")
431 ;callgroup=     ; The numeric pickup groups for a channel (default: "")
432 ;pickupgroup=   ; The numeric pickup groups that a channel can pickup (default:
433                 ; "")
434 ;namedcallgroup=        ; The named pickup groups for a channel (default: "")
435 ;namedpickupgroup=      ; The named pickup groups that a channel can pickup
436                         ; (default: "")
437 ;devicestate_busy_at=0  ; The number of in use channels which will cause busy
438                         ; to be returned as device state (default: "0")
439 ;t38udptl=no    ; Whether T 38 UDPTL support is enabled or not (default: "no")
440 ;t38udptl_ec=none       ; T 38 UDPTL error correction method (default: "none")
441 ;t38udptl_maxdatagram=0 ; T 38 UDPTL maximum datagram size (default: "0")
442 ;faxdetect=no   ; Whether CNG tone detection is enabled (default: "no")
443 ;t38udptl_nat=no        ; Whether NAT support is enabled on UDPTL sessions
444                         ; (default: "no")
445 ;t38udptl_ipv6=no       ; Whether IPv6 is used for UDPTL Sessions (default:
446                         ; "no")
447 ;tonezone=      ; Set which country s indications to use for channels created
448                 ; for this endpoint (default: "")
449 ;language=      ; Set the default language to use for channels created for this
450                 ; endpoint (default: "")
451 ;one_touch_recording=no ; Determines whether one touch recording is allowed for
452                         ; this endpoint (default: "no")
453 ;recordonfeature=automixmon     ; The feature to enact when one touch recording
454                                 ; is turned on (default: "automixmon")
455 ;recordofffeature=automixmon    ; The feature to enact when one touch recording
456                                 ; is turned off (default: "automixmon")
457 ;rtpengine=asterisk     ; Name of the RTP engine to use for channels created
458                         ; for this endpoint (default: "asterisk")
459 ;allowtransfer=yes      ; Determines whether SIP REFER transfers are allowed
460                         ; for this endpoint (default: "yes")
461 ;sdpowner=-     ; String placed as the username portion of an SDP origin o line
462                 ; (default: "-")
463 ;sdpsession=Asterisk    ; String used for the SDP session s line (default:
464                         ; "Asterisk")
465 ;tos_audio=0    ; DSCP TOS bits for audio streams (default: "0")
466 ;tos_video=0    ; DSCP TOS bits for video streams (default: "0")
467 ;cos_audio=0    ; Priority for audio streams (default: "0")
468 ;cos_video=0    ; Priority for video streams (default: "0")
469 ;allowsubscribe=yes     ; Determines if endpoint is allowed to initiate
470                         ; subscriptions with Asterisk (default: "yes")
471 ;subminexpiry=0 ; The minimum allowed expiry time for subscriptions initiated
472                 ; by the endpoint (default: "0")
473 ;fromuser=      ; Username to use in From header for requests to this endpoint
474                 ; (default: "")
475 ;mwifromuser=   ; Username to use in From header for unsolicited MWI NOTIFYs to
476                 ; this endpoint (default: "")
477 ;fromdomain=    ; Domain to user in From header for requests to this endpoint
478                 ; (default: "")
479 ;dtlsverify=    ; Verify that the provided peer certificate is valid (default:
480                 ; "")
481 ;dtlsrekey=     ; Interval at which to renegotiate the TLS session and rekey
482                 ; the SRTP session (default: "")
483 ;dtlscertfile=  ; Path to certificate file to present to peer (default: "")
484 ;dtlsprivatekey=        ; Path to private key for certificate file (default:
485                         ; "")
486 ;dtlscipher=    ; Cipher to use for DTLS negotiation (default: "")
487 ;dtlscafile=    ; Path to certificate authority certificate (default: "")
488 ;dtlscapath=    ; Path to a directory containing certificate authority
489                 ; certificates (default: "")
490 ;dtlssetup=     ; Whether we are willing to accept connections connect to the
491                 ; other party or both (default: "")
492 ;srtp_tag_32=no ; Determines whether 32 byte tags should be used instead of 80
493                 ; byte tags (default: "no")
494
495
496 ;==========================AUTH SECTION OPTIONS=========================
497 ;[auth]
498 ;  SYNOPSIS: Authentication type
499 ;auth_type=userpass     ; Authentication type (default: "userpass")
500 ;nonce_lifetime=32      ; Lifetime of a nonce associated with this
501                         ; authentication config (default: "32")
502 ;md5_cred=      ; MD5 Hash used for authentication (default: "")
503 ;password=      ; PlainText password used for authentication (default: "")
504 ;realm=asterisk ; SIP realm for endpoint (default: "asterisk")
505 ;type=  ; Must be auth (default: "")
506 ;username=      ; Username to use for account (default: "")
507
508
509 ;==========================DOMAIN_ALIAS SECTION OPTIONS=========================
510 ;[domain_alias]
511 ;  SYNOPSIS: Domain Alias
512 ;type=  ; Must be of type domain_alias (default: "")
513 ;domain=        ; Domain to be aliased (default: "")
514
515
516 ;==========================TRANSPORT SECTION OPTIONS=========================
517 ;[transport]
518 ;  SYNOPSIS: SIP Transport
519 ;async_operations=1     ; Number of simultaneous Asynchronous Operations
520                         ; (default: "1")
521 ;bind=  ; IP Address and optional port to bind to for this transport (default:
522         ; "")
523 ;ca_list_file=  ; File containing a list of certificates to read TLS ONLY
524                 ; (default: "")
525 ;cert_file=     ; Certificate file for endpoint TLS ONLY (default: "")
526 ;cipher=        ; Preferred Cryptography Cipher TLS ONLY (default: "")
527 ;domain=        ; Domain the transport comes from (default: "")
528 ;external_media_address=        ; External Address to use in RTP handling
529                                 ; (default: "")
530 ;external_signaling_address=    ; External address for SIP signalling (default:
531                                 ; "")
532 ;external_signaling_port=0      ; External port for SIP signalling (default:
533                                 ; "0")
534 ;method=        ; Method of SSL transport TLS ONLY (default: "")
535 ;localnet=      ; Network to consider local used for NAT purposes (default: "")
536 ;password=      ; Password required for transport (default: "")
537 ;privkey_file=  ; Private key file TLS ONLY (default: "")
538 ;protocol=udp   ; Protocol to use for SIP traffic (default: "udp")
539 ;require_client_cert=   ; Require client certificate TLS ONLY (default: "")
540 ;type=  ; Must be of type transport (default: "")
541 ;verify_client= ; Require verification of client certificate TLS ONLY (default:
542                 ; "")
543 ;verify_server= ; Require verification of server certificate TLS ONLY (default:
544                 ; "")
545 ;tos=0  ; Enable TOS for the signalling sent over this transport (default: "0")
546 ;cos=0  ; Enable COS for the signalling sent over this transport (default: "0")
547
548
549 ;==========================CONTACT SECTION OPTIONS=========================
550 ;[contact]
551 ;  SYNOPSIS: A way of creating an aliased name to a SIP URI
552 ;type=  ; Must be of type contact (default: "")
553 ;uri=   ; SIP URI to contact peer (default: "")
554 ;expiration_time=       ; Time to keep alive a contact (default: "")
555 ;qualify_frequency=0    ; Interval at which to qualify a contact (default: "0")
556
557
558 ;==========================AOR SECTION OPTIONS=========================
559 ;[aor]
560 ;  SYNOPSIS: The configuration for a location of an endpoint
561 ;contact=       ; Permanent contacts assigned to AoR (default: "")
562 ;default_expiration=3600        ; Default expiration time in seconds for
563                                 ; contacts that are dynamically bound to an AoR
564                                 ; (default: "3600")
565 ;mailboxes=     ; Mailbox es to be associated with (default: "")
566 ;maximum_expiration=7200        ; Maximum time to keep an AoR (default: "7200")
567 ;max_contacts=0 ; Maximum number of contacts that can bind to an AoR (default:
568                 ; "0")
569 ;minimum_expiration=60  ; Minimum keep alive time for an AoR (default: "60")
570 ;remove_existing=no     ; Determines whether new contacts replace existing ones
571                         ; (default: "no")
572 ;type=  ; Must be of type aor (default: "")
573 ;qualify_frequency=0    ; Interval at which to qualify an AoR (default: "0")
574 ;authenticate_qualify=no        ; Authenticates a qualify request if needed
575                                 ; (default: "no")
576
577
578 ;==========================SYSTEM SECTION OPTIONS=========================
579 ;[system]
580 ;  SYNOPSIS: Options that apply to the SIP stack as well as other system-wide settings
581 ;timert1=500    ; Set transaction timer T1 value milliseconds (default: "500")
582 ;timerb=32000   ; Set transaction timer B value milliseconds (default: "32000")
583 ;compactheaders=no      ; Use the short forms of common SIP header names
584                         ; (default: "no")
585 ;threadpool_initial_size=0      ; Initial number of threads in the res_pjsip
586                                 ; threadpool (default: "0")
587 ;threadpool_auto_increment=5    ; The amount by which the number of threads is
588                                 ; incremented when necessary (default: "5")
589 ;threadpool_idle_timeout=60     ; Number of seconds before an idle thread
590                                 ; should be disposed of (default: "60")
591 ;threadpool_max_size=0  ; Maximum number of threads in the res_pjsip threadpool
592                         ; A value of 0 indicates no maximum (default: "0")
593 ;type=  ; Must be of type system (default: "")
594
595
596 ;==========================GLOBAL SECTION OPTIONS=========================
597 ;[global]
598 ;  SYNOPSIS: Options that apply globally to all SIP communications
599 ;maxforwards=70 ; Value used in Max Forwards header for SIP requests (default:
600                 ; "70")
601 ;type=  ; Must be of type global (default: "")
602 ;useragent=     ; Value used in User Agent header for SIP requests and Server
603                 ; header for SIP responses (default: Populated by Asterisk
604                 ; Version)
605
606
607
608
609 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip_acl
610 ;==========================ACL SECTION OPTIONS=========================
611 ;[acl]
612 ;  SYNOPSIS: Access Control List
613 ;acl=   ; Name of IP ACL (default: "")
614 ;contactacl=    ; Name of Contact ACL (default: "")
615 ;contactdeny=   ; List of Contact Header addresses to Deny (default: "")
616 ;contactpermit= ; List of Contact Header addresses to Permit (default: "")
617 ;deny=  ; List of IP domains to deny access from (default: "")
618 ;permit=        ; List of IP domains to allow access from (default: "")
619 ;type=  ; Must be of type security (default: "")
620
621
622
623
624 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip_outbound_registration
625 ;==========================REGISTRATION SECTION OPTIONS=========================
626 ;[registration]
627 ;  SYNOPSIS: The configuration for outbound registration
628 ;auth_rejection_permanent=yes   ; Determines whether failed authentication
629                                 ; challenges are treated as permanent failures
630                                 ; (default: "yes")
631 ;client_uri=    ; Client SIP URI used when attemping outbound registration
632                 ; (default: "")
633 ;contact_user=  ; Contact User to use in request (default: "")
634 ;expiration=3600        ; Expiration time for registrations in seconds
635                         ; (default: "3600")
636 ;max_retries=10 ; Maximum number of registration attempts (default: "10")
637 ;outbound_auth= ; Authentication object to be used for outbound registrations
638                 ; (default: "")
639 ;outbound_proxy=        ; Outbound Proxy used to send registrations (default:
640                         ; "")
641 ;retry_interval=60      ; Interval in seconds between retries if outbound
642                         ; registration is unsuccessful (default: "60")
643 ;server_uri=    ; SIP URI of the server to register against (default: "")
644 ;transport=     ; Transport used for outbound authentication (default: "")
645 ;type=  ; Must be of type registration (default: "")
646
647
648
649
650 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip_endpoint_identifier_ip
651 ;==========================IDENTIFY SECTION OPTIONS=========================
652 ;[identify]
653 ;  SYNOPSIS: NEEDS A SYNOPSIS
654 ;endpoint=      ; Name of Endpoint (default: "")
655 ;match= ; IP addresses or networks to match against (default: "")
656 ;type=  ; Must be of type identify (default: "")
657
658
659
660