Mise à jour après premières vagues de gros tests
[asterisk-config-auf.git] / etc-asterisk / iax.conf
1
2 ; Inter-Asterisk eXchange driver definition
3 ;
4 ; This configuration is re-read at reload
5 ; or with the CLI command
6 ;       reload chan_iax2.so
7 ;
8 ; General settings, like port number to bind to, and
9 ; an option address (the default is to bind to all
10 ; local addresses).
11 ;
12 [general]
13 ;bindport=4569                  ; bindport and bindaddr may be specified
14 ;                               ; NOTE: bindport must be specified BEFORE
15                                 ; bindaddr or may be specified on a specific
16                                 ; bindaddr if followed by colon and port
17                                 ;  (e.g. bindaddr=192.168.0.1:4569)
18 ;bindaddr=192.168.0.1           ; more than once to bind to multiple
19 ;                               ; addresses, but the first will be the
20 ;                               ; default
21 ;
22 ; Set iaxcompat to yes if you plan to use layered switches or
23 ; some other scenario which may cause some delay when doing a
24 ; lookup in the dialplan. It incurs a small performance hit to
25 ; enable it. This option causes Asterisk to spawn a separate thread
26 ; when it receives an IAX DPREQ (Dialplan Request) instead of
27 ; blocking while it waits for a response.
28 ;
29 ;iaxcompat=yes
30 ;
31 ; Disable UDP checksums (if nochecksums is set, then no checkums will
32 ; be calculated/checked on systems supporting this feature)
33 ;
34 ;nochecksums=no
35 ;
36 ;
37 ; For increased security against brute force password attacks
38 ; enable "delayreject" which will delay the sending of authentication
39 ; reject for REGREQ or AUTHREP if there is a password.
40 ;
41 ;delayreject=yes
42 ;
43 ; You may specify a global default AMA flag for iaxtel calls.  It must be
44 ; one of 'default', 'omit', 'billing', or 'documentation'.  These flags
45 ; are used in the generation of call detail records.
46 ;
47 ;amaflags=default
48 ;
49 ; ADSI (Analog Display Services Interface) can be enabled if you have
50 ; (or may have) ADSI compatible CPE equipment
51 ;
52 ;adsi=no
53 ;
54 ; Perform an SRV lookup on outbound calls
55 ;
56 ;srvlookup=yes
57 ;
58 ; You may specify a default account for Call Detail Records in addition
59 ; to specifying on a per-user basis
60 ;
61 ;accountcode=lss0101
62 ;
63 ; You may specify a global default language for users.
64 ; Can be specified also on a per-user basis
65 ; If omitted, will fallback to english
66 ;
67 language=fr
68 ;
69 ; This option specifies a preference for which music on hold class this channel
70 ; should listen to when put on hold if the music class has not been set on the
71 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
72 ; channel putting this one on hold did not suggest a music class.
73 ;
74 ; If this option is set to "passthrough", then the hold message will always be
75 ; passed through as signalling instead of generating hold music locally.
76 ;
77 ; This option may be specified globally, or on a per-user or per-peer basis.
78 ;
79 ;mohinterpret=default
80 ;
81 ; This option specifies which music on hold class to suggest to the peer channel
82 ; when this channel places the peer on hold. It may be specified globally or on
83 ; a per-user or per-peer basis.
84 ;
85 ;mohsuggest=default
86 ;
87 ; Specify bandwidth of low, medium, or high to control which codecs are used
88 ; in general.
89 ;
90 ;bandwidth=low
91 ;
92 ; You can also fine tune codecs here using "allow" and "disallow" clauses
93 ; with specific codecs.  Use "all" to represent all formats.
94 ;
95 ;allow=all                      ; same as bandwidth=high
96 ;disallow=g723.1                ; Hm...  Proprietary, don't use it...
97 ;disallow=lpc10                 ; Icky sound quality...  Mr. Roboto.
98 ;allow=gsm                      ; Always allow GSM, it's cool :)
99 ;
100
101 disallow=all
102
103 ; codec audio
104 allow=gsm     ; pour interconnexions
105 allow=ulaw    ; pour postes locaux (ou bonnes connexions)
106
107 ; codecs video
108 allow=h261
109 allow=h263
110 allow=h263p
111 allow=h264
112
113 ; You can adjust several parameters relating to the jitter buffer.
114 ; The jitter buffer's function is to compensate for varying
115 ; network delay.
116 ;
117 ; All the jitter buffer settings are in milliseconds.
118 ; The jitter buffer works for INCOMING audio - the outbound audio
119 ; will be dejittered by the jitter buffer at the other end.
120 ;
121 ; jitterbuffer=yes|no: global default as to whether you want
122 ; the jitter buffer at all.
123 ;
124 ; forcejitterbuffer=yes|no: in the ideal world, when we bridge VoIP channels
125 ; we don't want to do jitterbuffering on the switch, since the endpoints
126 ; can each handle this.  However, some endpoints may have poor jitterbuffers
127 ; themselves, so this option will force * to always jitterbuffer, even in this
128 ; case.
129 ;
130 ; maxjitterbuffer: a maximum size for the jitter buffer.
131 ; Setting a reasonable maximum here will prevent the call delay
132 ; from rising to silly values in extreme situations; you'll hear
133 ; SOMETHING, even though it will be jittery.
134 ;
135 ; resyncthreshold: when the jitterbuffer notices a significant change in delay
136 ; that continues over a few frames, it will resync, assuming that the change in
137 ; delay was caused by a timestamping mix-up. The threshold for noticing a
138 ; change in delay is measured as twice the measured jitter plus this resync
139 ; threshold.
140 ; Resyncing can be disabled by setting this parameter to -1.
141 ;
142 ; maxjitterinterps: the maximum number of interpolation frames the jitterbuffer
143 ; should return in a row. Since some clients do not send CNG/DTX frames to
144 ; indicate silence, the jitterbuffer will assume silence has begun after
145 ; returning this many interpolations. This prevents interpolating throughout
146 ; a long silence.
147 ;
148 ;
149 ; jittertargetextra: number of milliseconds by which the new jitter buffer
150 ; will pad its size. the default is 40, so without modification, the new
151 ; jitter buffer will set its size to the jitter value plus 40 milliseconds.
152 ; increasing this value may help if your network normally has low jitter,
153 ; but occasionally has spikes.
154 ;
155
156 jitterbuffer=yes                    ; config recommandée suite à l'audit voip de Montréal (avril 2010)
157 ;forcejitterbuffer=no
158 ;maxjitterbuffer=1000
159 ;maxjitterinterps=10
160 ;resyncthreshold=1000
161 ;jittertargetextra=40
162
163 ; Minimum and maximum amounts of time that IAX peers can request as
164 ; a registration expiration interval (in seconds).
165 minregexpire = 60
166 maxregexpire = 120
167 ;
168 ; Enable IAX2 encryption.  The default is no.
169 ;
170 ; encryption = yes
171 ;
172 ; Force encryption insures no connection is established unless both sides support
173 ; encryption.  By turning this option on, encryption is automatically turned on as well.
174 ;
175 ; forceencryption = yes
176
177 ; This option defines the maximum payload in bytes an IAX2 trunk can support at a given time.
178 ; The best way to explain this is to provide an example.  If the maximum number of calls
179 ; to be supported is 800, and each call transmits 20ms frames of audio using ulaw
180 ; ((8000hz / 1000ms) * 20ms * 1 byte per sample = 160 bytes per frame), the maximum load
181 ; in bytes is (160 bytes per frame) * (800 calls) = 128000 bytes total. Once this limit is
182 ; reached, calls may be dropped or begin to lose audio.  Depending on the codec in use and
183 ; number of channels to be supported this value may need to be raised, but in most cases the
184 ; default value is large enough.
185 ;
186 ; trunkmaxsize = 128000 ; defaults to 128000 bytes, which supports up to 800 calls of ulaw
187 ;                       ; at 20ms a frame.
188
189 ; With a large amount of traffic on IAX2 trunks, there is a risk of bad voice quality when
190 ; allowing the Linux system to handle fragmentation of UDP packets. Depending on the size of
191 ; each payload, allowing the O/S to handle fragmentation may not be very efficient. This
192 ; setting sets the maximum transmission unit for IAX2 UDP trunking. The default is 1240 bytes
193 ; which means if a trunk's payload is over 1240 bytes for every 20ms it will be broken into
194 ; multiple 1240 byte messages.  Zero disables this functionality and let's the O/S handle
195 ; fragmentation.
196 ;
197 ; trunkmtu = 1240 ; trunk data will be sent in 1240 byte messages.
198
199 ; trunkfreq sets how frequently trunk messages are sent in milliseconds. This value is 20ms by
200 ; default, which means the trunk will send all the date queued to it in the past 20ms.  By
201 ; increasing the time between sending trunk messages, the trunk's payload size will increase as
202 ; well.  Note, depending on the size set by trunkmtu, messages may be sent more often than
203 ; specified.  For example if a trunk's message size grows to the trunkmtu size before 20ms is
204 ; reached that message will be sent immediately.  Acceptable values are between 10ms and
205 ; 1000ms.
206 ;
207 ; trunkfreq=20     ; How frequently to send trunk msgs (in ms). This is 20ms by default.
208
209 ; Should we send timestamps for the individual sub-frames within trunk frames?
210 ; There is a small bandwidth use for these (less than 1kbps/call), but they
211 ; ensure that frame timestamps get sent end-to-end properly.  If both ends of
212 ; all your trunks go directly to TDM, _and_ your trunkfreq equals the frame
213 ; length for your codecs, you can probably suppress these.  The receiver must
214 ; also support this feature, although they do not also need to have it enabled.
215 ;
216 ; trunktimestamps=yes
217 ;
218
219 ; IAX helper threads
220
221 ; Establishes the number of iax helper threads to handle I/O.
222 ; iaxthreadcount = 10
223 ; Establishes the number of extra dynamic threads that may be spawned to handle I/O
224 ; iaxmaxthreadcount = 100
225 ;
226 ; We can register with another IAX server to let him know where we are
227 ; in case we have a dynamic IP address for example
228 ;
229 ; Register with tormenta using username marko and password secretpass
230 ;
231 ;register => marko:secretpass@tormenta.linux-support.net
232 ;
233 ; Register joe at remote host with no password
234 ;
235 ;register => joe@remotehost:5656
236 ;
237 ; Register marko at tormenta.linux-support.net using RSA key "torkey"
238 ;
239 ;register => marko:[torkey]@tormenta.linux-support.net
240 ;
241 ; Sample Registration for iaxtel
242 ;
243 ; Visit http://www.iaxtel.com to register with iaxtel.  Replace "user"
244 ; and "pass" with your username and password for iaxtel.  Incoming
245 ; calls arrive at the "s" extension of "default" context.
246 ;
247 ;register => user:pass@iaxtel.com
248 ;
249 ; Sample Registration for IAX + FWD
250 ;
251 ; To register using IAX with FWD, it must be enabled by visiting the URL
252 ; http://www.fwdnet.net/index.php?section_id=112
253 ;
254 ; Note that you need an extension in you default context which matches
255 ; your free world dialup number.  Please replace "FWDNumber" with your
256 ; FWD number and "passwd" with your password.
257 ;
258 ;register => FWDNumber:passwd@iax.fwdnet.net
259 ;
260 ; Through the use of the res_stun_monitor module, Asterisk has the ability to detect when the
261 ; perceived external network address has changed.  When the stun_monitor is installed and
262 ; configured, chan_iax will renew all outbound registrations when the monitor detects any sort
263 ; of network change has occurred. By default this option is enabled, but only takes effect once
264 ; res_stun_monitor is configured.  If res_stun_monitor is enabled and you wish to not
265 ; generate all outbound registrations on a network change, use the option below to disable
266 ; this feature.
267 ;
268 ; subscribe_network_change_event = yes ; on by default
269 ;
270 ; You can disable authentication debugging to reduce the amount of
271 ; debugging traffic.
272 ;
273 ;authdebug=no
274 ;
275 ; See https://wiki.asterisk.org/wiki/display/AST/IP+Quality+of+Service for a description of these parameters.
276 tos=ef
277 ;cos=5
278 ;
279 ; If regcontext is specified, Asterisk will dynamically create and destroy
280 ; a NoOp priority 1 extension for a given peer who registers or unregisters
281 ; with us.  The actual extension is the 'regexten' parameter of the registering
282 ; peer or its name if 'regexten' is not provided.  More than one regexten
283 ; may be supplied if they are separated by '&'.  Patterns may be used in
284 ; regexten.
285 ;
286 ;regcontext=iaxregistrations
287 ;
288 ; If we don't get ACK to our NEW within 2000ms, and autokill is set to yes,
289 ; then we cancel the whole thing (that's enough time for one retransmission
290 ; only).  This is used to keep things from stalling for a long time for a host
291 ; that is not available, but would be ill advised for bad connections.  In
292 ; addition to 'yes' or 'no' you can also specify a number of milliseconds.
293 ; See 'qualify' for individual peers to turn on for just a specific peer.
294 ;
295 autokill=5000
296 ;
297 ; codecpriority controls the codec negotiation of an inbound IAX call.
298 ; This option is inherited to all user entities.  It can also be defined
299 ; in each user entity separately which will override the setting in general.
300 ;
301 ; The valid values are:
302 ;
303 ; caller   - Consider the callers preferred order ahead of the host's.
304 ; host     - Consider the host's preferred order ahead of the caller's.
305 ; disabled - Disable the consideration of codec preference altogether.
306 ;            (this is the original behaviour before preferences were added)
307 ; reqonly  - Same as disabled, only do not consider capabilities if
308 ;            the requested format is not available the call will only
309 ;            be accepted if the requested format is available.
310 ;
311 ; The default value is 'host'
312 ;
313 codecpriority=host
314 ;
315 ; allowfwdownload controls whether this host will serve out firmware to
316 ; IAX clients which request it.  This has only been used for the IAXy,
317 ; and it has been recently proven that this firmware distribution method
318 ; can be used as a source of traffic amplification attacks.  Also, the
319 ; IAXy firmware has not been updated for at least 18 months, so unless
320 ; you are provisioning IAXys in a secure network, we recommend that you
321 ; leave this option to the default, off.
322 ;
323 ;allowfwdownload=yes
324
325 ;rtcachefriends=yes     ; Cache realtime friends by adding them to the internal list
326                         ; just like friends added from the config file only on a
327                         ; as-needed basis? (yes|no)
328
329 ;rtsavesysname=yes    ; Save systemname in realtime database at registration
330                       ; Default = no
331
332 ;rtupdate=yes           ; Send registry updates to database using realtime? (yes|no)
333                         ; If set to yes, when a IAX2 peer registers successfully,
334                         ; the ip address, the origination port, the registration period,
335                         ; and the username of the peer will be set to database via realtime.
336                         ; If not present, defaults to 'yes'.
337
338 ;rtautoclear=yes        ; Auto-Expire friends created on the fly on the same schedule
339                         ; as if it had just registered? (yes|no|<seconds>)
340                         ; If set to yes, when the registration expires, the friend will
341                         ; vanish from the configuration until requested again.
342                         ; If set to an integer, friends expire within this number of
343                         ; seconds instead of the registration interval.
344
345 ;rtignoreregexpire=yes  ; When reading a peer from Realtime, if the peer's registration
346                         ; has expired based on its registration interval, used the stored
347                         ; address information regardless. (yes|no)
348
349 ;parkinglot=edvina              ; Default parkinglot for IAX peers and users
350                                 ; This can also be configured per device
351                                 ; Parkinglots are defined in features.conf
352
353
354 ;
355 ; The following two options are used to disable call token validation for the
356 ; purposes of interoperability with IAX2 endpoints that do not yet support it.
357 ;
358 ; Call token validation can be set as optional for a single IP address or IP
359 ; address range by using the 'calltokenoptional' option. 'calltokenoptional' is
360 ; only a global option.  
361 ;
362 ;calltokenoptional=209.16.236.73/255.255.255.0
363
364 ;
365 ; By setting 'requirecalltoken=no', call token validation becomes optional for
366 ; that peer/user.  By setting 'requirecalltoken=auto', call token validation 
367 ; is optional until a call token supporting peer registers successfully using
368 ; call token validation.  This is used as an indication that from now on, we
369 ; can require it from this peer.  So, requirecalltoken is internally set to yes.
370 ; requirecalltoken may only be used in peer/user/friend definitions,
371 ; not in the global scope.
372 ; By default, 'requirecalltoken=yes'.
373 ;
374 ;requirecalltoken=no
375 ;
376
377 ; AUF : calltokenoptional est défini pour chaque peer dans le fichier auf/iax.global
378
379 ;
380 ; These options are used to limit the amount of call numbers allocated to a
381 ; single IP address.  Before changing any of these values, it is highly encouraged
382 ; to read the user guide associated with these options first.  In most cases, the
383 ; default values for these options are sufficient.
384 ;
385 ; The 'maxcallnumbers' option limits the amount of call numbers allowed for each
386 ; individual remote IP address.  Once an IP address reaches it's call number
387 ; limit, no more new connections are allowed until the previous ones close.  This
388 ; option can be used in a peer definition as well, but only takes effect for
389 ; the IP of a dynamic peer after it completes registration.
390 ;
391 ;maxcallnumbers=512
392 ;
393 ; The 'maxcallnumbers_nonvalidated' is used to set the combined number of call
394 ; numbers that can be allocated for connections where call token  validation
395 ; has been disabled.  Unlike the 'maxcallnumbers' option, this limit is not
396 ; separate for each individual IP address.  Any connection resulting in a
397 ; non-call token validated call number being allocated contributes to this
398 ; limit.  For use cases, see the call token user guide.  This option's 
399 ; default value of 8192 should be sufficient in most cases.
400 ;
401 ;maxcallnumbers_nonvalidated=1024
402 ;
403 ; The [callnumberlimits] section allows custom call number limits to be set
404 ; for specific IP addresses and IP address ranges.  These limits take precedence
405 ; over the global 'maxcallnumbers' option, but may still be overridden by a
406 ; peer defined 'maxcallnumbers' entry.  Note that these limits take effect
407 ; for every individual address within the range, not the range as a whole. 
408 ;
409 ;[callnumberlimits]
410 ;10.1.1.0/255.255.255.0 = 24
411 ;10.1.2.0/255.255.255.0 = 32
412 ;
413
414 ; The shrinkcallerid function removes '(', ' ', ')', non-trailing '.', and '-' not
415 ; in square brackets.  For example, the caller id value 555.5555 becomes 5555555
416 ; when this option is enabled.  Disabling this option results in no modification
417 ; of the caller id value, which is necessary when the caller id represents something
418 ; that must be preserved.  This option can only be used in the [general] section.
419 ; By default this option is on.
420 ;
421 ;shrinkcallerid=yes     ; on by default
422
423 ; un téléphone IP AUF peut recevoir 2 lignes en même temps...
424 incominglimit=2
425
426 ;
427 ; inclusion des configurations locales au site (AUF)
428
429 ; Comptes pour liaisons IAX inter implantations
430 ; Fichier fourni par le paquet asterisk-config-auf-connexions
431 #include "auf/iax.global"
432
433 ; Comptes pour postes clients locaux IAX
434 #include "auf/iax.local"
435