bf578468a99ab9716b749676ae9b1e9d9cd40339
[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 ; You may specify a global default AMA flag for iaxtel calls.  It must be
19 ; one of 'default', 'omit', 'billing', or 'documentation'.  These flags
20 ; are used in the generation of call detail records.
21 ;
22 ;amaflags=default
23 ;
24 ; You may specify a default account for Call Detail Records in addition
25 ; to specifying on a per-user basis
26 ;
27 ;accountcode=lss0101
28 ;
29 ; Specify bandwidth of low, medium, or high to control which codecs are used
30 ; in general.
31 ;
32 bandwidth=low
33 ;
34 ; You can also fine tune codecs here using "allow" and "disallow" clauses
35 ; with specific codecs.  Use "all" to represent all formats.
36 ;
37 ;allow=all                      ; same as bandwidth=high
38 ;disallow=g723.1                ; Hm...  Proprietary, don't use it...
39 disallow=lpc10                  ; Icky sound quality...  Mr. Roboto.
40 ;allow=gsm                      ; Always allow GSM, it's cool :)
41 ;
42 ; You can also adjust several parameters relating to the jitter
43 ; buffer.  Specifically, you can provide a maximum jitter buffer,
44 ; you can turn it off entirely, and you can specify an acceptable
45 ; drop rate (per MEMORY_SIZE, by default 3 of 100).  Disabling the
46 ; jitter buffer is generally recommended unless you are on a highly
47 ; jittery network, since usually jitter buffering will cause you additional
48 ; latency.  Finally, you can specify the maximum
49 ; excess jitter buffer, which if exceeded, causes the jitter buffer to
50 ; slowly shrink in order to improve latency.
51 ;
52 jitterbuffer=no
53 ;dropcount=3
54 ;maxjitterbuffer=500
55 ;maxexcessbuffer=100
56 ;
57 ;trunkfreq=20                   ; How frequently to send trunk msgs (in ms)
58 ;
59 ;
60 ; We can register with another IAX server to let him know where we are
61 ; in case we have a dynamic IP address for example
62 ;
63 ; Register with tormenta using username marko and password secretpass
64 ;
65 ;register => marko:secretpass@tormenta.linux-support.net
66 ;
67 ; Register joe at remote host with no password
68 ;
69 ;register => joe@remotehost:5656
70 ;
71 ; Register marko at tormenta.linux-support.net using RSA key "torkey"
72 ;
73 ;register => marko:[torkey]@tormenta.linux-support.net
74 ;
75 ;
76 ; You can disable authentication debugging to reduce the amount of 
77 ; debugging traffic.
78 ;
79 ;authdebug=no
80 ;
81 ; Finally, you can set values for your TOS bits to help improve 
82 ; performance.  Valid values are:
83 ;   lowdelay            -- Minimize delay
84 ;   throughput          -- Maximize throughput
85 ;   reliability         -- Maximize reliability
86 ;   mincost             -- Minimize cost
87 ;   none                -- No flags
88 ;
89 tos=lowdelay
90 ;
91 ; Guest sections for unauthenticated connection attempts.  Just
92 ; specify an empty secret, or provide no secret section.
93 ;
94 [guest]
95 type=user
96 context=default
97 callerid="Guest IAX User"
98
99 ;
100 ; Trust Caller*ID Coming from iaxtel.com
101 ;
102 [iaxtel]
103 type=user
104 context=default
105 auth=rsa
106 inkeys=iaxtel
107
108 [iaxtel2]
109 ;
110 ; Backwards compatible entry for IAXtel pre-RSA
111 ;
112 type=user
113 context=default
114 deny=0.0.0.0/0.0.0.0
115 permit=216.207.245.47/255.255.255.255
116
117 ;
118 ; Further user sections may be added, specifying a context and a
119 ; secret used for connections with that given authentication name.
120 ; Limited IP based access control is allowed by use of "allow" and
121 ; "deny" keywords.  Multiple rules are permitted.  Multiple permitted
122 ; contexts may be specified, in which case the first will be the default.
123 ; You can also override caller*ID so that when you receive a call you
124 ; set the Caller*ID to be what you want instead of trusting what
125 ; the remote user provides
126 ;
127 ; There are three authentication methods that are supported:  md5, plaintext,
128 ; and rsa.  The least secure is "plaintext", which sends passwords cleartext
129 ; across the net.  "md5" uses a challenge/response md5 sum arrangement, but
130 ; still requires both ends have plain text access to the secret.  "rsa" allows
131 ; unidirectional secret knowledge through public/private keys.  If "rsa"
132 ; authentication is used, "inkeys" is a list of acceptable public keys on the 
133 ; local system that can be used to authenticate the remote peer, separated by
134 ; the ":" character.  "outkey" is a single, private key to use to authenticate
135 ; to the other side.  Public keys are named /var/lib/asterisk/keys/<name>.pub
136 ; while private keys are named /var/lib/asterisk/keys/<name>.key.  Private
137 ; keys should always be 3DES encrypted.
138 ;
139 ;
140 ;[markster]
141 ;type=user
142 ;context=default
143 ;context=local
144 ;auth=md5,plaintext,rsa
145 ;secret=markpasswd
146 ;notransfer=yes         ; Disable IAX native transfer
147 ;callerid="Mark Spencer" <(256) 428-6275>
148 ;deny=0.0.0.0/0.0.0.0
149 ;accountcode=markster0101
150 ;permit=209.16.236.73/255.255.255.0
151 ;
152 ; Peers may also be specified, with a secret and
153 ; a remote hostname.
154 ;
155 [demo]
156 type=peer
157 username=asterisk
158 secret=supersecret
159 host=216.207.245.47
160 ;sendani=no
161 ;host=asterisk.linux-support.net
162 ;port=5036
163 ;mask=255.255.255.255
164 ;qualify=yes    ; Make sure this peer is alive
165
166 ;
167 ; Peers can remotely register as well, so that they can be
168 ; mobile.  Default IP's can also optionally be given but
169 ; are not required.  Caller*ID can be suggested to the other
170 ; side as well if it is for example a phone instead of another
171 ; PBX.
172 ;
173
174 ;[dynamichost]
175 ;host=dynamic
176 ;secret=mysecret
177 ;mailbox=1234           ; Notify about mailbox 1234
178 ;inkeys=key1:key2
179 ;defaultip=216.207.245.34
180 ;callerid="Some Host" <(256) 428-6011>
181 ;
182
183 ;
184 ;[biggateway]
185 ;type=peer
186 ;host=192.168.0.1
187 ;secret=myscret
188 ;trunk=yes              ; Use IAX2 trunking with this host
189 ;
190
191 ;
192 ; Friends are a short cut for creating a user and
193 ; a peer with the same values.
194 ;
195 ;[marko]
196 ;type=friend
197 ;host=dynamic
198 ;secret=moofoo
199 ;context=default
200 ;permit=0.0.0.0/0.0.0.0