/* -*- html -*- */ /** @page sofia_sip_conformance SIP and SDP Protocol Features in Sofia-SIP This document describes how Sofia-SIP stack supports specifications listed below.
Feature | Supported | Notes |
---|---|---|
@RFC3261: Basic SIP Protocol | The SIP registration and dialog level implementation enables the application to operate as a SIP UA, SIP proxy or a redirect server according to the @RFC3261. The @RFC3261 functionality is divided into five layers: -# message syntax and encoding -# transport -# transaction -# transaction user (UAS and UAC cores, proxy core) -# SIP elements: user agent client and server, proxies, registrars | |
@RFC3261 Sections 19 and 20: Syntax and encoding | The supported @RFC3261 methods are: @b REGISTER, @b OPTIONS, @b INVITE, @b ACK, @b CANCEL, @b BYE, as well as extension methods INFO, PRACK, SUBSCRIBE, NOTIFY, UPDATE, MESSAGE, REFER, and PUBLISH. Sofia-SIP supports the following SIP headers as specified in @RFC3261 or its extensions (generating, parsing and syntax checking): @ref sip_accept "Accept", @ref sip_accept_encoding "Accept-Encoding", @ref sip_accept_language "Accept-Language", @ref sip_alert_info "Alert-Info" (extension in @VERSION_1_12_7), @ref sip_allow "Allow", @ref sip_authentication_info "Authentication-Info", @ref sip_authorization "Authorization", @ref sip_call_id "Call-ID" ("i"), @ref sip_call_info "Call-Info", @ref sip_contact "Contact" ("m"), @ref sip_content_disposition "Content-Disposition", @ref sip_content_encoding "Content-Encoding" ("e"), @ref sip_content_language "Content-Language", @ref sip_content_length "Content-Length" ("l"), @ref sip_content_type "Content-Type" ("c"), @ref sip_cseq "CSeq", @ref sip_date "Date", @ref sip_error_info "Error-Info", @ref sip_expires "Expires", @ref sip_from "From" ("f"), @ref sip_in_reply_to "In-Reply-To", @ref sip_max_forwards "Max-Forwards", @ref sip_min_expires "Min-Expires", @ref sip_mime_version "MIME-Version", @ref sip_organization "Organization", @ref sip_p_asserted_identity "P-Asserted-Identity" (extension in @VERSION_1_12_7), @ref sip_p_preferred_identity "P-Preferred-Identity" (extension in @VERSION_1_12_7), @ref sip_priority "Priority", @ref sip_proxy_authenticate "Proxy-Authenticate", @ref sip_proxy_authorization "Proxy-Authorization", @ref sip_proxy_require "Proxy-Require", @ref sip_record_route "Record-Route", @ref sip_refer_sub "Refer-Sub" (@VERSION_1_12_5), @ref sip_remote_party_id "Remote-Party-ID" (extension in @VERSION_1_12_7), @ref sip_reply_to "Reply-To" (extension in @VERSION_1_12_7), @ref sip_require "Require", @ref sip_retry_after "Retry-After", @ref sip_route "Route", @ref sip_server "Server", @ref sip_subject "Subject" ("s"), @ref sip_supported "Supported" ("k"), @ref sip_timestamp "Timestamp", @ref sip_to "To" ("t"), @ref sip_unsupported "Unsupported", @ref sip_user_agent "User-Agent", @ref sip_via "Via" ("v"), @ref sip_warning "Warning", and @ref sip_www_authenticate "WWW-Authenticate". Unknown headers (extension headers) are supported and can be passed to/received from application as name-value pairs. It is possible to extend SIP parser in run-time with header-specific parsers. | - Automatic escaping of reserved characters has not been implemented. - Using NUL (zero byte) in double-quoted strings has not been implemented |
@RFC3261 Section 18: UDP and TCP transports |
UDP and TCP on both IP4 and IP6 are supported. The UDP size limit of 1300 bytes is enforced by default. If limit is exceeded, TCP is tried instead. If TCP connection is refused, UDP is tried if message size is less than 64 kilobytes. Limit is adjustable via parameter NTATAG_UDP_MTU(). TCP connections are reused by client. However, server closes connections after idle time of 30 minutes (by default). The idle time limit is adjustable with TPTAG_IDLE() (given as argument to nta_agent_add_tport() or nta_agent_create()). Server tries to use same TCP connection to return response as the request was received. Only one SIP message is accepted per UDP message, as per @RFC3261. | There is experimental support for SCTP, too. |
@RFC3261 Section 17: Transactions |
Transaction state engines function as specified in @RFC3261 section
17. There is special handling of methods @b INVITE, @b ACK, and @b
CANCEL. There are two modes for transaction state engines,
User-Agent and Proxy modes.
Default values for SIP timers are those specified by @RFC3261. The
values for T1, T1x64, T2 and T4 can be changed via
configuration tags defined in |
|
@RFC3261 Section 26: Security |
TLS and SIPS URIs has been implemented. Currently, TLS does not require certificate from client nor it does check it if one is provided. | Missing: - Authorizing connections with TLS certificates - S/MIME |
@RFC2617: HTTP Digest Authentication | Sofia-SIP includes authentication client and server modules implementing HTTP Digest authentication. HTTP Digest is a simple challenge-response authentication scheme defined in @RFC2617 based on the UA sending a checksum calculated over specific values in response to a challenge sent by the server (proxy or UA). Checksum calculation supports MD5 (@RFC1321). The algorithm for calculating MD5 digest hash can be MD5, MD5sess or be @RFC2069-compatible algorithm. The quality-of-protection (qop) parameters "auth", "auth-int" and none (missing) are supported. The "opaque" parameter is supported. The SIP authentication headers supported (generating, parsing and syntax checking) are: @ref sip_authorization "Authorization", @ref sip_authentication_info "Authentication-Info", @ref sip_proxy_authenticate "Proxy-Authenticate", @ref sip_proxy_authentication_info "Proxy-Authentication-Info", @ref sip_proxy_authorization "Proxy-Authorization", and @ref sip_www_authenticate "WWW-Authenticate". SIP interface to the modules is implemented as defined in @RFC3261 (sections 8.1.3.5, 22.2, 22.3, 22.4). An @RFC2617 header @ref sip_proxy_authentication_info "Proxy-Authentication-Info" is not listed in @RFC3261 but it is nevertheless supported by Sofia-SIP. | Missing: - Using nextnonce - Mutual authentication |
@RFC3262: PRACK and 100rel | PRACK method is supported within dialog as defined in RFC3262. Semantics of reliable provisional responses are supported: - including 100rel Required header in provisional responses if request had 100rel - generation of PRACK based on 100rel option tag in Require header of a provisional response, and - automatic re-transmission of provisional responses. The SIP headers supported (generating, parsing and syntax checking) are @ref sip_rseq "RSeq" and @ref sip_rack "RAck". | |
@RFC3263: Locating SIP Servers | Support for SIP server address resolution from SIP or SIPS URI using NAPTR, SRV, A or AAAA records in DNS as defined in @RFC3263. | - Resolving any other types of URIs than SIP or SIPS URIs, e.g., IM: or PRES: URIs. |
@RFC3265: SIP Event Notifications | SIP extensions for subscribing and processing asynchronous event notifications as defined in @RFC3265. Includes dialog level support for sending and refreshing SUBSCRIBE and receiving NOTIFY messages. The SIP headers explicitly supported (generating, parsing and syntax checking) are @ref sip_event "Event" ("o"), @ref sip_allow_events "Allow-Events", and @ref sip_subscription_state "Subscription-State" Note: currently there is no support for forked SUBSCRIBE requests. | Application must take care of: - Subscribing, generating or processing specific event types and interpreting the content of event data is up to application |
@RFC2806: tel URI | Sofia-SIP supports handling of any URI type. Sofia-SIP parses tel: URIs. | Missing: - Resolving the tel: URIs |
@RFC2976: INFO | INFO method is supported within a dialog natively. | Not implemented: - Generating or processing contents of INFO requests |
@RFC3311: UPDATE | UPDATE method as defined in RFC3311. UPDATE allows a client to update parameters of a session (such as the set of media streams and their codecs) even within early dialogs. Offer-Answer negotiation with UPDATE is implemented in nua. | Application must take care of: - Initiating UPDATE requests |
@RFC3313: Media Authentication | Sofia-SIP provides generic support for extension headers and parameters. P-Media-Authorization header is supported as an @ref sip_unknown "extension header". | Application must take care of: - Passing the authorization token to QoS reservation request |
@RFC3323: Privacy |
@ref sip_privacy "Privacy" header is supported (generating, parsing
and syntax checking).
Call-Id header is generated from cryptographically random id without
host name or IP address. By default, @ref sip_contact "Contact" and
@ref sip_via "Via" headers contain only IP address that can be
dynamically allocated.
Application can enter any SIP URI and display name to From header,
e.g., @code Anonymous |
Application must take care of: - Properly populating the URIs and display names within SIP headers - Not including any optional headers that could reveal identity - Generating of Privacy header with appropriate values - Generating of Proxy-Require: privacy - Using anonymous callback URIs etc. |
@RFC3326: Reason | Sofia-SIP supports @ref sip_reason "Reason" header (generating, parsing and syntax checking). | Application must take care of: - Generating or processing Reason headers |
@RFC3325: Asserted Identity | Sofia-SIP supports @ref sip_p_asserted_identity "P-Asserted-Identity" and @ref sip_p_preferred_identity "P-Preferred-Identity" headers (generating, parsing and syntax checking). Also the non-standard header @ref sip_remote_party_id "Remote-Party-ID" is supported. @NEW_1_12_7. | Not implemented: - id privacy - Recognizing trust domains and enforcing handling of headers based on those |
@RFC3327: Path | User-agent engine can add "path" option tag to Supported header of REGISTER requests. Sofia-SIP explicitly supports @ref sip_path "Path" header (generating, parsing and syntax checking). | |
@RFC3329: Security Agreement | Some support of the SIP Security Mechanism Agreement procedures. The client is able to insert Security-Client and Security-Verify header with fake @e d-ver value. Sofia-SIP explicitly supports (generating, parsing and syntax checking) @ref sip_security_client "Security-Client", @ref sip_security_server "Security-Server", and @ref sip_security_verify "Security-Verify" headers. Security-mechanism supported is "digest". | Correct @e d-ver value is not calculated. |
@RFC3361: DHCPv4 option for locating SIP servers. | Sofia-SIP supports outbound proxy. | Application must take care of: - passing outbound proxy name or address from DHCP client to Sofia-SIP stack. |
@RFC3420: message/sipfrag | Sofia-SIP passes the received SIP message headers to application which can create a message/sipfrag payload. | Application must take care of: - processing the SIP message fragments |
@RFC3428: MESSAGE | MESSAGE method is supported natively. | |
@RFC3486: Compressing SIP | Sofia-SIP provides support for using comp=sigcomp parameters in @ref sip_via "Via" header and @ref url_t "SIP URIs", indicating support for compression. | SigComp itself is not supported. |
@RFC3515: REFER | REFER method is supported natively. Sofia-SIP processes incoming REFER requests and generates NOTIFY with correct @ref sip_event "Event" header automatically. Further notifications can be automatically generated actions when nua_invite() is given referrer's nua handle in NUTAG_NOTIFY_REFER(). Sofia-SIP explicitly supports (generating, parsing and syntax checking) @ref sip_refer_to "Refer-To" ("r") SIP header. See also support for RFC 3891 and RFC 3892. | |
@RFC3608: Service-Route | Sofia-SIP supports @ref sip_service_route "Service-Route" that can be used to provide a mechanism by which a registrar may inform a registering UA of a service route. User-Agent will optionally use the route provided in @ref sip_service_route "Service-Route" header. The SIP header explicitly supported (generating, parsing and syntax checking) is @ref sip_service_route "Service-Route". | |
@RFC3680: "reg" event | Sofia-SIP supports generic SIP event support for subscribing SIP event packages and receiving notifications for them. Subscriptions are refreshed before expiration when needed and subscriptions are terminated on request. Sofia-SIP takes care of notified subscription states. UA can SUBSCRIBE to a registration state event package after sending initial REGISTER to, e.g., 3GPP network and use it to follow its registration status. | Application must take care of: - Generating subscriptions for "reg" event - Processing notifications for "reg" event - Handling of XML document in notifications |
@RFC3824: ENUM | Tel URIs are supported in any headers including URI parameters, e.g., To, From, Contact headers, and Request-URI of the outgoing SIP request provided that the next hop is given as SIP or SIPS URI. | Stack can not resolve E.164 number to address of next hop. A proxy in the network must resolve E.164 numbers with ENUM. |
@RFC3840: Callee Capabilities | Feature parameters can be added to SIP profiles and sent within Contact header of REGISTER request as header parameters. UAC can optionally generate media tags for Contact header using local media profile. Feature parameters can also be sent within any other SIP request as extension parameters of Contact header. | Application must take care of: - Processing the feature parameters received in the Contact header |
@RFC3841: Caller Preferences | Built-in support for user-agent behavior. UAC can optionally generate Accept-Contact header using local media profile. SIP parser parses the Accept-Contact and Reject-Contact headers. ACK and CANCEL request messages sent have same values for Accept-Contact/Reject-Contact or Request-Disposition headers as the original request had. There are functions for calculating score for contacts. The SIP headers explicitly supported (generating, parsing and syntax checking) are: @ref sip_request_disposition "Request-Disposition" ("d"), @ref sip_accept_contact "Accept-Contact" ("a"), @ref sip_reject_contact "Reject-Contact" ("j"), | Application must take care of: - UAS processing incoming Accept-Contact or Reject-Contact headers |
@RFC3842: Message waiting event | Sofia-SIP supports generic SIP event support for subscribing SIP event packages and receiving notifications for them. Subscriptions are refreshed before expiration when needed and subscriptions are terminated on request. Sofia-SIP takes care of notified subscription states. | Application must take care of: - Generating subscriptions for "message-summary" event - Including correct @ref sip_event "Event" and @ref sip_accept "Accept" headers in the request (if needed) - Processing notifications for "message-summary" event - Handling of summary information in notifications |
@RFC3856: Presence @RFC3859: Common Profile for Presence |
Sofia-SIP supports generic SIP event support for subscribing SIP event packages and receiving notifications for them. Subscriptions are refreshed before expiration when needed and subscriptions are terminated on request. Sofia-SIP takes care of notified subscription states. Note: Usage of pres: URI is supported only if the next hop URI to where to send SUBSCRIBE is a SIP URI (e.g. of outbound proxy). Resolving of pres: URIs by DNS is not supported. | Application must take care of: - Generating subscriptions for "presence" event - Including correct @ref sip_event "Event" and @ref sip_accept "Accept" headers in the request (if needed) - Processing notifications for "presence" event - Handling of presence information in notifications |
@RFC3857: "winfo" event template package @RFC3858: winfo format |
Sofia-SIP supports generic SIP event support for subscribing SIP event packages and receiving notifications for them. Subscriptions are refreshed before expiration when needed and subscriptions are terminated on request. Sofia-SIP takes care of notified subscription states. | Application must take care of: - Generating subscriptions for winfo events - Including correct @ref sip_event "Event" and @ref sip_accept "Accept" headers in the request (if needed) - Processing notifications for winfo events: - Processing watcherinfo XML documents |
@RFC3860: Common Profile for IM | Sofia-SIP supports handling of any URI type. Sofia-SIP parses "im:" URIs. | Application must take care of: - resolving the "im:" URI |
@RFC3891: Replaces | @ref sip_replaces "Replaces" header is explicitly supported (generating, parsing and syntax checking). | Application must take care of: - generating @ref sip_replaces "Replaces" header from a dialog and matching a dialog with a Replaces header received |
@RFC3892: Referred-By | @ref sip_referred_by "Referred-By" header is explicitly supported (generating, parsing and syntax checking). Referred-by token can be sent and received in text-based SIP message body. | Application must take care of: - Generating or processing @ref sip_referred_by "Referred-By" headers - Generating (and encrypting) or verifying (and decrypting) of Referred-by tokens |
@RFC3903: PUBLISH | PUBLISH method is supported natively. The SIP headers explicitly supported (generating, parsing and syntax checking) are @ref sip_etag "SIP-ETag" and @ref sip_if_match "SIP-If-Match". The user-agent engine keep published data refreshed until nua_unpublish() is called. | Application must take care of: - Including correct @ref sip_event "Event" in the request - Permanently storing @SIPETag |
@RFC4028: Session Timers | The SIP session-timer ("timer") extension is supported. The session-expires value and refreshing party is negotiated in user-agent engine. When user-agent engine is responsible for refreshes, it will initiate re-INVITE or UPDATE transaction at regular intervals. If there has been no SIP activity in session during the refresh period, it will try to automatically terminate the call by sending a @b BYE request. The SIP headers explicitly supported (generating, parsing and syntax checking) are @ref sip_session_expires "Session-Expires" ("x") and @ref sip_min_se "Min-SE". | |
@RFC4168: SCTP as Transport for SIP | The transport=sctp URI parameter is supported. The SCTP transport protocol is supported as experimental. It is enabled with configure script argument --enable-sctp. The framing of SIP messages over SCTP is not specified clearly in @RFC4168. It is possible to send SIP messages smaller than 64K over SCTP. | |
@RFC4320: Actions Addressing Identified Issues with SIP's Non-INVITE Transaction | The action 1 (make the best use of provisional responses) is supported when NTATAG_EXTRA_100(1) is used with nua_create() or nta_agent_create(). The 100 Trying provisional response is sent after T2 is expired or when a retransmission is received after T2/2 after the initial request. The action 2 (remove the useless late-response storm) is supported by default. The 408 timeout response is not forwarded by default (it's forwarding can be enabled with NTATAG_PASS_408(1), however). | Application must include NTATAG_EXTRA_100(1) with nua_create() or nta_agent_create() tags. |
@RFC4488: Suppression of REFER Implicit Subscription | Sofia-SIP supports @ref sip_refer_sub "Refer-Sub" header (generating, parsing and syntax checking). The implicit subscription is suppressed by @nua, if the @ReferSub: true header is included in the REFER request (@ref nua_refer "on server side") or response (@ref nua_i_refer "on client side"). @NEW_1_12_5 | The REFER client application must include SIPTAG_REFER_SUB_STR("true") in the nua_refer() tags. |
@RFC5057: Multiple Dialog Usages in SIP | Sofia-SIP provides function sip_response_terminates_dialog() that can be used to determine the effect of error response with dialog. The nua UA engine uses sip_response_terminates_dialog(). | The client application must either use NUA or sip_response_terminates_dialog(). |
Feature | Supported | Notes |
---|---|---|
@RFC4566: SDP: Session Description Protocol | Generic support (generating, parsing and syntax checking) for SDP. The SDP @ref sdp_version_t "v=", @ref sdp_origin_t "o=", @ref sdp_connection_t "c=", @ref sdp_bandwidth_t "b=", @ref sdp_time_t "t=", @ref sdp_repeat_t "r=", @ref sdp_zone_t "z=", @ref sdp_key_t "k=", @ref sdp_attribute_t "a=", and @ref sdp_media_t "m=" lines are separated and parsed. The "e=", "p=", "s=", and "i=" lines are separated. The attributes "a=sendrecv", "a=sendonly", "a=recvonly", "a=inactive", @ref sdp_rtpmap_s "a=rtpmap", and "a=fmtp" are parsed. The implementation partially implements @RFC4566. Note that definition of 'token' was updated in @RFC4566 and the parser has not been updated yet. | @RFC4566 obsoletes - @RFC2327: SDP (Session Description Protocol) - @RFC3266: IP6 in SDP |
@RFC3264: SDP Offer/Answer Negotiation | Generating and processing offers or answers. | - "a=fmtp" parameters are not taken into account when generating or processing answer |
@RFC3312: Preconditions | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. Sofia-SIP supports handling SIP feature tags in @ref sip_proxy_require "Proxy-Require", @ref sip_require "Require", @ref sip_supported "Supported" ("k"), and @ref sip_unsupported "Unsupported" header. | Application must take care of: - Semantics and handling of preconditions - Reservation of resources |
@RFC3388: Grouping of Media Lines | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. @RFC3388 defines mid, group, LS and FID are predefined strings to be used within attribute line | Application must take care of: - Generating or processing the attribute lines - Grouping the media for transport accordingly |
@RFC3407: Capability Declaration | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. | Application must take care of: - Defining sqn, cdsc, cpar etc. strings needed in a= line - Generating or processing the attribute lines - Capability negotiation itself |
@RFC3524: SRF | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. | Application must take care of: - Defining SRF string needed in a= line - Generating or processing the attribute lines |
@RFC3551: RTP/AVP | Sofia-SIP recognizes the RTP payload types for well-known audio and video codecs defined in @RFC3551. | Application must take care of: - Audio or video processing - Generating a=rtpmap or a=fmtp lines when needed |
@RFC3556: Bandwidth | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. | Application must take care of: - Generating or processing RS and RR bandwidth modifiers - Semantics of bandwidth allocation |
@RFC3605: RTCP attribute | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. | Application must take care of: - Discovering port numbers - Generating or processing the RTCP attribute lines |
@RFC3890: TIAS | Sofia-SIP provides generic support for attribute lines that conform to SDP syntax. | Application must take care of: - Generating or processing TIAS bandwidth modifiers - Generating or processing the maxprate attribute lines |