Sip Proxy

This extension may be referenced by the qualified name envoy.filters.network.sip_proxy

Note

This extension is only available in contrib images.

Note

This extension is functional but has not had substantial production burn time, use only with this caveat.

This extension is not hardened and should only be used in deployments where both the downstream and upstream are trusted.

Tip

This extension extends and can be used with the following extension category:

• envoy.filters.network

extensions.filters.network.sip_proxy.v3alpha.SipProxy

[extensions.filters.network.sip_proxy.v3alpha.SipProxy proto]

{
  "stat_prefix": "...",
  "route_config": "{...}",
  "sip_filters": [],
  "settings": "{...}"
}

stat_prefix

(string, REQUIRED) The human readable prefix to use when emitting statistics.

route_config

(extensions.filters.network.sip_proxy.v3alpha.RouteConfiguration) The route table for the connection manager is static and is specified in this property.

sip_filters

(repeated extensions.filters.network.sip_proxy.v3alpha.SipFilter) A list of individual Sip filters that make up the filter chain for requests made to the Sip proxy. Order matters as the filters are processed sequentially. For backwards compatibility, if no sip_filters are specified, a default Sip router filter (envoy.filters.sip.router) is used.

Tip

The following extensions are available in contrib images only:

• envoy.filters.sip.router

settings

(extensions.filters.network.sip_proxy.v3alpha.SipProxy.SipSettings)

extensions.filters.network.sip_proxy.v3alpha.SipProxy.SipSettings

[extensions.filters.network.sip_proxy.v3alpha.SipProxy.SipSettings proto]

{
  "transaction_timeout": "{...}",
  "own_domain": "...",
  "domain_match_parameter_name": "..."
}

transaction_timeout

(Duration) transaction timeout timer [Timer B] unit is milliseconds, default value 64*T1.

Session Initiation Protocol (SIP) timer summary

own_domain

(string) own domain name

domain_match_parameter_name

(string) points to domain match with own_domain

extensions.filters.network.sip_proxy.v3alpha.SipFilter

[extensions.filters.network.sip_proxy.v3alpha.SipFilter proto]

SipFilter configures a Sip filter.

{
  "name": "...",
  "typed_config": "{...}"
}

name

(string, REQUIRED) The name of the filter to instantiate. The name must match a supported filter. The built-in filters are:

typed_config

(Any) Filter specific configuration which depends on the filter being instantiated. See the supported filters for further documentation.

extensions.filters.network.sip_proxy.v3alpha.SipProtocolOptions

[extensions.filters.network.sip_proxy.v3alpha.SipProtocolOptions proto]

SipProtocolOptions specifies Sip upstream protocol options. This object is used in typed_extension_protocol_options, keyed by the name envoy.filters.network.sip_proxy.

{
  "session_affinity": "...",
  "registration_affinity": "..."
}

session_affinity

(bool) All sip messages in one dialog should go to the same endpoint.

registration_affinity

(bool) The Register with Authorization header should go to the same endpoint which send out the 401 Unauthorized.