| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; SIP Configuration example for Asterisk | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | ; Syntax for specifying a SIP device in extensions.conf is | 
					
						
							|  |  |  | ; SIP/devicename where devicename is defined in a section below. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; You may also use  | 
					
						
							|  |  |  | ; SIP/username@domain to call any SIP user on the Internet | 
					
						
							|  |  |  | ; (Don't forget to enable DNS SRV records if you want to use this) | 
					
						
							|  |  |  | ;  | 
					
						
							|  |  |  | ; If you define a SIP proxy as a peer below, you may call | 
					
						
							|  |  |  | ; SIP/proxyhostname/user or SIP/user@proxyhostname  | 
					
						
							|  |  |  | ; where the proxyhostname is defined in a section below  | 
					
						
							|  |  |  | ;  | 
					
						
							|  |  |  | ; Useful CLI commands to check peers/users: | 
					
						
							| 
									
										
										
										
											2006-10-06 06:43:49 +00:00
										 |  |  | ;   sip list peers		Show all SIP peers (including friends) | 
					
						
							|  |  |  | ;   sip list users		Show all SIP users (including friends) | 
					
						
							|  |  |  | ;   sip list registry		Show status of hosts we register with | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ;   sip debug			Show all SIP messages | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-10-06 06:43:49 +00:00
										 |  |  | ;   module reload chan_sip.so	Reload configuration file | 
					
						
							| 
									
										
										
										
											2005-03-17 15:56:55 +00:00
										 |  |  | ;				Active SIP peers will not be reconfigured | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | [general] | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | context=default			; Default context for incoming calls | 
					
						
							| 
									
										
										
										
											2006-06-29 07:04:43 +00:00
										 |  |  | ;allowguest=no			; Allow or reject guest calls (default is yes) | 
					
						
							| 
									
										
										
										
											2006-03-27 02:57:17 +00:00
										 |  |  | allowoverlap=no			; Disable overlap dialing support. (Default is yes) | 
					
						
							| 
									
										
										
										
											2006-05-08 15:46:02 +00:00
										 |  |  | ;allowtransfer=no		; Disable all transfers (unless enabled in peers or users) | 
					
						
							|  |  |  | 				; Default is enabled | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;realm=mydomain.tld		; Realm for digest authentication | 
					
						
							| 
									
										
										
										
											2006-05-11 13:54:00 +00:00
										 |  |  | 				; defaults to "asterisk". If you set a system name in | 
					
						
							|  |  |  | 				; asterisk.conf, it defaults to that system name | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 				; Realms MUST be globally unique according to RFC 3261 | 
					
						
							|  |  |  | 				; Set this to your host name or domain name | 
					
						
							| 
									
										
										
										
											2005-01-11 18:39:48 +00:00
										 |  |  | bindport=5060			; UDP Port to bind to (SIP standard port is 5060) | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | bindaddr=0.0.0.0		; IP address to bind to (0.0.0.0 binds to all) | 
					
						
							| 
									
										
										
										
											2004-06-09 14:01:04 +00:00
										 |  |  | srvlookup=yes			; Enable DNS SRV lookups on outbound calls | 
					
						
							|  |  |  | 				; Note: Asterisk only uses the first host  | 
					
						
							|  |  |  | 				; in SRV records | 
					
						
							|  |  |  | 				; Disabling DNS SRV lookups disables the  | 
					
						
							|  |  |  | 				; ability to place SIP calls based on domain  | 
					
						
							|  |  |  | 				; names to some other SIP users on the Internet | 
					
						
							|  |  |  | 				 | 
					
						
							| 
									
										
										
										
											2005-10-04 19:05:40 +00:00
										 |  |  | ;domain=mydomain.tld		; Set default domain for this host | 
					
						
							|  |  |  | 				; If configured, Asterisk will only allow | 
					
						
							|  |  |  | 				; INVITE and REFER to non-local domains | 
					
						
							|  |  |  | 				; Use "sip show domains" to list local domains | 
					
						
							| 
									
										
										
										
											2006-04-23 06:22:29 +00:00
										 |  |  | ;pedantic=yes			; Enable checking of tags in headers,  | 
					
						
							|  |  |  | 				; international character conversions in URIs | 
					
						
							| 
									
										
										
										
											2004-04-27 22:32:57 +00:00
										 |  |  | 				; and multiline formatted headers for strict | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | 				; SIP compatibility (defaults to "no") | 
					
						
							| 
									
										
										
										
											2006-03-28 03:28:52 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ; See doc/README.tos for a description of these parameters. | 
					
						
							|  |  |  | ;tos_sip=cs3                    ; Sets TOS for SIP packets. | 
					
						
							|  |  |  | ;tos_audio=ef                   ; Sets TOS for RTP audio packets. | 
					
						
							|  |  |  | ;tos_video=af41                 ; Sets TOS for RTP video packets. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | ;maxexpiry=3600			; Maximum allowed time of incoming registrations | 
					
						
							|  |  |  | 				; and subscriptions (seconds) | 
					
						
							| 
									
										
										
										
											2006-01-25 12:01:07 +00:00
										 |  |  | ;minexpiry=60			; Minimum length of registrations/subscriptions (default 60) | 
					
						
							| 
									
										
										
										
											2006-09-11 16:41:49 +00:00
										 |  |  | ;defaultexpiry=120		; Default length of incoming/outgoing registration | 
					
						
							| 
									
										
										
										
											2006-01-30 19:50:39 +00:00
										 |  |  | ;t1min=100			; Minimum roundtrip time for messages to monitored hosts | 
					
						
							|  |  |  | 				; Defaults to 100 ms | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | ;notifymimetype=text/plain	; Allow overriding of mime type in MWI NOTIFY | 
					
						
							| 
									
										
										
										
											2004-11-12 03:57:39 +00:00
										 |  |  | ;checkmwi=10			; Default time between mailbox checks for peers | 
					
						
							| 
									
										
										
										
											2006-02-28 21:04:17 +00:00
										 |  |  | ;vmexten=voicemail		; dialplan extension to reach mailbox sets the  | 
					
						
							|  |  |  | 				; Message-Account in the MWI notify message  | 
					
						
							|  |  |  | 				; defaults to "asterisk" | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;disallow=all			; First disallow all codecs | 
					
						
							| 
									
										
										
										
											2003-08-20 14:42:06 +00:00
										 |  |  | ;allow=ulaw			; Allow codecs in order of preference | 
					
						
							| 
									
										
										
										
											2006-09-20 17:39:59 +00:00
										 |  |  | ;allow=ilbc			; see doc/rtp-packetization for framing options | 
					
						
							| 
									
										
										
										
											2006-07-19 20:44:39 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; This option specifies a preference for which music on hold class this channel | 
					
						
							|  |  |  | ; should listen to when put on hold if the music class has not been set on the | 
					
						
							|  |  |  | ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer | 
					
						
							|  |  |  | ; channel putting this one on hold did not suggest a music class. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; This option may be specified globally, or on a per-user or per-peer basis. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ;mohinterpret=default | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; This option specifies which music on hold class to suggest to the peer channel | 
					
						
							|  |  |  | ; when this channel places the peer on hold. It may be specified globally or on | 
					
						
							|  |  |  | ; a per-user or per-peer basis. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ;mohsuggest=default | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;language=en			; Default language setting for all users/peers | 
					
						
							|  |  |  | 				; This may also be set for individual users/peers | 
					
						
							|  |  |  | ;relaxdtmf=yes			; Relax dtmf handling | 
					
						
							| 
									
										
										
										
											2004-05-27 22:12:55 +00:00
										 |  |  | ;rtptimeout=60			; Terminate call if 60 seconds of no RTP activity | 
					
						
							|  |  |  | 				; when we're not on hold | 
					
						
							|  |  |  | ;rtpholdtimeout=300		; Terminate call if 300 seconds of no RTP activity | 
					
						
							|  |  |  | 				; when we're on hold (must be > rtptimeout) | 
					
						
							| 
									
										
										
										
											2004-06-21 04:29:50 +00:00
										 |  |  | ;trustrpid = no			; If Remote-Party-ID should be trusted | 
					
						
							| 
									
										
										
										
											2005-09-27 01:54:17 +00:00
										 |  |  | ;sendrpid = yes			; If Remote-Party-ID should be sent | 
					
						
							| 
									
										
										
										
											2004-12-31 15:38:14 +00:00
										 |  |  | ;progressinband=never		; If we should generate in-band ringing always | 
					
						
							| 
									
										
										
										
											2004-11-14 15:13:13 +00:00
										 |  |  | 				; use 'never' to never use in-band signalling, even in cases | 
					
						
							|  |  |  | 				; where some buggy devices might not render it | 
					
						
							| 
									
										
										
										
											2006-03-16 18:01:08 +00:00
										 |  |  | 				; Valid values: yes, no, never Default: never | 
					
						
							| 
									
										
										
										
											2004-06-17 00:09:41 +00:00
										 |  |  | ;useragent=Asterisk PBX		; Allows you to change the user agent string | 
					
						
							| 
									
										
										
										
											2004-11-12 03:57:39 +00:00
										 |  |  | ;promiscredir = no      	; If yes, allows 302 or REDIR to non-local SIP address | 
					
						
							|  |  |  | 	                       	; Note that promiscredir when redirects are made to the | 
					
						
							| 
									
										
										
										
											2006-01-20 23:19:49 +00:00
										 |  |  |        	                	; local system will cause loops since Asterisk is incapable | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  |        	                	; of performing a "hairpin" call. | 
					
						
							| 
									
										
										
										
											2004-12-02 23:29:25 +00:00
										 |  |  | ;usereqphone = no		; If yes, ";user=phone" is added to uri that contains | 
					
						
							|  |  |  | 				; a valid phone number | 
					
						
							| 
									
										
										
										
											2006-02-10 16:33:47 +00:00
										 |  |  | ;dtmfmode = rfc2833		; Set default dtmfmode for sending DTMF. Default: rfc2833 | 
					
						
							| 
									
										
										
										
											2004-11-12 03:57:39 +00:00
										 |  |  | 				; Other options:  | 
					
						
							| 
									
										
										
										
											2006-02-10 16:33:47 +00:00
										 |  |  | 				; info : SIP INFO messages | 
					
						
							|  |  |  | 				; inband : Inband audio (requires 64 kbit codec -alaw, ulaw) | 
					
						
							|  |  |  | 				; auto : Use rfc2833 if offered, inband otherwise | 
					
						
							| 
									
										
										
										
											2004-11-28 21:49:07 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ;compactheaders = yes		; send compact sip headers. | 
					
						
							| 
									
										
										
										
											2006-03-27 03:35:49 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ;videosupport=yes		; Turn on support for SIP video | 
					
						
							|  |  |  | ;maxcallbitrate=384		; Maximum bitrate for video calls (default 384 kb/s) | 
					
						
							|  |  |  | 				; Videosupport and maxcallbitrate is settable | 
					
						
							|  |  |  | 				; for peers and users as well | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | ;callevents=no			; generate manager events when sip ua  | 
					
						
							|  |  |  | 				; performs events (e.g. hold) | 
					
						
							| 
									
										
										
										
											2006-05-24 03:28:49 +00:00
										 |  |  | ;alwaysauthreject = yes		; When an incoming INVITE or REGISTER is to be rejected, | 
					
						
							|  |  |  |  		    		; for any reason, always reject with '401 Unauthorized' | 
					
						
							|  |  |  |  				; instead of letting the requester know whether there was | 
					
						
							|  |  |  |  				; a matching user or peer for their request | 
					
						
							| 
									
										
										
										
											2006-07-13 20:35:41 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ;g726nonstandard = yes		; If the peer negotiates G726-32 audio, use AAL2 packing | 
					
						
							|  |  |  | 				; order instead of RFC3551 packing order (this is required | 
					
						
							|  |  |  | 				; for Sipura and Grandstream ATAs, among others). This is | 
					
						
							|  |  |  | 				; contrary to the RFC3551 specification, the peer _should_ | 
					
						
							|  |  |  | 				; be negotiating AAL2-G726-32 instead :-( | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-09-07 23:45:34 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ; If regcontext is specified, Asterisk will dynamically create and destroy a | 
					
						
							|  |  |  | ; NoOp priority 1 extension for a given peer who registers or unregisters with | 
					
						
							| 
									
										
										
										
											2006-06-29 07:04:43 +00:00
										 |  |  | ; us and have a "regexten=" configuration item.   | 
					
						
							|  |  |  | ; Multiple contexts may be specified by separating them with '&'. The  | 
					
						
							| 
									
										
										
										
											2006-05-18 14:07:46 +00:00
										 |  |  | ; actual extension is the 'regexten' parameter of the registering peer or its | 
					
						
							|  |  |  | ; name if 'regexten' is not provided.  If more than one context is provided, | 
					
						
							|  |  |  | ; the context must be specified within regexten by appending the desired | 
					
						
							|  |  |  | ; context after '@'.  More than one regexten may be supplied if they are  | 
					
						
							|  |  |  | ; separated by '&'.  Patterns may be used in regexten. | 
					
						
							| 
									
										
										
										
											2004-09-07 23:45:34 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-11-12 03:57:39 +00:00
										 |  |  | ;regcontext=sipregistrations | 
					
						
							| 
									
										
										
										
											2006-06-29 07:04:43 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ;--------------------------- SIP DEBUGGING --------------------------------------------------- | 
					
						
							|  |  |  | ;sipdebug = yes			; Turn on SIP debugging by default, from | 
					
						
							|  |  |  | 				; the moment the channel loads this configuration | 
					
						
							|  |  |  | ;recordhistory=yes		; Record SIP history by default  | 
					
						
							|  |  |  | 				; (see sip history / sip no history) | 
					
						
							|  |  |  | ;dumphistory=yes		; Dump SIP history at end of SIP dialogue | 
					
						
							|  |  |  | 				; SIP history is output to the DEBUG logging channel | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ;--------------------------- STATUS NOTIFICATIONS (SUBSCRIPTIONS) ---------------------------- | 
					
						
							|  |  |  | ; You can subscribe to the status of extensions with a "hint" priority | 
					
						
							|  |  |  | ; (See extensions.conf.sample for examples) | 
					
						
							|  |  |  | ; chan_sip support two major formats for notifications: dialog-info and SIMPLE  | 
					
						
							|  |  |  | ; Note: Subscriptions does not work if you have a realtime dialplan and use the | 
					
						
							|  |  |  | ; realtime switch. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ;allowsubscribe=no		; Disable support for subscriptions. (Default is yes) | 
					
						
							|  |  |  | ;subscribecontext = default	; Set a specific context for SUBSCRIBE requests | 
					
						
							|  |  |  | 				; Useful to limit subscriptions to local extensions | 
					
						
							|  |  |  | 				; Settable per peer/user also | 
					
						
							|  |  |  | ;notifyringing = yes		; Notify subscriptions on RINGING state | 
					
						
							| 
									
										
										
										
											2006-06-13 19:38:41 +00:00
										 |  |  | ;----------------------------------------- T.38 FAX PASSTHROUGH SUPPORT ----------------------- | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-06-30 07:18:30 +00:00
										 |  |  | ; This setting is available in the [general] section as well as in device configurations. | 
					
						
							|  |  |  | ; Setting this to yes, enables T.38 fax (UDPTL) passthrough on SIP to SIP calls, provided | 
					
						
							|  |  |  | ; both parties have T38 support enabled in their Asterisk configuration (either general or | 
					
						
							|  |  |  | ; peer/user/friend sections) | 
					
						
							| 
									
										
										
										
											2006-06-13 19:38:41 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; t38pt_udptl = yes            ; Default false | 
					
						
							| 
									
										
										
										
											2004-09-07 23:45:34 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-02-01 13:23:59 +00:00
										 |  |  | ;----------------------------------------- OUTBOUND SIP REGISTRATIONS  ------------------------ | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; Asterisk can register as a SIP user agent to a SIP proxy (provider) | 
					
						
							|  |  |  | ; Format for the register statement is: | 
					
						
							|  |  |  | ;       register => user[:secret[:authuser]]@host[:port][/extension] | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ; If no extension is given, the 's' extension is used. The extension needs to | 
					
						
							|  |  |  | ; be defined in extensions.conf to be able to accept calls from this SIP proxy | 
					
						
							|  |  |  | ; (provider). | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ; host is either a host name defined in DNS or the name of a section defined | 
					
						
							|  |  |  | ; below. | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-10-06 16:20:42 +00:00
										 |  |  | ; A similar effect can be achieved by adding a "contact" option in a peer section. | 
					
						
							|  |  |  | ; this is equivalent to having the following line in the general section: | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ;	register => username:secret@host/contact | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; and more readable because you don't have to write the parameters in two places | 
					
						
							|  |  |  | ; (note that the "port" is ignored - this is a bug that should be fixed). | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; Examples: | 
					
						
							| 
									
										
										
										
											2004-04-03 22:59:12 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | ;register => 1234:password@mysipprovider.com	 | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;     This will pass incoming calls to the 's' extension | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;register => 2345:password@sip_proxy/1234 | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ;    Register 2345 at sip provider 'sip_proxy'.  Calls from this provider | 
					
						
							|  |  |  | ;    connect to local extension 1234 in extensions.conf, default context, | 
					
						
							|  |  |  | ;    unless you configure a [sip_proxy] section below, and configure a | 
					
						
							|  |  |  | ;    context. | 
					
						
							|  |  |  | ;    Tip 1: Avoid assigning hostname to a sip.conf section like [provider.com] | 
					
						
							|  |  |  | ;    Tip 2: Use separate type=peer and type=user sections for SIP providers | 
					
						
							|  |  |  | ;           (instead of type=friend) if you have calls in both directions | 
					
						
							| 
									
										
										
										
											2004-03-25 20:52:57 +00:00
										 |  |  |    | 
					
						
							| 
									
										
										
										
											2004-12-12 03:44:17 +00:00
										 |  |  | ;registertimeout=20		; retry registration calls every 20 seconds (default) | 
					
						
							| 
									
										
										
										
											2005-06-05 14:47:09 +00:00
										 |  |  | ;registerattempts=10		; Number of registration attempts before we give up | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | 				; 0 = continue forever, hammering the other server | 
					
						
							|  |  |  | 				; until it accepts the registration | 
					
						
							| 
									
										
											  
											
												Merged revisions 7285,7299,7310,7329 via svnmerge from 
https://origsvn.digium.com/svn/asterisk/branches/1.2
........
r7285 | tilghman | 2005-12-02 15:12:05 -0600 (Fri, 02 Dec 2005) | 2 lines
Turn on executable bits for startup scripts, and fix bash var interpolation for Mandrake
........
r7299 | oej | 2005-12-02 19:24:40 -0600 (Fri, 02 Dec 2005) | 2 lines
Documenting the default registerattempts setting as 0, continue hammering the server for ever and ever ;-)
........
r7310 | tilghman | 2005-12-03 13:55:05 -0600 (Sat, 03 Dec 2005) | 3 lines
Bug 5925: check for "Unknown", as that's what app_voicemail puts into the field for Unknown callerid
Also, remove useless res checks (initialized to 0; never set)
........
r7329 | kpfleming | 2005-12-04 12:03:07 -0600 (Sun, 04 Dec 2005) | 2 lines
use a more efficient way to get the revision number, that will also report if the working copy contains uncommitted modifications
........
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@7330 65c4cc65-6c06-0410-ace0-fbb531ad65f3
											
										 
											2005-12-04 18:12:52 +00:00
										 |  |  | 				; Default is 0 tries, continue forever | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ;----------------------------------------- NAT SUPPORT ------------------------ | 
					
						
							|  |  |  | ; The externip, externhost and localnet settings are used if you use Asterisk | 
					
						
							|  |  |  | ; behind a NAT device to communicate with services on the outside. | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | ;externip = 200.201.202.203	; Address that we're going to put in outbound SIP | 
					
						
							|  |  |  | 				; messages if we're behind a NAT | 
					
						
							| 
									
										
										
										
											2004-05-08 20:58:24 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | 				; The externip and localnet is used | 
					
						
							|  |  |  | 				; when registering and communicating with other proxies | 
					
						
							| 
									
										
										
										
											2004-03-19 21:29:13 +00:00
										 |  |  | 				; that we're registered with | 
					
						
							| 
									
										
										
										
											2004-12-28 21:20:18 +00:00
										 |  |  | ;externhost=foo.dyndns.net	; Alternatively you can specify an  | 
					
						
							|  |  |  | 				; external host, and Asterisk will  | 
					
						
							|  |  |  | 				; perform DNS queries periodically.  Not | 
					
						
							|  |  |  | 				; recommended for production  | 
					
						
							|  |  |  | 				; environments!  Use externip instead | 
					
						
							|  |  |  | ;externrefresh=10		; How often to refresh externhost if  | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | 				; used | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | 				; You may add multiple local networks.  A reasonable  | 
					
						
							|  |  |  | 				; set of defaults are: | 
					
						
							| 
									
										
										
										
											2004-05-08 20:58:24 +00:00
										 |  |  | ;localnet=192.168.0.0/255.255.0.0; All RFC 1918 addresses are local networks | 
					
						
							|  |  |  | ;localnet=10.0.0.0/255.0.0.0	; Also RFC1918 | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;localnet=172.16.0.0/12		; Another RFC1918 with CIDR notation | 
					
						
							| 
									
										
										
										
											2004-05-08 20:58:24 +00:00
										 |  |  | ;localnet=169.254.0.0/255.255.0.0 ;Zero conf local network | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; The nat= setting is used when Asterisk is on a public IP, communicating with | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ; devices hidden behind a NAT device (broadband router).  If you have one-way | 
					
						
							|  |  |  | ; audio problems, you usually have problems with your NAT configuration or your | 
					
						
							|  |  |  | ; firewall's support of SIP+RTP ports.  You configure Asterisk choice of RTP | 
					
						
							|  |  |  | ; ports for incoming audio in rtp.conf | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ;nat=no				; Global NAT settings  (Affects all peers and users) | 
					
						
							|  |  |  |                                 ; yes = Always ignore info and assume NAT | 
					
						
							|  |  |  |                                 ; no = Use NAT mode only according to RFC3581  | 
					
						
							|  |  |  |                                 ; never = Never attempt NAT mode or RFC3581 support | 
					
						
							|  |  |  | 				; route = Assume NAT, don't send rport  | 
					
						
							|  |  |  | 				; (work around more UNIDEN bugs) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-02-01 13:23:59 +00:00
										 |  |  | ;canreinvite=yes		; Asterisk by default tries to redirect the | 
					
						
							|  |  |  | 				; RTP media stream (audio) to go directly from | 
					
						
							|  |  |  | 				; the caller to the callee.  Some devices do not | 
					
						
							| 
									
										
										
										
											2006-05-18 16:57:59 +00:00
										 |  |  | 				; support this (especially if one of them is behind a NAT). | 
					
						
							| 
									
										
										
										
											2006-02-01 13:23:59 +00:00
										 |  |  | 				; The default setting is YES. If you have all clients | 
					
						
							| 
									
										
										
										
											2006-05-18 16:57:59 +00:00
										 |  |  | 				; behind a NAT, or for some other reason wants Asterisk to | 
					
						
							|  |  |  | 				; stay in the audio path, you may want to turn this off. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ;canreinvite=nonat		; An additional option is to allow media path redirection | 
					
						
							|  |  |  | 				; (reinvite) but only when the peer where the media is being | 
					
						
							|  |  |  | 				; sent is known to not be behind a NAT (as the RTP core can | 
					
						
							|  |  |  | 				; determine it based on the apparent IP address the media | 
					
						
							|  |  |  | 				; arrives from). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ;canreinvite=update		; Yet a third option... use UPDATE for media path redirection, | 
					
						
							|  |  |  | 				; instead of INVITE. This can be combined with 'nonat', as | 
					
						
							|  |  |  | 				; 'canreinvite=update,nonat'. It implies 'yes'. | 
					
						
							| 
									
										
										
										
											2006-02-01 13:23:59 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ;----------------------------------------- REALTIME SUPPORT ------------------------ | 
					
						
							|  |  |  | ; For additional information on ARA, the Asterisk Realtime Architecture, | 
					
						
							| 
									
										
										
										
											2006-03-19 09:35:11 +00:00
										 |  |  | ; please read realtime.txt and extconfig.txt in the /doc directory of the | 
					
						
							| 
									
										
										
										
											2006-02-01 13:23:59 +00:00
										 |  |  | ; source code. | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-08-25 02:25:30 +00:00
										 |  |  | ;rtcachefriends=yes		; Cache realtime friends by adding them to the internal list | 
					
						
							|  |  |  | 				; just like friends added from the config file only on a | 
					
						
							|  |  |  | 				; as-needed basis? (yes|no) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-07-02 12:00:36 +00:00
										 |  |  | ;rtsavesysname=yes		; Save systemname in realtime database at registration | 
					
						
							|  |  |  | 				; Default= no | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-08-25 02:25:30 +00:00
										 |  |  | ;rtupdate=yes			; Send registry updates to database using realtime? (yes|no) | 
					
						
							|  |  |  | 				; If set to yes, when a SIP UA registers successfully, the ip address, | 
					
						
							|  |  |  | 				; the origination port, the registration period, and the username of | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | 				; the UA will be set to database via realtime.  | 
					
						
							|  |  |  | 				; If not present, defaults to 'yes'. | 
					
						
							| 
									
										
										
										
											2005-08-25 02:25:30 +00:00
										 |  |  | ;rtautoclear=yes		; Auto-Expire friends created on the fly on the same schedule | 
					
						
							|  |  |  | 				; as if it had just registered? (yes|no|<seconds>) | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | 				; If set to yes, when the registration expires, the friend will | 
					
						
							|  |  |  | 				; vanish from the configuration until requested again. If set | 
					
						
							|  |  |  | 				; to an integer, friends expire within this number of seconds | 
					
						
							|  |  |  | 				; instead of the registration interval. | 
					
						
							| 
									
										
										
										
											2005-08-25 02:25:30 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-10-28 16:00:09 +00:00
										 |  |  | ;ignoreregexpire=yes		; Enabling this setting has two functions: | 
					
						
							|  |  |  | 				; | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | 				; For non-realtime peers, when their registration expires, the | 
					
						
							|  |  |  | 				; information will _not_ be removed from memory or the Asterisk database | 
					
						
							|  |  |  | 				; if you attempt to place a call to the peer, the existing information | 
					
						
							| 
									
										
										
										
											2006-09-11 16:41:49 +00:00
										 |  |  | 				; will be used in spite of it having expired | 
					
						
							| 
									
										
										
										
											2005-10-28 16:00:09 +00:00
										 |  |  | 				; | 
					
						
							|  |  |  | 				; For realtime peers, when the peer is retrieved from realtime storage, | 
					
						
							|  |  |  | 				; the registration information will be used regardless of whether | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | 				; it has expired or not; if it expires while the realtime peer  | 
					
						
							|  |  |  | 				; is still in memory (due to caching or other reasons), the  | 
					
						
							|  |  |  | 				; information will not be removed from realtime storage | 
					
						
							| 
									
										
										
										
											2005-02-10 20:04:42 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-02-01 13:23:59 +00:00
										 |  |  | ;----------------------------------------- SIP DOMAIN SUPPORT ------------------------ | 
					
						
							| 
									
										
										
										
											2005-09-26 23:14:59 +00:00
										 |  |  | ; Incoming INVITE and REFER messages can be matched against a list of 'allowed' | 
					
						
							|  |  |  | ; domains, each of which can direct the call to a specific context if desired. | 
					
						
							|  |  |  | ; By default, all domains are accepted and sent to the default context or the | 
					
						
							|  |  |  | ; context associated with the user/peer placing the call. | 
					
						
							|  |  |  | ; Domains can be specified using: | 
					
						
							|  |  |  | ; domain=<domain>[,<context>] | 
					
						
							|  |  |  | ; Examples: | 
					
						
							|  |  |  | ; domain=myasterisk.dom | 
					
						
							|  |  |  | ; domain=customer.com,customer-context | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; In addition, all the 'default' domains associated with a server should be | 
					
						
							|  |  |  | ; added if incoming request filtering is desired. | 
					
						
							|  |  |  | ; autodomain=yes | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; To disallow requests for domains not serviced by this server: | 
					
						
							|  |  |  | ; allowexternaldomains=no | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-06-29 07:04:43 +00:00
										 |  |  | ;domain=mydomain.tld,mydomain-incoming | 
					
						
							|  |  |  | 				; Add domain and configure incoming context | 
					
						
							|  |  |  | 				; for external calls to this domain | 
					
						
							|  |  |  | ;domain=1.2.3.4			; Add IP address as local domain | 
					
						
							|  |  |  | 				; You can have several "domain" settings | 
					
						
							|  |  |  | ;allowexternalinvites=no	; Disable INVITE and REFER to non-local domains | 
					
						
							|  |  |  | 				; Default is yes | 
					
						
							|  |  |  | ;autodomain=yes			; Turn this on to have Asterisk add local host | 
					
						
							|  |  |  | 				; name and local IP to domain list. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; fromdomain=mydomain.tld 	; When making outbound SIP INVITEs to | 
					
						
							|  |  |  |                           	; non-peers, use your primary domain "identity" | 
					
						
							|  |  |  |                           	; for From: headers instead of just your IP | 
					
						
							|  |  |  |                           	; address. This is to be polite and | 
					
						
							|  |  |  |                           	; it may be a mandatory requirement for some | 
					
						
							|  |  |  |                           	; destinations which do not have a prior | 
					
						
							|  |  |  |                           	; account relationship with your server.  | 
					
						
							| 
									
										
										
										
											2005-11-30 05:26:29 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-05-31 16:56:50 +00:00
										 |  |  | ;------------------------------ JITTER BUFFER CONFIGURATION -------------------------- | 
					
						
							|  |  |  | ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a | 
					
						
							|  |  |  |                               ; SIP channel. Defaults to "no". An enabled jitterbuffer will | 
					
						
							|  |  |  |                               ; be used only if the sending side can create and the receiving | 
					
						
							|  |  |  |                               ; side can not accept jitter. The SIP channel can accept jitter, | 
					
						
							|  |  |  |                               ; thus a jitterbuffer on the receive SIP side will be used only | 
					
						
							|  |  |  |                               ; if it is forced and enabled. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; jbforce = no                ; Forces the use of a jitterbuffer on the receive side of a SIP | 
					
						
							|  |  |  |                               ; channel. Defaults to "no". | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is | 
					
						
							|  |  |  |                               ; resynchronized. Useful to improve the quality of the voice, with | 
					
						
							| 
									
										
										
										
											2006-09-11 16:41:49 +00:00
										 |  |  |                               ; big jumps in/broken timestamps, usually sent from exotic devices | 
					
						
							| 
									
										
										
										
											2006-05-31 16:56:50 +00:00
										 |  |  |                               ; and programs. Defaults to 1000. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a SIP | 
					
						
							| 
									
										
										
										
											2006-09-11 16:41:49 +00:00
										 |  |  |                               ; channel. Two implementations are currently available - "fixed" | 
					
						
							| 
									
										
										
										
											2006-05-31 16:56:50 +00:00
										 |  |  |                               ; (with size always equals to jbmaxsize) and "adaptive" (with | 
					
						
							|  |  |  |                               ; variable size, actually the new jb of IAX2). Defaults to fixed. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no". | 
					
						
							|  |  |  | ;----------------------------------------------------------------------------------- | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-03-24 23:06:21 +00:00
										 |  |  | [authentication] | 
					
						
							|  |  |  | ; Global credentials for outbound calls, i.e. when a proxy challenges your | 
					
						
							|  |  |  | ; Asterisk server for authentication. These credentials override | 
					
						
							|  |  |  | ; any credentials in peer/register definition if realm is matched. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; This way, Asterisk can authenticate for outbound calls to other | 
					
						
							|  |  |  | ; realms. We match realm on the proxy challenge and pick an set of  | 
					
						
							|  |  |  | ; credentials from this list | 
					
						
							|  |  |  | ; Syntax: | 
					
						
							|  |  |  | ;	auth = <user>:<secret>@<realm> | 
					
						
							|  |  |  | ;	auth = <user>#<md5secret>@<realm> | 
					
						
							|  |  |  | ; Example: | 
					
						
							|  |  |  | ;auth=mark:topsecret@digium.com | 
					
						
							|  |  |  | ;  | 
					
						
							|  |  |  | ; You may also add auth= statements to [peer] definitions  | 
					
						
							|  |  |  | ; Peer auth= override all other authentication settings if we match on realm | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ;------------------------------------------------------------------------------ | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ; Users and peers have different settings available. Friends have all settings, | 
					
						
							|  |  |  | ; since a friend is both a peer and a user | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; User config options:        Peer configuration: | 
					
						
							|  |  |  | ; --------------------        ------------------- | 
					
						
							|  |  |  | ; context                     context | 
					
						
							| 
									
										
										
										
											2006-01-20 14:32:30 +00:00
										 |  |  | ; callingpres		      callingpres | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ; permit                      permit | 
					
						
							|  |  |  | ; deny                        deny | 
					
						
							|  |  |  | ; secret                      secret | 
					
						
							|  |  |  | ; md5secret                   md5secret | 
					
						
							|  |  |  | ; dtmfmode                    dtmfmode | 
					
						
							|  |  |  | ; canreinvite                 canreinvite | 
					
						
							|  |  |  | ; nat                         nat | 
					
						
							|  |  |  | ; callgroup                   callgroup | 
					
						
							|  |  |  | ; pickupgroup                 pickupgroup | 
					
						
							|  |  |  | ; language                    language | 
					
						
							|  |  |  | ; allow                       allow | 
					
						
							|  |  |  | ; disallow                    disallow | 
					
						
							|  |  |  | ; insecure                    insecure | 
					
						
							| 
									
										
										
										
											2004-06-21 04:29:50 +00:00
										 |  |  | ; trustrpid                   trustrpid | 
					
						
							| 
									
										
										
										
											2004-06-26 21:17:12 +00:00
										 |  |  | ; progressinband              progressinband | 
					
						
							| 
									
										
										
										
											2004-06-21 06:11:56 +00:00
										 |  |  | ; promiscredir                promiscredir | 
					
						
							| 
									
										
										
										
											2004-11-08 00:35:23 +00:00
										 |  |  | ; useclientcode               useclientcode | 
					
						
							| 
									
										
										
										
											2005-02-12 20:14:21 +00:00
										 |  |  | ; accountcode                 accountcode | 
					
						
							|  |  |  | ; setvar                      setvar | 
					
						
							| 
									
										
										
										
											2005-02-13 16:40:56 +00:00
										 |  |  | ; callerid		      callerid | 
					
						
							| 
									
										
										
										
											2005-02-13 01:16:10 +00:00
										 |  |  | ; amaflags		      amaflags | 
					
						
							| 
									
										
										
										
											2005-08-30 21:26:33 +00:00
										 |  |  | ; call-limit		      call-limit | 
					
						
							| 
									
										
										
										
											2006-03-27 02:57:17 +00:00
										 |  |  | ; allowoverlap		      allowoverlap | 
					
						
							|  |  |  | ; allowsubscribe	      allowsubscribe | 
					
						
							| 
									
										
										
										
											2006-05-08 15:46:02 +00:00
										 |  |  | ; allowtransfer	      	      allowtransfer | 
					
						
							| 
									
										
										
										
											2005-10-04 19:05:40 +00:00
										 |  |  | ; subscribecontext	      subscribecontext | 
					
						
							| 
									
										
										
										
											2006-03-27 03:35:49 +00:00
										 |  |  | ; videosupport		      videosupport | 
					
						
							|  |  |  | ; maxcallbitrate	      maxcallbitrate | 
					
						
							| 
									
										
										
										
											2006-08-31 01:59:02 +00:00
										 |  |  | ; rfc2833compensate           mailbox | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;                             username | 
					
						
							|  |  |  | ;                             template | 
					
						
							|  |  |  | ;                             fromdomain | 
					
						
							| 
									
										
										
										
											2004-09-07 23:45:34 +00:00
										 |  |  | ;                             regexten | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;                             fromuser | 
					
						
							|  |  |  | ;                             host | 
					
						
							|  |  |  | ;                             port | 
					
						
							|  |  |  | ;                             qualify | 
					
						
							|  |  |  | ;                             defaultip | 
					
						
							| 
									
										
										
										
											2004-05-27 22:12:55 +00:00
										 |  |  | ;                             rtptimeout | 
					
						
							|  |  |  | ;                             rtpholdtimeout | 
					
						
							| 
									
										
										
										
											2005-09-27 01:54:17 +00:00
										 |  |  | ;                             sendrpid | 
					
						
							| 
									
										
										
										
											2006-06-29 08:01:08 +00:00
										 |  |  | ;                             outboundproxy | 
					
						
							| 
									
										
										
										
											2006-08-31 01:59:02 +00:00
										 |  |  | ;                             rfc2833compensate | 
					
						
							| 
									
										
										
										
											2006-10-06 15:41:12 +00:00
										 |  |  | ;                             contact | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ;[sip_proxy] | 
					
						
							|  |  |  | ; For incoming calls only. Example: FWD (Free World Dialup) | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; We match on IP address of the proxy for incoming calls  | 
					
						
							|  |  |  | ; since we can not match on username (caller id) | 
					
						
							|  |  |  | ;type=peer | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;context=from-fwd | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;host=fwd.pulver.com | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ;[sip_proxy-out] | 
					
						
							| 
									
										
										
										
											2006-06-29 08:01:08 +00:00
										 |  |  | ;type=peer          			; we only want to call out, not be called | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;secret=guessit | 
					
						
							| 
									
										
										
										
											2006-06-29 08:01:08 +00:00
										 |  |  | ;username=yourusername			; Authentication user for outbound proxies | 
					
						
							|  |  |  | ;fromuser=yourusername			; Many SIP providers require this! | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;fromdomain=provider.sip.domain	 | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;host=box.provider.com | 
					
						
							| 
									
										
										
										
											2006-06-29 08:01:08 +00:00
										 |  |  | ;usereqphone=yes			; This provider requires ";user=phone" on URI | 
					
						
							|  |  |  | ;call-limit=5				; permit only 5 simultaneous outgoing calls to this peer | 
					
						
							|  |  |  | ;outboundproxy=proxy.provider.domain	; send outbound signaling to this proxy, not directly to the peer | 
					
						
							| 
									
										
										
										
											2006-04-04 08:01:46 +00:00
										 |  |  | 				; Call-limits will not be enforced on real-time peers, | 
					
						
							|  |  |  | 				; since they are not stored in-memory | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-10-06 15:41:12 +00:00
										 |  |  | ;--- sample definition for a provider | 
					
						
							|  |  |  | ;[provider1] | 
					
						
							|  |  |  | ;type=peer | 
					
						
							|  |  |  | ;host=sip.provider1.com | 
					
						
							|  |  |  | ;username=4015552299		; how your provider knows you | 
					
						
							|  |  |  | ;secret=youwillneverguessit | 
					
						
							|  |  |  | ;contact=123			; tell asterisk to register as username:secret@host/contact | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;------------------------------------------------------------------------------ | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | ; Definitions of locally connected SIP devices | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-29 21:05:34 +00:00
										 |  |  | ; type = user	a device that authenticates to us by "from" field to place calls | 
					
						
							|  |  |  | ; type = peer	a device we place calls to or that calls us and we match by host | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; type = friend two configurations (peer+user) in one | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | ; For device names, we recommend using only a-z, numerics (0-9) and underscore | 
					
						
							|  |  |  | ;  | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; For local phones, type=friend works most of the time | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-09-11 16:41:49 +00:00
										 |  |  | ; If you have one-way audio, you probably have NAT problems.  | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; If Asterisk is on a public IP, and the phone is inside of a NAT device | 
					
						
							|  |  |  | ; you will need to configure nat option for those phones. | 
					
						
							|  |  |  | ; Also, turn on qualify=yes to keep the nat session open | 
					
						
							| 
									
										
										
										
											2006-10-06 16:43:36 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; Because you might have a large number of similar sections, it is generally | 
					
						
							|  |  |  | ; convenient to use templates for the common parameters, and add them | 
					
						
							|  |  |  | ; the the various sections. Examples are below, and we can even leave | 
					
						
							|  |  |  | ; the templates uncommented as they will not harm: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | [basic-options](!)		; a template | 
					
						
							|  |  |  | 	dtmfmode=rfc2833 | 
					
						
							|  |  |  | 	context=from-office | 
					
						
							|  |  |  | 	type=friend | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | [natted-phone](!,basic-options)	; another template inheriting basic-options | 
					
						
							|  |  |  | 	nat=yes | 
					
						
							|  |  |  | 	canreinvite=no | 
					
						
							|  |  |  | 	host=dynamic | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | [public-phone](!,basic-options)	; another template inheriting basic-options | 
					
						
							|  |  |  | 	nat=no | 
					
						
							|  |  |  | 	canreinvite=yes | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | [my-codecs](!)		; a template for my preferred codecs | 
					
						
							|  |  |  | 	disallow=all | 
					
						
							|  |  |  | 	allow=ilbc | 
					
						
							|  |  |  | 	allow=g729 | 
					
						
							|  |  |  | 	allow=gsm | 
					
						
							|  |  |  | 	allow=g723 | 
					
						
							|  |  |  | 	allow=ulaw | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-10-06 16:43:36 +00:00
										 |  |  | [ulaw-phone](!)		; and another one for ulaw-only | 
					
						
							|  |  |  | 	disallow=all | 
					
						
							|  |  |  | 	allow=ulaw | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; and finally instantiate a few phones | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; [2133](natted-phone,my-codecs) | 
					
						
							|  |  |  | ;	secret = peekaboo | 
					
						
							|  |  |  | ; [2134](natted-phone,ulaw-hone) | 
					
						
							|  |  |  | ;	secret = not_very_secret | 
					
						
							|  |  |  | ; [2136](public-phone,ulaw-hone) | 
					
						
							|  |  |  | ;	secret = not_very_secret_either | 
					
						
							|  |  |  | ; ... | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ; Standard configurations not using templates look like this: | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;[grandstream1] | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;type=friend 			 | 
					
						
							|  |  |  | ;context=from-sip		; Where to start in the dialplan when this phone calls | 
					
						
							|  |  |  | ;callerid=John Doe <1234>	; Full caller ID, to override the phones config | 
					
						
							| 
									
										
										
										
											2006-01-24 18:15:20 +00:00
										 |  |  | 				; on incoming calls to Asterisk | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | ;host=192.168.0.23		; we have a static but private IP address | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | 				; No registration allowed | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | ;nat=no				; there is not NAT between phone and Asterisk | 
					
						
							|  |  |  | ;canreinvite=yes		; allow RTP voice traffic to bypass Asterisk | 
					
						
							|  |  |  | ;dtmfmode=info			; either RFC2833 or INFO for the BudgeTone | 
					
						
							| 
									
										
										
										
											2005-08-30 21:26:33 +00:00
										 |  |  | ;call-limit=1			; permit only 1 outgoing call and 1 incoming call at a time | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | 				; from the phone to asterisk | 
					
						
							| 
									
										
										
										
											2006-01-04 09:10:56 +00:00
										 |  |  | 				; 1 for the explicit peer, 1 for the explicit user, | 
					
						
							| 
									
										
										
										
											2005-08-30 21:26:33 +00:00
										 |  |  | 				; remember that a friend equals 1 peer and 1 user in | 
					
						
							| 
									
										
										
										
											2006-01-04 09:10:56 +00:00
										 |  |  | 				; memory | 
					
						
							|  |  |  | 				; This will affect your subscriptions as well. | 
					
						
							|  |  |  | 				; There is no combined call counter for a "friend" | 
					
						
							|  |  |  | 				; so there's currently no way in sip.conf to limit | 
					
						
							|  |  |  | 				; to one inbound or outbound call per phone. Use | 
					
						
							|  |  |  | 				; the group counters in the dial plan for that. | 
					
						
							|  |  |  | 				; | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;mailbox=1234@default		; mailbox 1234 in voicemail context "default" | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | ;disallow=all			; need to disallow=all before we can use allow= | 
					
						
							|  |  |  | ;allow=ulaw			; Note: In user sections the order of codecs | 
					
						
							|  |  |  | 				; listed with allow= does NOT matter! | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;allow=alaw | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | ;allow=g723.1			; Asterisk only supports g723.1 pass-thru! | 
					
						
							|  |  |  | ;allow=g729			; Pass-thru only unless g729 license obtained | 
					
						
							| 
									
										
										
										
											2006-01-20 14:32:30 +00:00
										 |  |  | ;callingpres=allowed_passed_screen	; Set caller ID presentation | 
					
						
							|  |  |  | 				; See README.callingpres for more information | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ;[xlite1] | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ; Turn off silence suppression in X-Lite ("Transmit Silence"=YES)! | 
					
						
							|  |  |  | ; Note that Xlite sends NAT keep-alive packets, so qualify=yes is not needed | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | ;type=friend | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;regexten=1234			; When they register, create extension 1234 | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;callerid="Jane Smith" <5678> | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;host=dynamic			; This device needs to register | 
					
						
							|  |  |  | ;nat=yes			; X-Lite is behind a NAT router | 
					
						
							|  |  |  | ;canreinvite=no			; Typically set to NO if behind NAT | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;disallow=all | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;allow=gsm			; GSM consumes far less bandwidth than ulaw | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;allow=ulaw | 
					
						
							|  |  |  | ;allow=alaw | 
					
						
							| 
									
										
										
										
											2005-10-04 19:05:40 +00:00
										 |  |  | ;mailbox=1234@default,1233@default	; Subscribe to status of multiple mailboxes | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ;[snom] | 
					
						
							|  |  |  | ;type=friend			; Friends place calls and receive calls | 
					
						
							|  |  |  | ;context=from-sip		; Context for incoming calls from this user | 
					
						
							|  |  |  | ;secret=blah | 
					
						
							| 
									
										
										
										
											2005-10-04 19:05:40 +00:00
										 |  |  | ;subscribecontext=localextensions	; Only allow SUBSCRIBE for local extensions | 
					
						
							| 
									
										
										
										
											2004-07-28 21:07:38 +00:00
										 |  |  | ;language=de			; Use German prompts for this user  | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;host=dynamic			; This peer register with us | 
					
						
							| 
									
										
										
										
											2006-02-10 16:33:47 +00:00
										 |  |  | ;dtmfmode=inband		; Choices are inband, rfc2833, or info | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;defaultip=192.168.0.59		; IP used until peer registers | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;mailbox=1234@context,2345      ; Mailbox(-es) for message waiting indicator | 
					
						
							| 
									
										
										
										
											2006-03-28 04:21:21 +00:00
										 |  |  | ;subscribemwi=yes		; Only send notifications if this phone  | 
					
						
							|  |  |  | 				; subscribes for mailbox notification | 
					
						
							| 
									
										
										
										
											2006-02-28 21:04:17 +00:00
										 |  |  | ;vmexten=voicemail		; dialplan extension to reach mailbox  | 
					
						
							|  |  |  | 				; sets the Message-Account in the MWI notify message | 
					
						
							|  |  |  | 				; defaults to global vmexten which defaults to "asterisk" | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;disallow=all | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;allow=ulaw			; dtmfmode=inband only works with ulaw or alaw! | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-01-04 05:13:32 +00:00
										 |  |  | ;[polycom] | 
					
						
							|  |  |  | ;type=friend			; Friends place calls and receive calls | 
					
						
							|  |  |  | ;context=from-sip		; Context for incoming calls from this user | 
					
						
							|  |  |  | ;secret=blahpoly | 
					
						
							|  |  |  | ;host=dynamic			; This peer register with us | 
					
						
							| 
									
										
										
										
											2006-02-10 16:33:47 +00:00
										 |  |  | ;dtmfmode=rfc2833		; Choices are inband, rfc2833, or info | 
					
						
							| 
									
										
										
										
											2005-01-04 05:13:32 +00:00
										 |  |  | ;username=polly			; Username to use in INVITE until peer registers | 
					
						
							| 
									
										
										
										
											2005-10-04 19:05:40 +00:00
										 |  |  | 				; Normally you do NOT need to set this parameter | 
					
						
							| 
									
										
										
										
											2005-01-04 05:13:32 +00:00
										 |  |  | ;disallow=all | 
					
						
							|  |  |  | ;allow=ulaw                     ; dtmfmode=inband only works with ulaw or alaw! | 
					
						
							|  |  |  | ;progressinband=no		; Polycom phones don't work properly with "never" | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | ;[pingtel] | 
					
						
							|  |  |  | ;type=friend | 
					
						
							|  |  |  | ;secret=blah | 
					
						
							|  |  |  | ;host=dynamic | 
					
						
							| 
									
										
										
										
											2006-04-06 15:23:14 +00:00
										 |  |  | ;insecure=port			; Allow matching of peer by IP address without  | 
					
						
							|  |  |  | 				; matching port number | 
					
						
							| 
									
										
										
										
											2005-04-27 17:04:17 +00:00
										 |  |  | ;insecure=invite		; Do not require authentication of incoming INVITEs | 
					
						
							|  |  |  | ;insecure=port,invite		; (both) | 
					
						
							| 
									
										
										
										
											2003-03-17 06:00:16 +00:00
										 |  |  | ;qualify=1000			; Consider it down if it's 1 second to reply | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | 				; Helps with NAT session | 
					
						
							|  |  |  | 				; qualify=yes uses default value | 
					
						
							| 
									
										
										
										
											2006-04-28 16:42:42 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; Call group and Pickup group should be in the range from 0 to 63 | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;callgroup=1,3-4		; We are in caller groups 1,3,4 | 
					
						
							|  |  |  | ;pickupgroup=1,3-5		; We can do call pick-p for call group 1,3,4,5 | 
					
						
							| 
									
										
										
										
											2006-09-11 16:41:49 +00:00
										 |  |  | ;defaultip=192.168.0.60		; IP address to use if peer has not registered | 
					
						
							| 
									
										
										
										
											2006-06-26 18:34:29 +00:00
										 |  |  | ;deny=0.0.0.0/0.0.0.0		; ACL: Control access to this account based on IP address | 
					
						
							| 
									
										
										
										
											2006-06-26 16:24:43 +00:00
										 |  |  | ;permit=192.168.0.60/255.255.255.0 | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;[cisco1] | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | ;type=friend | 
					
						
							|  |  |  | ;secret=blah | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | ;qualify=200			; Qualify peer is no more than 200ms away | 
					
						
							| 
									
										
										
										
											2003-03-10 06:00:17 +00:00
										 |  |  | ;nat=yes			; This phone may be natted | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | 				; Send SIP and RTP to the IP address that packet is  | 
					
						
							| 
									
										
										
										
											2004-05-24 15:09:34 +00:00
										 |  |  | 				; received from instead of trusting SIP headers  | 
					
						
							|  |  |  | ;host=dynamic			; This device registers with us | 
					
						
							| 
									
										
										
										
											2004-03-19 20:30:03 +00:00
										 |  |  | ;canreinvite=no			; Asterisk by default tries to redirect the | 
					
						
							|  |  |  | 				; RTP media stream (audio) to go directly from | 
					
						
							|  |  |  | 				; the caller to the callee.  Some devices do not | 
					
						
							|  |  |  | 				; support this (especially if one of them is  | 
					
						
							| 
									
										
										
										
											2004-03-19 21:29:13 +00:00
										 |  |  | 				; behind a NAT). | 
					
						
							| 
									
										
										
										
											2005-01-09 18:05:41 +00:00
										 |  |  | ;defaultip=192.168.0.4		; IP address to use until registration | 
					
						
							|  |  |  | ;username=goran			; Username to use when calling this device before registration | 
					
						
							| 
									
										
										
										
											2005-10-04 19:05:40 +00:00
										 |  |  | 				; Normally you do NOT need to set this parameter | 
					
						
							|  |  |  | ;setvar=CUSTID=5678		; Channel variable to be set for all calls from this device | 
					
						
							| 
									
										
										
										
											2002-06-16 16:06:38 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-08-31 01:59:02 +00:00
										 |  |  | ;[pre14-asterisk] | 
					
						
							|  |  |  | ;type=friend | 
					
						
							|  |  |  | ;secret=digium | 
					
						
							|  |  |  | ;host=dynamic | 
					
						
							|  |  |  | ;rfc2833compensate=yes		; Compensate for pre-1.4 DTMF transmission from another Asterisk machine. | 
					
						
							|  |  |  | 				; You must have this turned on or DTMF reception will work improperly. |