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