res_rtp_asterisk: Add ice_blacklist option
[asterisk/asterisk.git] / configs / samples / rtp.conf.sample
1 ;
2 ; RTP Configuration
3 ;
4 [general]
5 ;
6 ; RTP start and RTP end configure start and end addresses
7 ;
8 ; Defaults are rtpstart=5000 and rtpend=31000
9 ;
10 rtpstart=10000
11 rtpend=20000
12 ;
13 ; Whether to enable or disable UDP checksums on RTP traffic
14 ;
15 ;rtpchecksums=no
16 ;
17 ; The amount of time a DTMF digit with no 'end' marker should be
18 ; allowed to continue (in 'samples', 1/8000 of a second)
19 ;
20 ;dtmftimeout=3000
21 ; rtcpinterval = 5000   ; Milliseconds between rtcp reports
22                         ;(min 500, max 60000, default 5000)
23 ;
24 ; Enable strict RTP protection. This will drop RTP packets that
25 ; do not come from the source of the RTP stream. This option is
26 ; enabled by default.
27 ; strictrtp=yes
28 ;
29 ; Number of packets containing consecutive sequence values needed
30 ; to change the RTP source socket address. This option only comes
31 ; into play while using strictrtp=yes. Consider changing this value
32 ; if rtp packets are dropped from one or both ends after a call is
33 ; connected. This option is set to 4 by default.
34 ; probation=8
35 ;
36 ; Whether to enable or disable ICE support. This option is disabled by default.
37 ; icesupport=true
38 ;
39 ; Hostname or address for the STUN server used when determining the external
40 ; IP address and port an RTP session can be reached at. The port number is
41 ; optional. If omitted the default value of 3478 will be used. This option is
42 ; disabled by default.
43 ;
44 ; e.g. stundaddr=mystun.server.com:3478
45 ;
46 ; stunaddr=
47 ;
48 ; Hostname or address for the TURN server to be used as a relay. The port
49 ; number is optional. If omitted the default value of 3478 will be used.
50 ; This option is disabled by default.
51 ;
52 ; e.g. turnaddr=myturn.server.com:34780
53 ;
54 ; turnaddr=
55 ;
56 ; Username used to authenticate with TURN relay server.
57 ; turnusername=
58 ;
59 ; Password used to authenticate with TURN relay server.
60 ; turnpassword=
61 ;
62 ; Subnets to exclude from ICE host, srflx and relay discovery. This is useful
63 ; to optimize the ICE process where a system has multiple host address ranges
64 ; and/or physical interfaces and certain of them are not expected to be used
65 ; for RTP. For example, VPNs and local interconnections may not be suitable or
66 ; necessary for ICE. Multiple subnets may be listed. If left unconfigured,
67 ; all discovered host addresses are used.
68 ;
69 ; e.g. ice_blacklist = 192.168.1.0/255.255.255.0
70 ;      ice_blacklist = 10.32.77.0/255.255.255.0
71 ;
72 ; ice_blacklist =
73 ;
74 [ice_host_candidates]
75 ;
76 ; When Asterisk is behind a static one-to-one NAT and ICE is in use, ICE will
77 ; expose the server's internal IP address as one of the host candidates.
78 ; Although using STUN (see the 'stunaddr' configuration option) will provide a
79 ; publicly accessible IP, the internal IP will still be sent to the remote
80 ; peer. To help hide the topology of your internal network, you can override
81 ; the host candidates that Asterisk will send to the remote peer.
82 ;
83 ; IMPORTANT: Only use this functionality when your Asterisk server is behind a
84 ; one-to-one NAT and you know what you're doing. If you do define anything
85 ; here, you almost certainly will NOT want to specify 'stunaddr' or 'turnaddr'
86 ; above.
87 ;
88 ; The format for these overrides is:
89 ;
90 ;    <local address> => <advertised address>
91 ;
92 ; The following will replace 192.168.1.10 with 1.2.3.4 during ICE
93 ; negotiation:
94 ;
95 ;192.168.1.10 => 1.2.3.4
96 ;
97 ; You can define an override for more than 1 interface if you have a multihomed
98 ; server. Any local interface that is not matched will be passed through
99 ; unaltered. Both IPv4 and IPv6 addresses are supported.