Add peercontext parameter for default outbound context (bug #1929)
[asterisk/asterisk.git] / configs / iax.conf.sample
1
2 ; Inter-Asterisk eXchange driver definition
3 ;
4 ;
5 ; General settings, like port number to bind to, and
6 ; an option address (the default is to bind to all
7 ; local addresses).
8 ;
9 [general]
10 ;port=5036
11 ;bindaddr=192.168.0.1
12 ;
13 ; Set iaxcompat to yes if you plan to use layered 
14 ; switches.  It incurs a small performance hit to enable it
15 ;
16 ;iaxcompat=yes
17 ;
18 ; For increased security against brute force password attacks
19 ; enable "delayreject" which will delay the sending of authentication
20 ; reject for REGREQ or AUTHREP if there is a password.  
21 ;
22 ;delayreject=yes
23 ;
24 ; You may specify a global default AMA flag for iaxtel calls.  It must be
25 ; one of 'default', 'omit', 'billing', or 'documentation'.  These flags
26 ; are used in the generation of call detail records.
27 ;
28 ;amaflags=default
29 ;
30 ; You may specify a default account for Call Detail Records in addition
31 ; to specifying on a per-user basis
32 ;
33 ;accountcode=lss0101
34 ;
35 ; You may specify a global default language for users. 
36 ; Can be specified also on a per-user basis
37 ; If omitted, will fallback to english
38 ;
39 ;language=en
40 ;
41 ; Specify bandwidth of low, medium, or high to control which codecs are used
42 ; in general.
43 ;
44 bandwidth=low
45 ;
46 ; You can also fine tune codecs here using "allow" and "disallow" clauses
47 ; with specific codecs.  Use "all" to represent all formats.
48 ;
49 ;allow=all                      ; same as bandwidth=high
50 ;disallow=g723.1                ; Hm...  Proprietary, don't use it...
51 disallow=lpc10                  ; Icky sound quality...  Mr. Roboto.
52 ;allow=gsm                      ; Always allow GSM, it's cool :)
53 ;
54 ; You can also adjust several parameters relating to the jitter
55 ; buffer.  Specifically, you can provide a maximum jitter buffer,
56 ; you can turn it off entirely, and you can specify an acceptable
57 ; drop rate (per MEMORY_SIZE, by default 3 of 100).  Disabling the
58 ; jitter buffer is generally recommended unless you are on a highly
59 ; jittery network, since usually jitter buffering will cause you additional
60 ; latency.  Finally, you can specify the maximum
61 ; excess jitter buffer, which if exceeded, causes the jitter buffer to
62 ; slowly shrink in order to improve latency.
63 ;
64 jitterbuffer=no
65 ;dropcount=3
66 ;maxjitterbuffer=500
67 ;maxexcessbuffer=100
68 ;
69 ;trunkfreq=20                   ; How frequently to send trunk msgs (in ms)
70 ;
71 ;
72 ; We can register with another IAX server to let him know where we are
73 ; in case we have a dynamic IP address for example
74 ;
75 ; Register with tormenta using username marko and password secretpass
76 ;
77 ;register => marko:secretpass@tormenta.linux-support.net
78 ;
79 ; Register joe at remote host with no password
80 ;
81 ;register => joe@remotehost:5656
82 ;
83 ; Register marko at tormenta.linux-support.net using RSA key "torkey"
84 ;
85 ;register => marko:[torkey]@tormenta.linux-support.net
86 ;
87 ; Sample Registration for iaxtel
88 ;
89 ; Visit http://www.iaxtel.com to register with iaxtel.  Replace "user"
90 ; and "pass" with your username and password for iaxtel.  Incoming 
91 ; calls arrive at the "s" extension of "default" context.
92 ;
93 ;register => user:pass@iaxtel.com
94 ;
95 ; Sample Registration for IAX + FWD
96 ;
97 ; To register using IAX with FWD, it must be enabled by visiting the URL
98 ; http://www.fwdnet.net/index.php?section_id=112
99 ;
100 ; Note that you need an extension in you default context which matches
101 ; your free world dialup number.  Please replace "FWDNumber" with your
102 ; FWD number and "passwd" with your password.
103 ;
104 ;register => FWDNumber:passwd@iax.fwdnet.net
105 ;
106 ;
107 ; You can disable authentication debugging to reduce the amount of 
108 ; debugging traffic.
109 ;
110 ;authdebug=no
111 ;
112 ; Finally, you can set values for your TOS bits to help improve 
113 ; performance.  Valid values are:
114 ;   lowdelay            -- Minimize delay
115 ;   throughput          -- Maximize throughput
116 ;   reliability         -- Maximize reliability
117 ;   mincost             -- Minimize cost
118 ;   none                -- No flags
119 ;
120 tos=lowdelay
121 ;
122 ; Guest sections for unauthenticated connection attempts.  Just
123 ; specify an empty secret, or provide no secret section.
124 ;
125 [guest]
126 type=user
127 context=default
128 callerid="Guest IAX User"
129
130 ;
131 ; Trust Caller*ID Coming from iaxtel.com
132 ;
133 [iaxtel]
134 type=user
135 context=default
136 auth=rsa
137 inkeys=iaxtel
138
139 ;
140 ; Trust Caller*ID Coming from iax.fwdnet.net
141 ;
142 [iaxfwd]
143 type=user
144 context=default
145 auth=rsa
146 inkeys=freeworlddialup
147
148 ;
149 ; Further user sections may be added, specifying a context and a
150 ; secret used for connections with that given authentication name.
151 ; Limited IP based access control is allowed by use of "allow" and
152 ; "deny" keywords.  Multiple rules are permitted.  Multiple permitted
153 ; contexts may be specified, in which case the first will be the default.
154 ; You can also override caller*ID so that when you receive a call you
155 ; set the Caller*ID to be what you want instead of trusting what
156 ; the remote user provides
157 ;
158 ; There are three authentication methods that are supported:  md5, plaintext,
159 ; and rsa.  The least secure is "plaintext", which sends passwords cleartext
160 ; across the net.  "md5" uses a challenge/response md5 sum arrangement, but
161 ; still requires both ends have plain text access to the secret.  "rsa" allows
162 ; unidirectional secret knowledge through public/private keys.  If "rsa"
163 ; authentication is used, "inkeys" is a list of acceptable public keys on the 
164 ; local system that can be used to authenticate the remote peer, separated by
165 ; the ":" character.  "outkey" is a single, private key to use to authenticate
166 ; to the other side.  Public keys are named /var/lib/asterisk/keys/<name>.pub
167 ; while private keys are named /var/lib/asterisk/keys/<name>.key.  Private
168 ; keys should always be 3DES encrypted.
169 ;
170 ;
171 ;[markster]
172 ;type=user
173 ;context=default
174 ;context=local
175 ;auth=md5,plaintext,rsa
176 ;secret=markpasswd
177 ;notransfer=yes         ; Disable IAX native transfer
178 ;callerid="Mark Spencer" <(256) 428-6275>
179 ;deny=0.0.0.0/0.0.0.0
180 ;accountcode=markster0101
181 ;permit=209.16.236.73/255.255.255.0
182 ;language=en            ; Use english as default language
183 ;
184 ; Peers may also be specified, with a secret and
185 ; a remote hostname.
186 ;
187 [demo]
188 type=peer
189 username=asterisk
190 secret=supersecret
191 host=216.207.245.47
192 ;sendani=no
193 ;host=asterisk.linux-support.net
194 ;port=5036
195 ;mask=255.255.255.255
196 ;qualify=yes    ; Make sure this peer is alive
197
198 ;
199 ; Peers can remotely register as well, so that they can be
200 ; mobile.  Default IP's can also optionally be given but
201 ; are not required.  Caller*ID can be suggested to the other
202 ; side as well if it is for example a phone instead of another
203 ; PBX.
204 ;
205
206 ;[dynamichost]
207 ;host=dynamic
208 ;secret=mysecret
209 ;mailbox=1234           ; Notify about mailbox 1234
210 ;inkeys=key1:key2
211 ;peercontext=local      ; Default context to request for calls to peer
212 ;defaultip=216.207.245.34
213 ;callerid="Some Host" <(256) 428-6011>
214 ;
215
216 ;
217 ;[biggateway]
218 ;type=peer
219 ;host=192.168.0.1
220 ;secret=myscret
221 ;trunk=yes              ; Use IAX2 trunking with this host
222 ;
223
224 ;
225 ; Friends are a short cut for creating a user and
226 ; a peer with the same values.
227 ;
228 ;[marko]
229 ;type=friend
230 ;host=dynamic
231 ;secret=moofoo
232 ;context=default
233 ;permit=0.0.0.0/0.0.0.0