SIP query for CNAM and LNP - Revision history

Monica: /* Configuration file */

2013-11-04T10:31:25Z

‎Configuration file

Monica: /* Configuration file */

2013-11-04T09:03:49Z

‎Configuration file

Dana at 11:02, 31 May 2013

2013-05-31T11:02:39Z

Monica at 14:27, 12 November 2012

2012-11-12T14:27:39Z

Monica at 14:26, 12 November 2012

2012-11-12T14:26:34Z

Dana at 10:06, 6 November 2012

2012-11-06T10:06:43Z

Dana at 13:44, 18 October 2012

2012-10-18T13:44:46Z

Dana: Created page with " This routing module allows querying Caller Name and Local Number Portability databases over the SIP protocol. For each of the queries an INVITE without media is sent to ..."

2012-10-18T13:41:54Z

Created page with " This routing module allows querying Caller Name and Local Number Portability databases over the SIP protocol. For each of the queries an INVITE without media is sent to ..."

New page

This routing module allows querying [[Caller Name]] and Local Number Portability databases over the SIP protocol.

For each of the queries an INVITE without media is sent to the designated server. From the SIP answer (which is supposed to be a 3xx Redirect) the information is extracted according to the query type.

Parameters of the actual call are substituted in the template from the config file. This allows flexibility in how queries are performed.

'''IMPORTANT:''' This feature module is not loaded automatically, it needs a line in yate.conf:
[postload]
${modulepath}/sip/sip_cnam_lnp${modsuffix}=yes

===CNAM Message parameters===

On [[call.preroute]] the module performs CNAM queries.

Input parameters:

* caller - required, must be in E.164 format to perform the query
* callername - if set (even empty) a query is not performed unless overridden
* querycnam - overrides the automatic decision if a query is to be made

Output parameters:

* callername - set from answer if query succeeds and returns a non-empty string
* querycnam - set to false if the query succeeds

===LNP Message parameters===

The LNP query is performed on the [[call.route]] message.

Input parameters:

* called - required, must be in E.164 format to perform the query
* npdi - if true a query is not performed unless overridden
* querylnp - overrides the automatic decision if a query is to be made

Output parameters:

* routing - set to the Routing Number from answer if query succeeds and rn=... is present
* npdi - set to true or false depending how npdi is set or present in answer
* querylnp - set to false if the query succeeds

===Configuration===

File sip_cnam_lnp.conf :

; IMPORTANT!
; This feature module is not loaded automatically, it needs a line in yate.conf:
; [postload]
; ${modulepath}/sip/sip_cnam_lnp${modsuffix}=yes

[priorities]
; These settings that are read only at first initialization!

; Sets the priorities for installing relevant message handlers

; call.preroute: int: Priority of the call.preroute handler
; Should be set between 10 and 90
;call.preroute=50

; call.route: int: Priority of the call.route handler
; Should be set between 10 and 90
;call.route=50

[cnam]
; Controls how CNAM queries are performed, a SIP 3xx answer is expected
; CNAM is taken from the description of P-Asserted-Identity URI
; Query is performed on call.preroute when callername is missing and caller is E.164
; Parameters modified: callername, querycnam

; Actual call parameters ${...} are substituted in the strings

; callto: string: Template for the resource of the CNAM request
; This parameter is required for CNAM functionality
; Example: callto=sip/sip:${caller}@10.0.0.1
;callto=

; caller: string: Template for the caller party number of the request
; It should not be modified
;caller=${caller}

; called: string: Template for the called party number of the request
; It can be used to force anonymous requests
;called=${called}

; timeout: int: Overall timeout of the SIP request in milliseconds
; It is limited to range 1000-30000 (1s to 30s)
;timeout=5000

; flags: int: Miscellaneous flags for the SIP messages
; A value of -1 will use the SIP channel defaults
;flags=-1

[lnp]
; Controls how LNP queries are performed, a SIP 3xx answer is expected
; Routing Number and NPDI are taken from the Contact URI
; Query is performed on call.route when npdi is not true
; Parameters modified: routing, npdi, querylnp

; Actual call parameters ${...} are substituted in the strings

; callto: string: Template for the resource of the LNP request
; This parameter is required for LNP functionality
; Example: callto=sip/sip:${called}@10.0.0.2
;callto=

