Reference12r1:Gateway/Interfaces/SIP: Difference between revisions
Line 73: | Line 73: | ||
|valign=top nowrap=true|'''Identity Header when Sending INVITE''' | |valign=top nowrap=true|'''Identity Header when Sending INVITE''' | ||
|Controls the identity header (P-Preferred-Identity, P-Asserted-Identity and Remote-Party-Id) sent on outgoing calls | |Controls the identity header (P-Preferred-Identity, P-Asserted-Identity and Remote-Party-Id) sent on outgoing calls | ||
*'''CGPN in user part of URI''': Variable | *'''CGPN in user part of URI''': Variable Identity-URI with actual calling party number | ||
*'''Fixed AOR''': Fixed AOR is used as Identity-URI regardless of the actual calling party number | *'''Fixed AOR''': Fixed AOR is used as Identity-URI regardless of the actual calling party number | ||
*'''UUI''': the relayed call must include ''user-to-user-info'' (UUI). This UUI is uses as Identity-URI. In the UUI, the string <code>{initiator}</code> is replaced by the the call's ''diversion-info'' (a.k.a. ''leg-2-info'') if available or the calling party number otherwise | *'''UUI''': the relayed call must include ''user-to-user-info'' (UUI). This UUI is uses as Identity-URI. In the UUI, the string <code>{initiator}</code> is replaced by the the call's ''diversion-info'' (a.k.a. ''leg-2-info'') if available or the calling party number otherwise |
Revision as of 12:05, 31 May 2017
SIP Registration section
The entry fields for a SIP registration are:
Name | Descriptive name for this registration. |
Disable | A switch to temporarily disable this interface without deleting the configuration. |
Type |
|
AOR | Address of Record: SIP-URI used to register. Enter the registration ID followed by the SIP provider domain name (for example 8111111e0@sipgate.de). |
Local Domain | The Local Domain for SIP Federation enables to select the TLS Certificate according to the Domain Name. On the incoming SIP calls the host part of the URI is removed if equals with the Local Domain configured here, and the user part is used as Name (H323-ID) or Number (E164). |
Local Port | The Local Port that differs from default port 5060 (or 5061 for SIP over TLS) can be configured here for SIP signalling. |
Proxy | DNS name or IP address of the SIP proxy where SIP messages (REGISTER,INVITE,etc) are to be sent to. Proxy can be omitted if domain part of AOR can be used as remote signaling destination. |
STUN Server | The STUN servers to use. See Reference12r1:IP4/General/STUN for details regarding the format. |
Authorization
Username and password for authorization. Username can be omitted if equal to userpart of AOR.
SIP Interop Tweaks
Proposed Registration Interval | Set in seconds, default is 120 seconds |
Accept INVITE's from Anywhere | If disabled, registered interfaces will reject INVITE's not coming from the SIP server with "305 Use Proxy". |
Enforce Sending Complete | Affects handling of "484 Address Incomplete" responses. If enabled and "484 Address Incomplete" is received, the call is cleared. If not enabled and "484 Address Incomplete" is received, the call is retained and re-initiated in case of new dialing digits. |
No Video | Removes Video Capabilities from outgoing media offer. |
To Header when Sending INVITE | Affects only outgoing diverted calls . Called Party: If set we write CDPN into To header of outgoing INVITE (and DGPN into History-Info header). Original Called Party: If set we write the DGPN into To header of outgoing INVITE (and CDPN into Request-URI). |
From Header when Sending INVITE | Controls the local URI (From header) of outgoing calls. Applys to registered interfaces only. Fixed AOR: Fixed AOR is used as From-URI regardless of the actual calling party number. AOR with CGPN as Display: Fixed AOR is used as From-URI and calling party number is added as display string. CGPN in user part of URI: Variable From-URI with actual calling party number. |
Identity Header when Sending INVITE | Controls the identity header (P-Preferred-Identity, P-Asserted-Identity and Remote-Party-Id) sent on outgoing calls
|
Reliability of Provisional Responses | Controls the support of PRACK (RFC-3262). Supported: Supported as optional extension. Required: Required as mandatory extension. Disabled: Hide support for PRACK extension. |
Advanced | Allows the configuration of additional, not further documented, interop tweaks(e.g. /pai on). The same tweaks can be configured also globally(i.e. not for this SIP-Interface) at the SIP(or TSIP/SIPS)-module. Any tweaks configured at the SIP-Interface will overwrite globally configured tweaks. |
More frequently used Advanced Parameters
There are some options which influence the stack behaviour to handle ambiguities in the SIP standard:
- /pai on
- send identity URI in
P-Asserted-Identity
header. By default, it is sent in theP-Asserted-Identity
header for calls from the PBX to the endpoint, in theP-Preferred-Identity
header otherwise - /ppi on
- send identity URI in
P-Preferred-Identity
header
Other options are available which instruct the stack to use non-standard or deprecated behaviour. Note that this should only be used in rare cases. Better have the vendor of your 3rd party SIP equipment fix its stack implementation:
- /send-deprecated-diversion-header on
- send call history information in the deprecated
Diversion
header instead of theHistory-Info
header - /single-audio-description
- don't send SAVP+AVP, but SAVP or AVP media description in SDP
- /disable-digest-replay-check on
- disables safeguard against replay attacks
- /no-authentication-info
- don't send
Authentication-Info
header in REGISTER response - /take-sendonly-as-inactive on
- some endpoints use sendonly instead of inactive
- /take-zero-addr-for-hold
- some endpoints use a null IP address (such as in
c=IN IP4 0.0.0.0
) as request for hold in SDP - /x-ice-disabled
- don't offer ICE candidates in SDP
Media Properties
The configuration of the media properties is evaluated for calls from/to this interface to/from a physical (ISDN, analog, TEST, ...) only. If media relay is active for a call using this interface an 'exclusive' coder config is used to prohibit the use of any other coder. This 'exclusive code media-relay' config can be used to solve interop problems with other equipment which does not support media renegotiation, because with this config no media renegotiation will be performed.
For more information see Media Properties