requestFilter element

Applies to: Lync 2013 Preview | Lync Server 2013 | Lync Server 2013 Preview

requestFilter element

Specifies which requests the server passes to the application.

Syntax

<lc:requestFilter
   methodNames="ALL" | "NONE" | "METHOD_NAME [, METHOD_NAME, ...]"
   registrarGenerated="true" | "false"
   strictRoute="true" | "false"
   domainSupported="true" | "false"
   phoneUri="URI"
/>

Attributes

methodNames

Specifies the type(s) of SIP request methods that are passed to the application. The value can be ALL, NONE, or a comma-separated list of method names as indicated in the following table. The default value is ALL.

Value

Description

ALL

Specifies that all SIP request methods (including custom request methods defined for the SIP application) are passed to the application.

NONE

Specifies that no SIP request methods are passed to the application.

(comma-separated list of method names)

The method name list can include one or more of the following: ACK, BENOTIFY, BYE, INFO, INVITE, MESSAGE, NOTIFY, OPTIONS, OTHER, REFER, REGISTER, SERVICE, SUBSCRIBE.

OTHER indicates that custom request methods defined for the SIP application infrastructure should be filtered.

Note

NONE and ALL are mutually exclusive with each other, and with the specific method types. They must not be present in any comma-separated list of methods.

registrarGenerated

Specifies whether requests that are generated by the endpoint service are passed to the application. Valid values are true and false. The default value is false.

strictRoute

Specifies whether requests that have a strict (fixed) route are passed to the application (in addition to other requests). Valid values are true and false. The default value is false.

A request is treated as a strict route if one or more of the following conditions is true:

  • The request URI has the maddr parameter.

  • The request had a Route header that pointed to the local server when it arrived, meaning that the request already has destination set in the request-uri in compliance with RFC 3261.

  • The request has one or more Route headers at the time of processing.

  • A previous application supplied route information by setting the request-uri.

Set strictRoute to true if you want the application to receive all messages. Setting the strictRoute filter to false guarantees that only requests that need routing will be delivered.

Route headers can be deleted by the managed application before proxying.

domainSupported

Specifies whether requests from domains that are supported by the local register are passed to the application. Valid values are true and false. The default value is true.

phoneUri

Indicates that the request is for a phone URI. If present, the server passes the value of the phoneUri attribute to the application.

Child elements

None.

Parent element

applicationManifest element

Remarks

If a request is filtered by the server, then any responses to that request will likewise be filtered. The namespace prefix "lc" in the preceding usage example is the default namespace prefix, but it can be replaced with any string value that you assign to your namespace using the xmlns attribute of the applicationManifest element.

See also

Other resources

SIP application manifests

Application attribute elements

SIP application manifest example