res_pjsip: Make transport cipher option accept a comma separated list of cipher names.
[asterisk/asterisk.git] / configs / samples / 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 ;=============================================================================
79
80 ; Naming of Configuration Sections
81 ;
82 ; Configuration section names are denoted with enclosing brackets,
83 ; e.g. [6001]
84 ; In most cases, you can name a section whatever makes sense to you. For example
85 ; you might name a transport [transport-udp-nat] to help you remember how that
86 ; section is being used. However, in some cases, ("endpoint" and "aor" types)
87 ; the section name has a relationship to its function.
88 ;
89 ; Depending on the modules loaded, Asterisk can match SIP requests to an
90 ; endpoint or aor in a few ways:
91 ;
92 ; 1) Match a section name for endpoint type sections to the username in the
93 ;    "From" header of inbound SIP requests.
94 ; 2) Match a section name for aor type sections to the username in the "To"
95 ;    header of inbound SIP REGISTER requests.
96 ; 3) With an identify type section configured, match an inbound SIP request of
97 ;    any type to an endpoint or aor based on the IP source address of the
98 ;    request.
99 ;
100 ; Note that sections can have the same name as long as their "type" options are
101 ; set to different values. In most cases it makes sense to have associated
102 ; configuration sections use the same name, as you'll see in the examples within
103 ; this file.
104
105 ;===============EXAMPLE TRANSPORTS============================================
106 ;
107 ; A few examples for potential transport options.
108 ;
109 ; For the NAT transport example, be aware that the options starting with
110 ; the prefix "external_" will only apply to communication with addresses
111 ; outside the range set with "local_net=".
112 ;
113 ; IPv6: For endpoints using IPv6, remember to set "rtp_ipv6=yes" so that the RTP
114 ; engine will also be able to bind to an IPv6 address.
115 ;
116 ; You can have more than one of any type of transport, as long as it doesn't
117 ; use the same resources (bind address, port, etc) as the others.
118
119 ; Basic UDP transport
120 ;
121 ;[transport-udp]
122 ;type=transport
123 ;protocol=udp    ;udp,tcp,tls,ws,wss
124 ;bind=0.0.0.0
125
126 ; UDP transport behind NAT
127 ;
128 ;[transport-udp-nat]
129 ;type=transport
130 ;protocol=udp
131 ;bind=0.0.0.0
132 ;local_net=192.0.2.0/24
133 ;external_media_address=203.0.113.1
134 ;external_signaling_address=203.0.113.1
135
136 ; Basic IPv6 UDP transport
137 ;
138 ;[transport-udp-ipv6]
139 ;type=transport
140 ;protocol=udp
141 ;bind=::
142
143 ; Example IPv4 TLS transport
144 ;
145 ;[transport-tls]
146 ;type=transport
147 ;protocol=tls
148 ;bind=0.0.0.0
149 ;cert_file=/path/mycert.crt
150 ;priv_key_file=/path/mykey.key
151 ;cipher=ADH-AES256-SHA,ADH-AES128-SHA
152 ;method=tlsv1
153
154
155 ;===============OUTBOUND REGISTRATION WITH OUTBOUND AUTHENTICATION============
156 ;
157 ; This is a simple registration that works with some SIP trunking providers.
158 ; You'll need to set up the auth example "mytrunk_auth" below to enable outbound
159 ; authentication. Note that we "outbound_auth=" use for outbound authentication
160 ; instead of "auth=", which is for inbound authentication.
161 ;
162 ; If you are registering to a server from behind NAT, be sure you assign a transport
163 ; that is appropriately configured with NAT related settings. See the NAT transport example.
164 ;
165 ; "contact_user=" sets the SIP contact header's user portion of the SIP URI
166 ; this will affect the extension reached in dialplan when the far end calls you at this
167 ; registration. The default is 's'.
168
169 ;[mytrunk]
170 ;type=registration
171 ;transport=transport-udp
172 ;outbound_auth=mytrunk_auth
173 ;server_uri=sip:sip.example.com
174 ;client_uri=sip:1234567890@sip.example.com
175 ;contact_user=1234567890
176 ;retry_interval=60
177 ;forbidden_retry_interval=600
178 ;expiration=3600
179
180 ;[mytrunk_auth]
181 ;type=auth
182 ;auth_type=userpass
183 ;password=1234567890
184 ;username=1234567890
185 ;realm=sip.example.com
186
187 ;===============ENDPOINT CONFIGURED AS A TRUNK, OUTBOUND AUTHENTICATION=======
188 ;
189 ; This is one way to configure an endpoint as a trunk. It is set up with
190 ; "outbound_auth=" to enable authentication when dialing out through this
191 ; endpoint. There is no inbound authentication set up since a provider will
192 ; not normally authenticate when calling you.
193 ;
194 ; The identify configuration enables IP address matching against this endpoint.
195 ; For calls from a trunking provider, the From user may be different every time,
196 ; so we want to match against IP address instead of From user.
197 ;
198 ; If you want the provider of your trunk to know where to send your calls
199 ; you'll need to use an outbound registration as in the example above this
200 ; section.
201 ;
202 ; NAT
203 ;
204 ; At a basic level configure the endpoint with a transport that is set up
205 ; with the appropriate NAT settings. There may be some additional settings you
206 ; need here based on your NAT/Firewall scenario. Look to the CLI config help
207 ; "config show help res_pjsip endpoint" or on the wiki for other NAT related
208 ; options and configuration. We've included a few below.
209 ;
210 ; AOR
211 ;
212 ; Endpoints use one or more AOR sections to store their contact details.
213 ; You can define multiple contact addresses in SIP URI format in multiple
214 ; "contact=" entries.
215 ;
216
217 ;[mytrunk]
218 ;type=endpoint
219 ;transport=transport-udp
220 ;context=from-external
221 ;disallow=all
222 ;allow=ulaw
223 ;outbound_auth=mytrunk_auth
224 ;aors=mytrunk
225 ;                   ;A few NAT relevant options that may come in handy.
226 ;force_rport=yes    ;It's a good idea to read the configuration help for each
227 ;direct_media=no    ;of these options.
228 ;ice_support=yes
229
230 ;[mytrunk]
231 ;type=aor
232 ;contact=sip:198.51.100.1:5060
233 ;contact=sip:198.51.100.2:5060
234
235 ;[mytrunk]
236 ;type=identify
237 ;endpoint=mytrunk
238 ;match=198.51.100.1
239 ;match=198.51.100.2
240
241
242 ;=============ENDPOINT CONFIGURED AS A TRUNK, INBOUND AUTH AND REGISTRATION===
243 ;
244 ; Here we are allowing a remote device to register to Asterisk and requiring
245 ; that they authenticate for registration and calls.
246 ; You'll note that this configuration is essentially the same as configuring
247 ; an endpoint for use with a SIP phone.
248
249
250 ;[7000]
251 ;type=endpoint
252 ;context=from-external
253 ;disallow=all
254 ;allow=ulaw
255 ;transport=transport-udp
256 ;auth=7000
257 ;aors=7000
258
259 ;[7000]
260 ;type=auth
261 ;auth_type=userpass
262 ;password=7000
263 ;username=7000
264
265 ;[7000]
266 ;type=aor
267 ;max_contacts=1
268
269
270 ;===============ENDPOINT CONFIGURED FOR USE WITH A SIP PHONE==================
271 ;
272 ; This example includes the endpoint, auth and aor configurations. It
273 ; requires inbound authentication and allows registration, as well as references
274 ; a transport that you'll need to uncomment from the previous examples.
275 ;
276 ; Uncomment one of the transport lines to choose which transport you want. If
277 ; not specified then the default transport chosen is the first defined transport
278 ; in the configuration file.
279 ;
280 ; Modify the "max_contacts=" line to change how many unique registrations to allow.
281 ;
282 ; Use the "contact=" line instead of max_contacts= if you want to statically
283 ; define the location of the device.
284 ;
285 ; If using the TLS enabled transport, you may want the "media_encryption=sdes"
286 ; option to additionally enable SRTP, though they are not mutually inclusive.
287 ;
288 ; Use the "rtp_ipv6=yes" option if you want to utilize RTP over an ipv6 transport.
289 ;
290 ; If this endpoint were remote, and it was using a transport configured for NAT
291 ; then you likely want to use "direct_media=no" to prevent audio issues.
292
293
294 ;[6001]
295 ;type=endpoint
296 ;transport=transport-udp
297 ;context=from-internal
298 ;disallow=all
299 ;allow=ulaw
300 ;allow=gsm
301 ;auth=6001
302 ;aors=6001
303 ;
304 ; A few more transports to pick from, and some related options below them.
305 ;
306 ;transport=transport-tls
307 ;media_encryption=sdes
308 ;transport=transport-udp-ipv6
309 ;rtp_ipv6=yes
310 ;transport=transport-udp-nat
311 ;direct_media=no
312 ;
313 ; MWI related options
314
315 ;aggregate_mwi=yes
316 ;mailboxes=6001@default,7001@default
317 ;mwi_from_user=6001
318 ;
319 ; Extension and Device state options
320 ;
321 ;device_state_busy_at=1
322 ;allow_subscribe=yes
323 ;sub_min_expiry=30
324
325 ;[6001]
326 ;type=auth
327 ;auth_type=userpass
328 ;password=6001
329 ;username=6001
330
331 ;[6001]
332 ;type=aor
333 ;max_contacts=1
334 ;contact=sip:6001@192.0.2.1:5060
335
336 ;===============ENDPOINT BEHIND NAT OR FIREWALL===============================
337 ;
338 ; This example assumes your transport is configured with a public IP and the
339 ; endpoint itself is behind NAT and maybe a firewall, rather than having
340 ; Asterisk behind NAT. For the sake of simplicity, we'll assume a typical
341 ; VOIP phone. The most important settings to configure are:
342 ;
343 ;  * direct_media, to ensure Asterisk stays in the media path
344 ;  * rtp_symmetric and force_rport options to help the far-end NAT/firewall
345 ;
346 ; Depending on the settings of your remote SIP device or NAT/firewall device
347 ; you may have to experiment with a combination of these settings.
348 ;
349 ; If both Asterisk and the remote phones are a behind NAT/firewall then you'll
350 ; have to make sure to use a transport with appropriate settings (as in the
351 ; transport-udp-nat example).
352 ;
353 ;[6002]
354 ;type=endpoint
355 ;transport=transport-udp
356 ;context=from-internal
357 ;disallow=all
358 ;allow=ulaw
359 ;auth=6002
360 ;aors=6002
361 ;direct_media=no
362 ;rtp_symmetric=yes
363 ;force_rport=yes
364 ;rewrite_contact=yes  ; necessary if endpoint does not know/register public ip:port
365 ;ice_support=yes   ;This is specific to clients that support NAT traversal
366                    ;for media via ICE,STUN,TURN. See the wiki at:
367                    ;https://wiki.asterisk.org/wiki/x/D4FHAQ
368                    ;for a deeper explanation of this topic.
369
370 ;[6002]
371 ;type=auth
372 ;auth_type=userpass
373 ;password=6002
374 ;username=6002
375
376 ;[6002]
377 ;type=aor
378 ;max_contacts=2
379
380
381 ;============EXAMPLE ACL CONFIGURATION==========================================
382 ;
383 ; The ACL or Access Control List section defines a set of permissions to permit
384 ; or deny access to various address or addresses. Alternatively it references an
385 ; ACL configuration already set in acl.conf.
386 ;
387 ; The ACL configuration is independent of individual endpoint configuration and
388 ; operates on all inbound SIP communication using res_pjsip.
389
390 ; Reference an ACL defined in acl.conf.
391 ;
392 ;[acl]
393 ;type=acl
394 ;acl=example_named_acl1
395
396 ; Reference a contactacl specifically.
397 ;
398 ;[acl]
399 ;type=acl
400 ;contact_acl=example_contact_acl1
401
402 ; Define your own ACL here in pjsip.conf and
403 ; permit or deny by IP address or range.
404 ;
405 ;[acl]
406 ;type=acl
407 ;deny=0.0.0.0/0.0.0.0
408 ;permit=209.16.236.0/24
409 ;deny=209.16.236.1
410
411 ; Restrict based on Contact Headers rather than IP.
412 ; Define options multiple times for various addresses or use a comma-delimited string.
413 ;
414 ;[acl]
415 ;type=acl
416 ;contact_deny=0.0.0.0/0.0.0.0
417 ;contact_permit=209.16.236.0/24
418 ;contact_permit=209.16.236.1
419 ;contact_permit=209.16.236.2,209.16.236.3
420
421 ; Restrict based on Contact Headers rather than IP and use
422 ; advanced syntax. Note the bang symbol used for "NOT", so we can deny
423 ; 209.16.236.12/32 within the permit= statement.
424 ;
425 ;[acl]
426 ;type=acl
427 ;contact_deny=0.0.0.0/0.0.0.0
428 ;contact_permit=209.16.236.0
429 ;permit=209.16.236.0/24, !209.16.236.12/32
430
431
432 ;============EXAMPLE RLS CONFIGURATION==========================================
433 ;
434 ;Asterisk provides support for RFC 4662 Resource List Subscriptions. This allows
435 ;for an endpoint to, through a single subscription, subscribe to the states of
436 ;multiple resources. Resource lists are configured in pjsip.conf using the
437 ;resource_list configuration object. Below is an example of a resource list that
438 ;allows an endpoint to subscribe to the presence of alice, bob, and carol.
439
440 ;[my_list]
441 ;type=resource_list
442 ;list_item=alice
443 ;list_item=bob
444 ;list_item=carol
445 ;event=presence
446
447 ;The "event" option in the resource list corresponds to the SIP event-package
448 ;that the subscribed resources belong to. A resource list can only provide states
449 ;for resources that belong to the same event-package. This means that you cannot
450 ;create a list that is a combination of presence and message-summary resources,
451 ;for instance. Any event-package that Asterisk supports can be used in a resource
452 ;list (presence, dialog, and message-summary). Whenever support for a new event-
453 ;package is added to Asterisk, support for that event-package in resource lists
454 ;will automatically be supported.
455
456 ;The "list_item" options indicate the names of resources to subscribe to. The
457 ;way these are interpreted is event-package specific. For instance, with presence
458 ;list_items, hints in the dialplan are looked up. With message-summary list_items,
459 ;mailboxes are looked up using your installed voicemail provider (app_voicemail
460 ;by default). Note that in the above example, the list_item options were given
461 ;one per line. However, it is also permissible to provide multiple list_item
462 ;options on a single line (e.g. list_item = alice,bob,carol).
463
464 ;In addition to the options presented in the above configuration, there are two
465 ;more configuration options that can be set.
466 ; * full_state: dictates whether Asterisk should always send the states of
467 ;   all resources in the list at once. Defaults to "no". You should only set
468 ;   this to "yes" if you are interoperating with an endpoint that does not
469 ;   behave correctly when partial state notifications are sent to it.
470 ; * notification_batch_interval: By default, Asterisk will send a NOTIFY request
471 ;   immediately when a resource changes state. This option causes Asterisk to
472 ;   start batching resource state changes for the specified number of milliseconds
473 ;   after a resource changes states. This way, if multiple resources change state
474 ;   within a brief interval, Asterisk can send a single NOTIFY request with all
475 ;   of the state changes reflected in it.
476
477 ;There is a limitation to the size of resource lists in Asterisk. If a constructed
478 ;notification from Asterisk will exceed 64000 bytes, then the message is deemed
479 ;too large to send. If you find that you are seeing error messages about SIP
480 ;NOTIFY requests being too large to send, consider breaking your lists into
481 ;sub-lists.
482
483 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip
484 ;==========================ENDPOINT SECTION OPTIONS=========================
485 ;[endpoint]
486 ;  SYNOPSIS: Endpoint
487 ;100rel=yes     ; Allow support for RFC3262 provisional ACK tags (default:
488                 ; "yes")
489 ;aggregate_mwi=yes      ;  (default: "yes")
490 ;allow= ; Media Codec s to allow (default: "")
491 ;aors=  ; AoR s to be used with the endpoint (default: "")
492 ;auth=  ; Authentication Object s associated with the endpoint (default: "")
493 ;callerid=      ; CallerID information for the endpoint (default: "")
494 ;callerid_privacy=allowed      ; Default privacy level (default: "allowed")
495 ;callerid_tag=  ; Internal id_tag for the endpoint (default: "")
496 ;context=default        ; Dialplan context for inbound sessions (default:
497                         ; "default")
498 ;direct_media_glare_mitigation=none     ; Mitigation of direct media re INVITE
499                                         ; glare (default: "none")
500 ;direct_media_method=invite     ; Direct Media method type (default: "invite")
501 ;connected_line_method=invite   ; Connected line method type (default:
502                                 ; "invite")
503 ;direct_media=yes       ; Determines whether media may flow directly between
504                         ; endpoints (default: "yes")
505 ;disable_direct_media_on_nat=no ; Disable direct media session refreshes when
506                                 ; NAT obstructs the media session (default:
507                                 ; "no")
508 ;disallow=      ; Media Codec s to disallow (default: "")
509 ;dtmf_mode=rfc4733      ; DTMF mode (default: "rfc4733")
510 ;media_address=         ; IP address used in SDP for media handling (default: "")
511 ;force_rport=yes        ; Force use of return port (default: "yes")
512 ;ice_support=no ; Enable the ICE mechanism to help traverse NAT (default: "no")
513 ;identify_by=username   ; Way s for Endpoint to be identified (default:
514                         ; "username")
515 ;redirect_method=user   ; How redirects received from an endpoint are handled
516                         ; (default: "user")
517 ;mailboxes=     ; Mailbox es to be associated with (default: "")
518 ;moh_suggest=default    ; Default Music On Hold class (default: "default")
519 ;outbound_auth= ; Authentication object used for outbound requests (default:
520                 ; "")
521 ;outbound_proxy=        ; Proxy through which to send requests a full SIP URI
522                         ; must be provided (default: "")
523 ;rewrite_contact=no     ; Allow Contact header to be rewritten with the source
524                         ; IP address port (default: "no")
525 ;rtp_ipv6=no    ; Allow use of IPv6 for RTP traffic (default: "no")
526 ;rtp_symmetric=no       ; Enforce that RTP must be symmetric (default: "no")
527 ;send_diversion=yes     ; Send the Diversion header conveying the diversion
528                         ; information to the called user agent (default: "yes")
529 ;send_pai=no    ; Send the P Asserted Identity header (default: "no")
530 ;send_rpid=no   ; Send the Remote Party ID header (default: "no")
531 ;timers_min_se=90       ; Minimum session timers expiration period (default:
532                         ; "90")
533 ;timers=yes     ; Session timers for SIP packets (default: "yes")
534 ;timers_sess_expires=1800       ; Maximum session timer expiration period
535                                 ; (default: "1800")
536 ;transport=     ; Desired transport configuration (default: "")
537 ;trust_id_inbound=no    ; Accept identification information received from this
538                         ; endpoint (default: "no")
539 ;trust_id_outbound=no   ; Send private identification details to the endpoint
540                         ; (default: "no")
541 ;type=  ; Must be of type endpoint (default: "")
542 ;use_ptime=no   ; Use Endpoint s requested packetisation interval (default:
543                 ; "no")
544 ;use_avpf=no    ; Determines whether res_pjsip will use and enforce usage of
545                 ; AVPF for this endpoint (default: "no")
546 ;media_encryption=no    ; Determines whether res_pjsip will use and enforce
547                         ; usage of media encryption for this endpoint (default:
548                         ; "no")
549 ;inband_progress=no     ; Determines whether chan_pjsip will indicate ringing
550                         ; using inband progress (default: "no")
551 ;call_group=    ; The numeric pickup groups for a channel (default: "")
552 ;pickup_group=  ; The numeric pickup groups that a channel can pickup (default:
553                 ; "")
554 ;named_call_group=      ; The named pickup groups for a channel (default: "")
555 ;named_pickup_group=    ; The named pickup groups that a channel can pickup
556                         ; (default: "")
557 ;device_state_busy_at=0 ; The number of in use channels which will cause busy
558                         ; to be returned as device state (default: "0")
559 ;t38_udptl=no   ; Whether T 38 UDPTL support is enabled or not (default: "no")
560 ;t38_udptl_ec=none      ; T 38 UDPTL error correction method (default: "none")
561 ;t38_udptl_maxdatagram=0        ; T 38 UDPTL maximum datagram size (default:
562                                 ; "0")
563 ;fax_detect=no  ; Whether CNG tone detection is enabled (default: "no")
564 ;t38_udptl_nat=no       ; Whether NAT support is enabled on UDPTL sessions
565                         ; (default: "no")
566 ;t38_udptl_ipv6=no      ; Whether IPv6 is used for UDPTL Sessions (default:
567                         ; "no")
568 ;tone_zone=     ; Set which country s indications to use for channels created
569                 ; for this endpoint (default: "")
570 ;language=      ; Set the default language to use for channels created for this
571                 ; endpoint (default: "")
572 ;one_touch_recording=no ; Determines whether one touch recording is allowed for
573                         ; this endpoint (default: "no")
574 ;record_on_feature=automixmon   ; The feature to enact when one touch recording
575                                 ; is turned on (default: "automixmon")
576 ;record_off_feature=automixmon  ; The feature to enact when one touch recording
577                                 ; is turned off (default: "automixmon")
578 ;rtp_engine=asterisk    ; Name of the RTP engine to use for channels created
579                         ; for this endpoint (default: "asterisk")
580 ;allow_transfer=yes     ; Determines whether SIP REFER transfers are allowed
581                         ; for this endpoint (default: "yes")
582 ;sdp_owner=-    ; String placed as the username portion of an SDP origin o line
583                 ; (default: "-")
584 ;sdp_session=Asterisk   ; String used for the SDP session s line (default:
585                         ; "Asterisk")
586 ;tos_audio=0    ; DSCP TOS bits for audio streams (default: "0")
587 ;tos_video=0    ; DSCP TOS bits for video streams (default: "0")
588 ;cos_audio=0    ; Priority for audio streams (default: "0")
589 ;cos_video=0    ; Priority for video streams (default: "0")
590 ;allow_subscribe=yes    ; Determines if endpoint is allowed to initiate
591                         ; subscriptions with Asterisk (default: "yes")
592 ;sub_min_expiry=0       ; The minimum allowed expiry time for subscriptions
593                         ; initiated by the endpoint (default: "0")
594 ;from_user=     ; Username to use in From header for requests to this endpoint
595                 ; (default: "")
596 ;mwi_from_user= ; Username to use in From header for unsolicited MWI NOTIFYs to
597                 ; this endpoint (default: "")
598 ;from_domain=   ; Domain to user in From header for requests to this endpoint
599                 ; (default: "")
600 ;dtls_verify=no ; Verify that the provided peer certificate is valid (default:
601                 ; "no")
602 ;dtls_rekey=0   ; Interval at which to renegotiate the TLS session and rekey
603                 ; the SRTP session (default: "0")
604 ;dtls_cert_file=        ; Path to certificate file to present to peer (default:
605                         ; "")
606 ;dtls_private_key=      ; Path to private key for certificate file (default:
607                         ; "")
608 ;dtls_cipher=   ; Cipher to use for DTLS negotiation (default: "")
609 ;dtls_ca_file=  ; Path to certificate authority certificate (default: "")
610 ;dtls_ca_path=  ; Path to a directory containing certificate authority
611                 ; certificates (default: "")
612 ;dtls_setup=    ; Whether we are willing to accept connections connect to the
613                 ; other party or both (default: "")
614 ;dtls_fingerprint= ; Hash to use for the fingerprint placed into SDP
615                    ; (default: "SHA-256")
616 ;srtp_tag_32=no ; Determines whether 32 byte tags should be used instead of 80
617                 ; byte tags (default: "no")
618 ;set_var=       ; Variable set on a channel involving the endpoint. For multiple
619                 ; channel variables specify multiple 'set_var'(s)
620
621 ;==========================AUTH SECTION OPTIONS=========================
622 ;[auth]
623 ;  SYNOPSIS: Authentication type
624 ;auth_type=userpass     ; Authentication type (default: "userpass")
625 ;nonce_lifetime=32      ; Lifetime of a nonce associated with this
626                         ; authentication config (default: "32")
627 ;md5_cred=      ; MD5 Hash used for authentication (default: "")
628 ;password=      ; PlainText password used for authentication (default: "")
629 ;realm= ; SIP realm for endpoint (default: "")
630 ;type=  ; Must be auth (default: "")
631 ;username=      ; Username to use for account (default: "")
632
633
634 ;==========================DOMAIN_ALIAS SECTION OPTIONS=========================
635 ;[domain_alias]
636 ;  SYNOPSIS: Domain Alias
637 ;type=  ; Must be of type domain_alias (default: "")
638 ;domain=        ; Domain to be aliased (default: "")
639
640
641 ;==========================TRANSPORT SECTION OPTIONS=========================
642 ;[transport]
643 ;  SYNOPSIS: SIP Transport
644 ;async_operations=1     ; Number of simultaneous Asynchronous Operations
645                         ; (default: "1")
646 ;bind=  ; IP Address and optional port to bind to for this transport (default:
647         ; "")
648 ;ca_list_file=  ; File containing a list of certificates to read TLS ONLY
649                 ; (default: "")
650 ;cert_file=     ; Certificate file for endpoint TLS ONLY (default: "")
651 ;cipher=        ; Preferred cryptography cipher names TLS ONLY (default: "")
652 ;domain=        ; Domain the transport comes from (default: "")
653 ;external_media_address=        ; External IP address to use in RTP handling
654                                 ; (default: "")
655 ;external_signaling_address=    ; External address for SIP signalling (default:
656                                 ; "")
657 ;external_signaling_port=0      ; External port for SIP signalling (default:
658                                 ; "0")
659 ;method=        ; Method of SSL transport TLS ONLY (default: "")
660 ;local_net=     ; Network to consider local used for NAT purposes (default: "")
661 ;password=      ; Password required for transport (default: "")
662 ;priv_key_file= ; Private key file TLS ONLY (default: "")
663 ;protocol=udp   ; Protocol to use for SIP traffic (default: "udp")
664 ;require_client_cert=   ; Require client certificate TLS ONLY (default: "")
665 ;type=  ; Must be of type transport (default: "")
666 ;verify_client= ; Require verification of client certificate TLS ONLY (default:
667                 ; "")
668 ;verify_server= ; Require verification of server certificate TLS ONLY (default:
669                 ; "")
670 ;tos=0  ; Enable TOS for the signalling sent over this transport (default: "0")
671 ;cos=0  ; Enable COS for the signalling sent over this transport (default: "0")
672 ;websocket_write_timeout=100    ; Default write timeout to set on websocket
673                                 ; transports. This value may need to be adjusted
674                                 ; for connections where Asterisk must write a
675                                 ; substantial amount of data and the receiving
676                                 ; clients are slow to process the received
677                                 ; information. Value is in milliseconds; default
678                                 ; is 100 ms.
679
680 ;==========================CONTACT SECTION OPTIONS=========================
681 ;[contact]
682 ;  SYNOPSIS: A way of creating an aliased name to a SIP URI
683 ;type=  ; Must be of type contact (default: "")
684 ;uri=   ; SIP URI to contact peer (default: "")
685 ;expiration_time=       ; Time to keep alive a contact (default: "")
686 ;qualify_frequency=0    ; Interval at which to qualify a contact (default: "0")
687 ;outbound_proxy=        ; Outbound proxy used when sending OPTIONS request
688                         ; (default: "")
689
690
691 ;==========================AOR SECTION OPTIONS=========================
692 ;[aor]
693 ;  SYNOPSIS: The configuration for a location of an endpoint
694 ;contact=       ; Permanent contacts assigned to AoR (default: "")
695 ;default_expiration=3600        ; Default expiration time in seconds for
696                                 ; contacts that are dynamically bound to an AoR
697                                 ; (default: "3600")
698 ;mailboxes=     ; Mailbox es to be associated with (default: "")
699 ;maximum_expiration=7200        ; Maximum time to keep an AoR (default: "7200")
700 ;max_contacts=0 ; Maximum number of contacts that can bind to an AoR (default:
701                 ; "0")
702 ;minimum_expiration=60  ; Minimum keep alive time for an AoR (default: "60")
703 ;remove_existing=no     ; Determines whether new contacts replace existing ones
704                         ; (default: "no")
705 ;type=  ; Must be of type aor (default: "")
706 ;qualify_frequency=0    ; Interval at which to qualify an AoR (default: "0")
707 ;authenticate_qualify=no        ; Authenticates a qualify request if needed
708                                 ; (default: "no")
709 ;outbound_proxy=        ; Outbound proxy used when sending OPTIONS request
710                         ; (default: "")
711
712
713 ;==========================SYSTEM SECTION OPTIONS=========================
714 ;[system]
715 ;  SYNOPSIS: Options that apply to the SIP stack as well as other system-wide settings
716 ;timer_t1=500   ; Set transaction timer T1 value milliseconds (default: "500")
717 ;timer_b=32000  ; Set transaction timer B value milliseconds (default: "32000")
718 ;compact_headers=no     ; Use the short forms of common SIP header names
719                         ; (default: "no")
720 ;threadpool_initial_size=0      ; Initial number of threads in the res_pjsip
721                                 ; threadpool (default: "0")
722 ;threadpool_auto_increment=5    ; The amount by which the number of threads is
723                                 ; incremented when necessary (default: "5")
724 ;threadpool_idle_timeout=60     ; Number of seconds before an idle thread
725                                 ; should be disposed of (default: "60")
726 ;threadpool_max_size=0  ; Maximum number of threads in the res_pjsip threadpool
727                         ; A value of 0 indicates no maximum (default: "0")
728 ;type=  ; Must be of type system (default: "")
729
730 ;==========================GLOBAL SECTION OPTIONS=========================
731 ;[global]
732 ;  SYNOPSIS: Options that apply globally to all SIP communications
733 ;max_forwards=70        ; Value used in Max Forwards header for SIP requests
734                         ; (default: "70")
735 ;type=  ; Must be of type global (default: "")
736 ;user_agent=Asterisk PBX SVN-branch-12-r404375  ; Value used in User Agent
737                                                 ; header for SIP requests and
738                                                 ; Server header for SIP
739                                                 ; responses (default: "Asterisk
740                                                 ; PBX SVN-branch-12-r404375")
741 ;default_outbound_endpoint=default_outbound_endpoint    ; Endpoint to use when
742                                                         ; sending an outbound
743                                                         ; request to a URI
744                                                         ; without a specified
745                                                         ; endpoint (default: "d
746                                                         ; efault_outbound_endpo
747                                                         ; int")
748 ;debug=no ; Enable/Disable SIP debug logging.  Valid options include yes|no
749           ; or a host address (default: "no")
750
751
752 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip_acl
753 ;==========================ACL SECTION OPTIONS=========================
754 ;[acl]
755 ;  SYNOPSIS: Access Control List
756 ;acl=   ; List of IP ACL section names in acl conf (default: "")
757 ;contact_acl=   ; List of Contact ACL section names in acl conf (default: "")
758 ;contact_deny=  ; List of Contact header addresses to deny (default: "")
759 ;contact_permit=        ; List of Contact header addresses to permit (default:
760                         ; "")
761 ;deny=  ; List of IP addresses to deny access from (default: "")
762 ;permit=        ; List of IP addresses to permit access from (default: "")
763 ;type=  ; Must be of type acl (default: "")
764
765
766
767
768 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip_outbound_registration
769 ;==========================REGISTRATION SECTION OPTIONS=========================
770 ;[registration]
771 ;  SYNOPSIS: The configuration for outbound registration
772 ;auth_rejection_permanent=yes   ; Determines whether failed authentication
773                                 ; challenges are treated as permanent failures
774                                 ; (default: "yes")
775 ;client_uri=    ; Client SIP URI used when attemping outbound registration
776                 ; (default: "")
777 ;contact_user=  ; Contact User to use in request (default: "")
778 ;expiration=3600        ; Expiration time for registrations in seconds
779                         ; (default: "3600")
780 ;max_retries=10 ; Maximum number of registration attempts (default: "10")
781 ;outbound_auth= ; Authentication object to be used for outbound registrations
782                 ; (default: "")
783 ;outbound_proxy=        ; Outbound Proxy used to send registrations (default:
784                         ; "")
785 ;retry_interval=60      ; Interval in seconds between retries if outbound
786                         ; registration is unsuccessful (default: "60")
787 ;forbidden_retry_interval=0     ; Interval used when receiving a 403 Forbidden
788                                 ; response (default: "0")
789 ;server_uri=    ; SIP URI of the server to register against (default: "")
790 ;transport=     ; Transport used for outbound authentication (default: "")
791 ;type=  ; Must be of type registration (default: "")
792
793
794
795
796 ; MODULE PROVIDING BELOW SECTION(S): res_pjsip_endpoint_identifier_ip
797 ;==========================IDENTIFY SECTION OPTIONS=========================
798 ;[identify]
799 ;  SYNOPSIS: Identifies endpoints via source IP address
800 ;endpoint=      ; Name of Endpoint (default: "")
801 ;match= ; IP addresses or networks to match against (default: "")
802 ;type=  ; Must be of type identify (default: "")