dundi.conf 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239
  1. ;
  2. ; DUNDi configuration file
  3. ;
  4. ; For more information about DUNDi, see http://www.dundi.com
  5. ;
  6. ;
  7. [general]
  8. ;
  9. ; The "general" section contains general parameters relating
  10. ; to the operation of the dundi client and server.
  11. ;
  12. ; The first part should be your complete contact information
  13. ; should someone else in your peer group need to contact you.
  14. ;
  15. ;department=Your Department
  16. ;organization=Your Company, Inc.
  17. ;locality=Your City
  18. ;stateprov=ST
  19. ;country=US
  20. ;email=your@email.com
  21. ;phone=+12565551212
  22. ;
  23. ;
  24. ; Specify bind address and port number. Default is
  25. ; 4520
  26. ;
  27. ;bindaddr=0.0.0.0
  28. ;port=4520
  29. ;
  30. ; Our entity identifier (Should generally be the MAC address of the
  31. ; machine it's running on. Defaults to the first eth address, but you
  32. ; can override it here, as long as you set it to the MAC of *something*
  33. ; you own!)
  34. ;
  35. ;entityid=00:07:E9:3B:76:60
  36. ;
  37. ; Peers shall cache our query responses for the specified time,
  38. ; given in seconds. Default is 3600.
  39. ;
  40. ;cachetime=3600
  41. ;
  42. ; This defines the max depth in which to search the DUNDi system.
  43. ; Note that the maximum time that we will wait for a response is
  44. ; (2000 + 200 * ttl) ms.
  45. ;
  46. ttl=32
  47. ;
  48. ; If we don't get ACK to our DPDISCOVER within 2000ms, and autokill is set
  49. ; to yes, then we cancel the whole thing (that's enough time for one
  50. ; retransmission only). This is used to keep things from stalling for a long
  51. ; time for a host that is not available, but would be ill advised for bad
  52. ; connections. In addition to 'yes' or 'no' you can also specify a number
  53. ; of milliseconds. See 'qualify' for individual peers to turn on for just
  54. ; a specific peer.
  55. ;
  56. autokill=yes
  57. ;
  58. ; pbx_dundi creates a rotating key called "secret", under the family
  59. ; 'secretpath'. The default family is dundi (resulting in
  60. ; the key being held at dundi/secret).
  61. ;
  62. ;secretpath=dundi
  63. ;
  64. ; The 'storehistory' option (also changeable at runtime with
  65. ; 'dundi store history' and 'dundi no store history') will
  66. ; cause the DUNDi engine to keep track of the last several
  67. ; queries and the amount of time each query took to execute
  68. ; for the purpose of tracking slow nodes. This option is
  69. ; off by default due to performance impacts.
  70. ;
  71. ;storehistory=yes
  72. [mappings]
  73. ;
  74. ; The "mappings" section maps DUNDi contexts
  75. ; to contexts on the local asterisk system. Remember
  76. ; that numbers that are made available under the e164
  77. ; DUNDi context are regulated by the DUNDi General Peering
  78. ; Agreement (GPA) if you are a member of the DUNDi E.164
  79. ; Peering System.
  80. ;
  81. ; dundi_context => local_context,weight,tech,dest[,options]]
  82. ;
  83. ; 'dundi_context' is the name of the context being requested
  84. ; within the DUNDi request
  85. ;
  86. ; 'local_context' is the name of the context on the local system
  87. ; in which numbers can be looked up for which responses shall be given.
  88. ;
  89. ; 'weight' is the weight to use for the responses provided from this
  90. ; mapping. The number must be >= 0 and < 60000. Since it is totally
  91. ; valid to receive multiple responses to a query, responses received
  92. ; with a lower weight are tried first. Note that the weight has a
  93. ; special meaning in the e164 context - see the GPA for more details.
  94. ;
  95. ; 'tech' is the technology to use (IAX, SIP, H323)
  96. ;
  97. ; 'dest' is the destination to supply for reaching that number. The
  98. ; following variables can be used in the destination string and will
  99. ; be automatically substituted:
  100. ; ${NUMBER}: The number being requested
  101. ; ${IPADDR}: The IP address to connect to
  102. ; ${SECRET}: The current rotating secret key to be used
  103. ;
  104. ; Further options may include:
  105. ;
  106. ; nounsolicited: No unsolicited calls of any type permitted via this
  107. ; route
  108. ; nocomunsolicit: No commercial unsolicited calls permitted via
  109. ; this route
  110. ; residential: This number is known to be a residence
  111. ; commercial: This number is known to be a business
  112. ; mobile: This number is known to be a mobile phone
  113. ; nocomunsolicit: No commercial unsolicited calls permitted via
  114. ; this route
  115. ; nopartial: Do not search for partial matches
  116. ;
  117. ; There *must* exist an entry in mappings for DUNDi to respond
  118. ; to any request, although it may be empty.
  119. ;
  120. ;e164 => dundi-e164-canonical,0,IAX2,dundi:${SECRET}@${IPADDR}/${NUMBER},nounsolicited,nocomunsolicit,nopartial
  121. ;e164 => dundi-e164-customers,100,IAX2,dundi:${SECRET}@${IPADDR}/${NUMBER},nounsolicited,nocomunsolicit,nopartial
  122. ;e164 => dundi-e164-via-pstn,400,IAX2,dundi:${SECRET}@${IPADDR}/${NUMBER},nounsolicited,nocomunsolicit,nopartial
  123. ;digexten => default,0,IAX2,guest@lappy/${NUMBER}
  124. ;asdf =>
  125. ;
  126. ;
  127. ; The remaining sections represent the peers
  128. ; that we fundamentally trust. The section name
  129. ; represents the name and optionally at a specific
  130. ; DUNDi context if you want the trust to be established
  131. ; for only a specific DUNDi context.
  132. ;
  133. ; inkey - What key they will be authenticating to us with
  134. ;
  135. ; outkey - What key we use to authenticate to them
  136. ;
  137. ; host - What their host is
  138. ;
  139. ; order - What search order to use. May be 'primary', 'secondary',
  140. ; 'tertiary' or 'quartiary'. In large systems, it is beneficial
  141. ; to only query one up-stream host in order to maximize caching
  142. ; value. Adding one with primary and one with secondary gives you
  143. ; redundancy without sacrificing performance.
  144. ;
  145. ; include - Includes this peer when searching a particular context
  146. ; for lookup (set "all" to perform all lookups with that
  147. ; host. This is also the context in which peers are permitted
  148. ; to precache.
  149. ;
  150. ; noinclude - Disincludes this peer when searching a particular context
  151. ; for lookup (set "all" to perform no lookups with that
  152. ; host.
  153. ;
  154. ; permit - Permits this peer to search a given DUNDi context on
  155. ; the local system. Set "all" to permit this host to
  156. ; lookup all contexts. This is also a context for which
  157. ; we will create/forward PRECACHE commands.
  158. ;
  159. ; deny - Denies this peer to search a given DUNDi context on
  160. ; the local system. Set "all" to deny this host to
  161. ; lookup all contexts.
  162. ;
  163. ; model - inbound, outbound, or symmetric for whether we receive
  164. ; requests only, transmit requests only, or do both.
  165. ;
  166. ; precache - Utilize/Permit precaching with this peer (to pre
  167. ; cache means to provide an answer when no request
  168. ; was made and is used so that machines with few
  169. ; routes can push those routes up a to a higher level).
  170. ; outgoing means we send precache routes to this peer,
  171. ; incoming means we permit this peer to send us
  172. ; precache routes. symmetric means we do both.
  173. ;
  174. ; Note: You cannot mix symmetric/outbound model with symmetric/inbound
  175. ; precache, nor can you mix symmetric/inbound model with symmetric/outbound
  176. ; precache.
  177. ;
  178. ;
  179. ; The '*' peer is special and matches an unspecified entity
  180. ;
  181. ;
  182. ; Sample Primary e164 DUNDi peer
  183. ;
  184. ;[00:50:8B:F3:75:BB]
  185. ;model = symmetric
  186. ;host = 64.215.96.114
  187. ;inkey = digium
  188. ;outkey = misery
  189. ;include = e164
  190. ;permit = e164
  191. ;qualify = yes
  192. ;
  193. ; Sample Secondary e164 DUNDi peer
  194. ;
  195. ;[00:A0:C9:96:92:84]
  196. ;model = symmetric
  197. ;host = misery.digium.com
  198. ;inkey = misery
  199. ;outkey = ourkey
  200. ;include = e164
  201. ;permit = e164
  202. ;qualify = yes
  203. ;order = secondary
  204. ;
  205. ; Sample "push mode" downstream host
  206. ;
  207. ;[00:0C:76:96:75:28]
  208. ;model = inbound
  209. ;host = dynamic
  210. ;precache = inbound
  211. ;inkey = littleguy
  212. ;outkey = ourkey
  213. ;include = e164 ; In this case used only for precaching
  214. ;permit = e164
  215. ;qualify = yes
  216. ;
  217. ; Sample "push mode" upstream host
  218. ;
  219. ;[00:07:E9:3B:76:60]
  220. ;model = outbound
  221. ;precache = outbound
  222. ;host = 216.207.245.34
  223. ;register = yes
  224. ;inkey = dhcp34
  225. ;permit = all ; In this case used only for precaching
  226. ;include = all
  227. ;qualify = yes
  228. ;outkey=foo
  229. ;[*]
  230. ;