; caller: string: Template for the caller party number of the request
; It can be used to force anonymous requests
;caller=${caller}

; called: string: Template for the called party number of the request
; It should not be modified
;called=${called}

; timeout: int: Overall timeout of the SIP request in milliseconds
; It is limited to range 1000-30000 (1s to 30s)
;timeout=5000

; flags: int: Miscellaneous flags for the SIP messages
; A value of -1 will use the SIP channel defaults
;flags=-1

← Older revision		Revision as of 10:31, 4 November 2013
Line 135:		Line 135:
	* [[Telephony]]		* [[Telephony]]

−	[[Category:SIP]] [[Category:CNAM]] [[Category:LNP]]	+	[[Category:SIP]] [[Category:CNAM]] [[Category:LNP]] [[Category:Routing]]

← Older revision		Revision as of 09:03, 4 November 2013
Line 134:		Line 134:
	* [http://en.wikipedia.org/wiki/Local_number_portability Local Number Portability]		* [http://en.wikipedia.org/wiki/Local_number_portability Local Number Portability]
	* [[Telephony]]		* [[Telephony]]
		+
		+	[[Category:SIP]] [[Category:CNAM]] [[Category:LNP]]

@@ Line 131: / Line 131: @@
 '''See also'''
-*[http://en.wikipedia.org/wiki/Caller_id Caller Name]
+* [http://en.wikipedia.org/wiki/Caller_id Caller Name]
-*[http://en.wikipedia.org/wiki/Local_number_portability Local Number Portability]
+* [http://en.wikipedia.org/wiki/Local_number_portability Local Number Portability]

← Older revision		Revision as of 14:27, 12 November 2012
Line 127:		Line 127:
	; A value of -1 will use the SIP channel defaults		; A value of -1 will use the SIP channel defaults
	;flags=-1		;flags=-1
		+
		+
		+	'''See also'''
		+
		+	*[http://en.wikipedia.org/wiki/Caller_id Caller Name]
		+	*[http://en.wikipedia.org/wiki/Local_number_portability Local Number Portability]

@@ Line 41: / Line 41: @@
 * ''querylnp'' - set to false if the query succeeds
-===Configuration===
+===Configuration file===
 File sip_cnam_lnp.conf :

@@ Line 1: / Line 1: @@
-This routing module allows querying [[Caller Name]] and Local Number Portability databases over the SIP protocol.
+This routing module allows querying [http://en.wikipedia.org/wiki/Caller_id|Caller Name] and [http://en.wikipedia.org/wiki/Local_number_portability Local Number Portability] databases over the SIP protocol.
 For each of the queries an INVITE without media is sent to the designated server. From the SIP answer (which is supposed to be a 3xx Redirect) the information is extracted according to the query type.
@@ Line 16: / Line 16: @@
 Input parameters:
-* caller - required, must be in E.164 format to perform the query
+* ''caller'' - required, must be in E.164 format to perform the query
-* callername - if set (even empty) a query is not performed unless overridden
+* ''callername'' - if set (even empty) a query is not performed unless overridden
-* querycnam - overrides the automatic decision if a query is to be made
+* ''querycnam'' - overrides the automatic decision if a query is to be made
 Output parameters:
-* callername - set from answer if query succeeds and returns a non-empty string
+* ''callername'' - set from answer if query succeeds and returns a non-empty string
-* querycnam - set to false if the query succeeds
+* ''querycnam'' - set to false if the query succeeds
 ===LNP Message parameters===
@@ Line 31: / Line 31: @@
 Input parameters:
-* called - required, must be in E.164 format to perform the query
+* ''called'' - required, must be in E.164 format to perform the query
-* npdi - if true a query is not performed unless overridden
+* ''npdi'' - if true a query is not performed unless overridden
-* querylnp - overrides the automatic decision if a query is to be made
+* ''querylnp'' - overrides the automatic decision if a query is to be made
 Output parameters:
-* routing - set to the Routing Number from answer if query succeeds and rn=... is present
+* ''routing'' - set to the Routing Number from answer if query succeeds and rn=... is present
-* npdi - set to true or false depending how npdi is set or present in answer
+* ''npdi'' - set to true or false depending how npdi is set or present in answer
-* querylnp - set to false if the query succeeds
+* ''querylnp'' - set to false if the query succeeds
 ===Configuration===