hgs/SIP Tutorial


The Session Initiation Protocol (SIP)
Henning Schulzrinne Dept. of Computer Science Columbia University New York, New York (sip:)schulzrinne@cs.columbia.edu

May 2001

hgs/SIP Tutorial


• protocol architecture • typical component architectures • addressing and locating SIP entities • protocol operation and extensions • reliability • services, features and caller preferences • security and QoS • programming SIP services

May 2001

hgs/SIP Tutorial


• SIP = core protocol for establishing sessions in the Internet • transports session description information from initiator (caller) to callees • allows to change parameters in mid-session • terminate session

May 2001

hgs/SIP Tutorial 4 VoIP protocol architecture Languages/APIs JAIN CPL voiceXML servlets Parlay sip−cgi Directory/Discovery DNS/enum LDAP TRIP SLP Signaling SIP SDP MGCP H.248 PINT SPIRITS peer−to−peer RTSP master−slave QoS DiffServ IntServ Transport RTP TLS SCTP May 2001 .

IPv6 PPP AAL3/4 ATM AAL5 UDP network PPP Ethernet V. (H. MPEG) .34 link Sonet physical May 2001 kernel application daemon media encaps.323 SIP RTSP reservation measurement RSVP RTCP RTP transport TCP IPv4.hgs/SIP Tutorial 5 Multimedia protocol stack signaling quality of service media transport MGCP/Megaco SDP H.261.

hgs/SIP Tutorial 6 SIP protocol use LDAP address lookup TRIP PSTN gateway lookup DNS next−hop signaling may trigger SIP SDP sets up SIP SDP RSVP RSVP media RTP UDP RTP UDP May 2001 .

hgs/SIP Tutorial 7 SIP applications • setting up voice-over-IP calls • setting up multimedia conferences • event notification (subscribe/notify) « IM and presence • text and general messaging • signaling transport May 2001 .

hgs/SIP Tutorial 8 SIP addressing May 2001 .

edu tel:12015551234 alice@host.edu columbia.com alice@columbia.com tel:12128541111 alice17@yahoo.Cary@columbia.edu (also used by bob@columbia.edu Alice.edu 7000@columbia.hgs/SIP Tutorial 9 Personal mobility SIP uses email-style addresses to identify users alice@columbia.columbia.edu May 2001 .edu) yahoo.

g. sip:alice@example.com • can add parameters. e.com • written as URL..hgs/SIP Tutorial 10 SIP addressing • typically. same as user’s email address: alice@example. such as type (user=”phone”) or transport protocol May 2001 .com 12125551212@gateways-r-us.

1234567 • either global (tel:+1.type=v32b?7e1.) or local (tel:0w003585551234567.hgs/SIP Tutorial 11 tel URLs (RFC 2806) • also can use tel URLs for telephone numbers.g..type=v110 May 2001 . tel:+12125551212 or fax:+358..postd=pp32 • also modem:+3585551234567. e..phone-context=+3585551234 numbers • allow post-dialing digits: .555.

hgs/SIP Tutorial 12 SIP building blocks SIP user agent SIP redirect server SIP stateless proxy SIP (forking) proxy A@ B@ C@ IP phone. conference bridge returns new location for requests routes call requests routes call requests maintains mappings from names to addresses SIP registrar May 2001 . PC.

where incoming calls trigger outgoing calls to somebody else • also. “third-party call control” (later) • useful for services and anonymity SIP UA1 (UAS) INVITE b2b 200 OK SIP UA2 (UAC) INVITE callee 200 OK May 2001 .hgs/SIP Tutorial 13 Back-to-back UA (B2BUA) • two (or more) user agents.

hgs/SIP Tutorial 14 Maintaining state in SIP entities Stateless: each request and response handled indepdently (Transaction) stateful: remember a whole request/response transaction Call stateful: remember a call from beginning to end May 2001 .

UAS) proxy redirect registrar May 2001 .hgs/SIP Tutorial 15 SIP building block properties media yes no no stateless no yes no stateful unlikely common yes call state common possible (firewall) N/A UA (UAC.

hgs/SIP Tutorial 16 SIP architecture: peer-to-peer SIP redirect server user agent (UA) user agent (UA) user agent (UA) Internet RTP audio 128.119.141 CATV Ethernet May 2001 .186

wonderland.com Contact: sip:bob@p42.hgs/SIP Tutorial 17 SIP architecture: outbound proxy wonderland.0 alice@ph7.macrosoft.com SIP/2.com outbound proxy Internet registrar proxy wonderland.com macrosoft.com INVITE sip:bob@p42.macrosoft.macrosoft.0 INVITE sip:bob@macrosoft.com REGISTER sip:macrosoft.com SIP/2.com SIP/2.com From: sip:bob@macrosoft.0 May 2001 .com INVITE sip:bob@macrosoft.com bob@p42.0 To: sip:bob@macrosoft.com SIP/2.

248 tel:+1−212−555−1234 outbound proxy IP 010 May 2001 .hgs/SIP Tutorial 18 SIP architecture: VoIP to PSTN location server TRIP SLP?. TRIP−GW? sip:12125551234@gwrus.com sip:1−212−555−1234@domain SIP H.

2.3.1.com IP 010 INVITE sip:alice@wonderland.2.hgs/SIP Tutorial 19 SIP architecture: PSTN to VoIP enum database DNS 4.2.com May 2001 .1.e164.1.5.arpa SCP enum sip:alice@wonderland.5.5.

columbia.edu ? location server 1 2 hgs@play henning cs.de 7 play tune 8 ACK hgs@play 9 media stream May 2001 .tu−berlin.tu−berlin.edu 200 OK 4 INVITE hgs@play 5 3 200 OK 6 cz@cs.de INVITE henning@columbia.hgs/SIP Tutorial 20 SIP operation in proxy mode cs.

edu location server tu-berlin.hgs/SIP Tutorial 21 SIP operation in redirect mode ieee.org 302 Moved temporarily Contact: hgs@columbia.de INVITE henning@ieee.edu hgs (302: redirection for single call.edu 4 5 ACK henning@ieee.org 1 henning ? 2 columbia.edu 7 200 OK 8 ACK hgs@columbia.org 3 6 INVITE hgs@columbia.edu columbia. 301 permanently) May 2001 .

hgs/SIP Tutorial 22 Locating SIP users May 2001 .

com REGISTER alice@example. proprietary.com proxy May 2001 .com Contact: alice@pc17 A@ B@ C@ SQL. location server INVITE alice@example. .example... Corba.hgs/SIP Tutorial 23 Locating users: registrars and location servers registrar example. LDAP.com INVITE alice@pc17.

using any information in request 5. May 2001 . if SIP proxy/redirect server: map URLn −→ URLn+1 . DNS: host name of proxy → SIP server(s) 3. go to step 1 One minor exception. . . if SIP UAS: alert user. host(SIP URL) −→ host name of proxy 2.hgs/SIP Tutorial 24 Basic user location mechanism 1. done 4.

can use “record-routing” to force certain proxies to be visited all the time • responses always traverse the same route as requests May 2001 .hgs/SIP Tutorial 25 Basic SIP “routing” mechanisms • will fill in details later • route using request URIs • all but first request in call typically bypass proxies and go direct UAC – UAS • however.

.hgs/SIP Tutorial 26 Outbound proxies • normally. May 2001 . for managing corporate firewalls and policy enforcement • may also provide dial plans or route tel/fax URLs • other uses: lawyer client billing. . proxy serves one or more domains • outbound proxies are used for all outbound requests from within a domain • typically. .

yahoo.ip-provider. including protocols _sip._tcp _sip. • allows priority (for back-up) and weight (for load balancing) May 2001 .columbia.com yahoo.yahoo.mail.com • SIP: use a newer record for general-purpose mapping. host -t mx yahoo.ip-provider._udp SRV SRV SRV SRV 0 1 0 1 0 0 0 0 5060 5060 5060 5060 sip-server.yahoo.edu. SRV (RFC 2782) • mapping from service and transport protocol to one or more servers. sip-server.mail.com mx3.g.com mta-v1.net.com yahoo.hgs/SIP Tutorial 27 Locating users: DNS SRV • email: DNS MX record allows mapping of domain to mail host.com mx1.mail.com MX MX MX MX 1 1 1 9 mx2. backup.com yahoo.yahoo.com yahoo.cs.columbia.edu.cs.net. backup.mail. e.

com sip:bob@example._udp SRV 0 0 s1.com sip:bob@a.example.com a1.com b1. a2.com SRV 0 0 s3.example.example._udp SRV 0 0 a1.example.example.example.example.com SRV 0 0 s2.com _sip.hgs/SIP Tutorial 28 Using DNS SRV for scalable load-balancing a.example.com.com _sip.com s3.com s2.example.example.com.com b*@example.example.com s1.com May 2001 .example.com SRV 1 0 a2.com a*@example. b2.example.example.

since backend (registration) synchronization is needed • registration scaling: requests/second * 3600.hgs/SIP Tutorial 29 Aside: SIP scaling • HTTP request director ↔ SIP client-based • HTTP randomized DNS (short TTL!) ↔ SRV weights and priorities • can’t just distribute requests randomly. e. higher registration than INVITE rates May 2001 .g.. 100 requests/second « 360.000 users/server • major bottlenecks are logging and database updates • generally.

hgs/SIP Tutorial 30 SIP protocol operation May 2001 .

but also ASCII or HTML May 2001 .1 • requests and responses are similar except for first line • requests and responses can contain message bodies: typically session descriptions.hgs/SIP Tutorial 31 SIP requests and responses • text. not binary. format • look very similar to HTTP/1.

0 response SIP/2.hgs/SIP Tutorial 32 SIP syntax request method URL SIP/2.par1=value .par3="value folded into next line" blank line V=0 o= origin_user timestamp timestamp IN IP4 host c=IN IP4 media destination address t=0 0 m= media type port RTP/AVP payload types message message body message header May 2001 .0 status reason Via: SIP/2.0/ protocol host:port user <sip:from_user@source> From: To: user <sip:to_user@destination> Call−ID: localid@host CSeq: seq# method Content−Length: length of body Content−Type: media type of body Header: parameter .par2="value" .

g.hgs/SIP Tutorial 33 SIP syntax • field names and some tokens (e. media type) are case-insensitive • everything else is case-sensitive • white space doesn’t matter except in first line • lines can be folded • multi-valued header fields can be combined as a comma-list May 2001 ..

hgs/SIP Tutorial 34 SIP methods INVITE ACK BYE CANCEL OPTIONS REGISTER INFO COMET PRACK SUBSCRIBE NOTIFY REFER initiate call confirm final response terminate (and transfer) call cancel searches and “ringing” features support by other side register with location service mid-call information (ISUP) precondition met provisional acknowledgement subscribe to event notify subscribers ask recipient to issue SIP request (call transfer) May 2001 .

hgs/SIP Tutorial 35 SIP invitation and media negotiation alice@wonderland. decline video May 2001 .com INVITE sip:bob@macrosoft.com SIP/2.com CSeq: 42 INVITE Content−Type: application/sdp v=0 o=user1 535 687637 IN IP4 m.com CSeq: 42 INVITE Content−Type: application/sdp v=0 o=user1 536 2337 IN IP4 h3.com m=audio 3456 RTP/AVP 0 1 m=video 4000 RTP/AVP 38 39 calls bob@macrosoft.com c=IN IP4 m.wonderland.macrosoft.com To: sip:bob@macrosoft.com Call−ID: 31415@wonderland.com SIP/2.0 200 OK From: sip:alice@wonderland.wonderland.com c=IN IP4 h3.com To: sip:bob@macrosoft.0 From: sip:alice@wonderland.com m=audio 1200 RTP/AVP 1 m=video 0 RTP/AVP accept audio.com Call−ID: 31415@wonderland.macrosoft.

com> . G. Bell" <sip:agb@bell-telephone.tag=a48s • future requests are ignored if they contain the wrong tag May 2001 .hgs/SIP Tutorial 36 Tagging To • after forking and merging. hard to tell who responded • UAS responds with random tag added to disambiguate To: "A.

Call-ID • requests from callee to caller reverse To and From • caller and callee keep their own CSeq space • either side can send more INVITEs or BYE May 2001 .hgs/SIP Tutorial 37 SIP call legs • call leg: From. To.

302 Moved Temp. Request Failure 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Bad Method 415 Unsupp.hgs/SIP Tutorial 38 SIP responses Informational 100 Trying 180 Ringing 181 Call forwarded 182 Queued 183 Session Progress Success 200 OK Redirection 300 Multiple Choices 301 Moved Perm. Content 420 Bad Extensions 486 Busy Here 500 Server Error 501 Not Implemented 503 Unavailable 504 Timeout 600 Busy Everwhere 603 Decline 604 Doesn’t Exist 606 Not Acceptable Server Failure Global Failure May 2001 . 380 Alternative Serv.

hgs/SIP Tutorial 39 SIP response routing • requests are routed via URL • response traces back request route without proxy server state • forward to host.2.domain.3 May 2001 .org:5060 . create new one if needed • UDP: may send responses to same port as requests Via: SIP/2.1.0/UDP server.received=128. port in next Via • TCP: re-use connection if possible.

com Via: a.edu May 2001 .example.com Via: cs.yahoo.columbia.columbia.com Via: a.com Via: y1.com Via: a.com bob@columbia.com bob@pc42.edu INvITE Via: a.com bob_doe@yahoo.columbia.com Via: a.com Via: a.com Via: a.edu Via: sip.edu Via: sip.edu Via: y1.columbia.edu 200 OK Via: cs.hgs/SIP Tutorial 40 SIP response routing alice@example.example.com bob@cs.example.yahoo.example.yahoo.yahoo.edu Via: y1.columbia.edu Via: y1.columbia.com Via: sip.example.cs.columbia.yahoo.edu Via: y1.com Via: y1.columbia.example.yahoo.example.com Via: sip.com Via: a.example.

acme.acme.com sales.alice.info) Via: ph123.CSeq.com alice@ph123.com INVITE sip:kelly@sales.17.acme.com SIP/2.bob@sales) Via: acme.com.wonderland.wonderland.com INVITE sip:bob@sales.0 Via: acme.acme.bob@sales) Via: acme.alice.17.com.com acme.branch= Via: acme.wonderland.1.com.alice.com INVITE sip:info@acme.alice.com branch= h(To.branch= h(info.1.17.alice.Call−ID.com.kelly@acme) Via: sales.com May 2001 .alice.bob@sales) Via: sales.com.branch= h(info.com SIP/2.com.17.com SIP/2.com.bob@sales) Via: ph123.branch= h(info.acme.branch= h(info.branch= h(info. h(info.com Via: ph123.hgs/SIP Tutorial 41 SIP spirals INVITE sip:kelly@p4711.0 Via: sales.com SIP/2.1.0 h(info.17.0 h(info.sales.kelly@acme) Via: acme.1.URL) INVITE sip:kelly@acme.17.wonderland.17.info) Via: ph123.com.alice.1.com.acme.com SIP/2.1.acme.com.kelly@sales) Via: acme.0 To: sip:info@acme.From.alice.branch= Via: sales.17.branch= h(info.wonderland.acme.17.alice.wonderland.branch= h(info.alice.1.info) Via: ph123.

hgs/SIP Tutorial


Forcing request paths
• usually, bypass proxies on subsequent requests • some proxies want to stay in the path → call-stateful: – firewalls – anonymizer proxies – proxies controlling PSTN gateways • use Record-Route and Route

May 2001

hgs/SIP Tutorial


Request routing
Contact: A

Contact: A Record−Route: PA

Contact: A Record−Route: PB, PA


200 OK
Contact: B Record−Route: PB, PA

200 OK
Contact: B Record−Route: PB, PA

200 OK
Contact: B Record−Route: PB, PA

Route: PB,B

Route: B



Route: A;maddr=PB

Route: A;maddr=PB Route: A;maddr=PA Route: A;maddr=A

May 2001

hgs/SIP Tutorial


SIP request forking

INVITE sales@macrosoft.com

INVITE bob@b

CANCEL bob@c INVITE carol@c


200 OK

BYE carol@c.macrosoft.com

200 OK

May 2001

1 200 OK May 2001 .7 INVITE 486 Busy here 3 q=0.hgs/SIP Tutorial 45 SIP sequential request forking Use q values to govern order of sequential search: q=1.0 1 302 Moved temporarily 2 q=0.

hgs/SIP Tutorial 46 SIP request forking • branches tried in sequence or parallel (or some combination) • recursion: may try new branches if branch returns 3xx • return best final answer = lowest status code • forward provisional responses May 2001 .

hgs/SIP Tutorial 47 Parallel forking call flow alice bob@portal bob@home bob@work INVITE bob@portal 100 Trying 180 Ringing 200 OK Contact: bob@home 200 OK CANCEL bob@work 200 OK (CANCEL) 487 Cancelled (INVITE) ACK bob@work ACK bob@home UAC proxy server UAS UAS May 2001 .

packet size TCP: can combine multiple signaling flows over one link – use with SSL – connection setup overhead – HOL blocking for trunks SCTP: new protocol – no HOL blocking – fallback address (but SRV provides this already) – connection setup overhead May 2001 . reliable or unreliable • choices: UDP: most common – low state overhead – small max.hgs/SIP Tutorial 48 SIP transport issues • SIP operates over any packet network.

6xx May 2001 . . NOTIFY. • 1xx sent by UAS or proxy only if no final answer expected within 200 ms • if provisional response. .hgs/SIP Tutorial 49 Transport reliability for all but INVITE client BYE 500 ms UAS. proxy • used for BYE.. 4xx. no more than 11 packets 200. . retransmit with T 2 (4) seconds 1s 2s 4s 4s . 5xx. OPTIONS. SUBSCRIBE..

hgs/SIP Tutorial 50 INVITE reliability • INVITE is special – long time between request and final response • 100 (by proxy) indicates request has been received • proxy usually forwards 1xx from all branches • only retransmit until 100 • ACK confirms receipt of final response status ACK event request sent T1*2 INVITE n Initial − INVITE Calling 1xx status ACK Call proceeding status ACK 1xx 7 INVITE sent Completed May 2001 .

hgs/SIP Tutorial 51 Other signaling approaches May 2001 .

DTMF ISUP.hgs/SIP Tutorial 52 Differences to classical signaling name in-band out-of-band IP examples E&M. while PSTN out-of-band intersects at every switch May 2001 . Q.931 SIP network same different typically same “channel” same different different IP signaling meets media only at end systems.

2.248 (standardized.hgs/SIP Tutorial 53 Aside: Alternative architecture: master-slave • master-slave: MGC (media gateway controller) controls one or more gateways • allows splitting of signaling and media functionality • “please send audio from circuit 42 to 10. call waiting May 2001 .1.3” • uses MGCP (implemented) or Megaco/H. but just beginning to be implemented) • gateway can be residential • basis of PacketCable NCS (network control system) architecture • service creation similar to digital PBX or switch • end system has no semantic knowledge of what’s happening • −→ can charge for caller id.

323 call agent MG controller SIP H.hgs/SIP Tutorial 54 MGCP/SIP architecture STP call agent MG controller SIP H.323 TCAP SS7 gwy ISUP SCP MGCP/Megaco MGCP/Megaco SS7 RGW TGW RTP RGW Internet PSTN May 2001 .

hgs/SIP Tutorial 55 Extending SIP extension new headers new headers new method new body type new status code new URL type behavior ignored mandatory determine? – Supported OPTIONS Accept ? class-based May 2001 .

mark with “Require: feature” • IANA-registered features are simple names.billing SIP/2.com SIP/2.example.hgs/SIP Tutorial 56 SIP extensions and feature negotiation • if crucial.billing Supported: 100rel Payment: sheep_skins.example.0 420 Bad Extension Unsupported: com. conch_shells SIP/2. private features use reverse domain names • indicate features supported in Supported: C->S: INVITE sip:watson@bell-telephone.0 Require: com.0 421 Extension Required Require: 183 S->C: S->C: May 2001 .

hgs/SIP Tutorial 57 User identification May 2001 .

purpose=icon.hgs/SIP Tutorial 58 Standard call/caller identification Request-URI: next hop To: logical call destination From: logical call origin Organization: organization of caller/callee Subject: subject of call Call-Info: additional information about caller or callee Call-Info: <http://wwww.purpose=info User-Agent: make and model of user agent May 2001 .com/alice/photo.com/alice/> .example.example.jpg> . <http://www.

non-urgent Alert-Info: render instead of ring tone Alert-Info: <http://wwww.com/sounds/moo. urgent. normal.wav> In-Reply-To: call-id being returned May 2001 .example.hgs/SIP Tutorial 59 Additional call information Priority: call priority: emergency.

return (calls).com>. user. alias.privacy=full • screen=yes: was verified by proxy • type can be subscriber. term (terminal) • may add geographic user location May 2001 .party=calling.hgs/SIP Tutorial 60 draft-ietf-sip-privacy • To/headerFrom are chosen by end system « may lie • need privacy indications similar to caller id Remote-Party-ID: "John Doe" <sip:jdoe@foo. id-type=subscriber.

hgs/SIP Tutorial 61 SIP services May 2001 .

hgs/SIP Tutorial 62 Invitation modes signaling unicast multicast media unicast multicast telephony multicast session reach first dept. conference « SIP for all modes. SAP/SDP also for multicast/multicast May 2001 .

plus extensions DTMF carriage: carry as RTP payload (RFC 2833) Calling card: B2BUA + voice server Voice mail: UA with special URL(s) + possibly RTSP May 2001 .0.0 – can be done individually per media Caller id: From.0.hgs/SIP Tutorial 63 SIP-based services Call forwarding: basic INVITE behavior (proxy/redirect) Call transfer: REFER method (see later) Call hold: set media address to 0.

hgs/SIP Tutorial 64 Call transfer B1 3 BYE A 1 REFER B2 Referred−By: B1 A 2 INVITE B2 Referred−By: B1 B2 May 2001 .

LDAP SIP REFER 200 SIP UA VoiceXML VoiceXML scripts text RTP text May 2001 .hgs/SIP Tutorial 65 IVR and VoiceXML A@ B@ C@ SQL.

hgs/SIP Tutorial 66 Third-party call control RTP 200 200 2 5 INVITE SDP (from 2) ACK SDP (from 4) INVITE no SDP 4 3 6 1 SIP SIP ACK May 2001 .

storage) How? • resource reservation protocols • SIP-in-DIAMETER approach • server log files May 2001 .hgs/SIP Tutorial 67 SIP billing/charging What for? • transport « resource reservation protocol • SIP services (call processing) « authentication • PSTN gateway services • media server services (translation.

hgs/SIP Tutorial 68 Security issues May 2001 .

hgs/SIP Tutorial 69 Threats • spoofing From in REGISTER: call redirection • spoofing From in INVITE: bypass call filtering • snooping media packets • billing confusion (identifier munging) • denial-of-service attacks May 2001 .

May 2001 . all or nothing. hard to configure adjacent nodes. all or nothing shared secrets with random parties securing headers? in progress Basic (plaintext password) and digest (challenge-response) are very similar to HTTP security mechanisms.hgs/SIP Tutorial 70 SIP security layer/mechanism network layer transport layer SIP INVITE SIP REGISTER SIP general approach IPsec TLS basic/digest basic/digest S/MIME characteristics adjacent nodes.

body with PGP. immediately or after 401 (Unauthorized) or 407 (Proxy Authorization) response Digest: challenge-response with shared secret Certificate: sign non-Via parts of request headers.hgs/SIP Tutorial 71 SIP authentication Basic: include plain-text password in request. PKCS #7 SSL. SSH: but only for TCP • but: need more elaborate cryptographic capability indication in SDP May 2001 .

hgs/SIP Tutorial 72 Basic authentication • Challenge by UAS: SIP/2.0 401 Unauthorized WWW-Authenticate: Basic realm="business" • client responds with INVITE sip:alice@wonderland.com SIP/2. but challenge can be in request May 2001 .0 CSeq: 2 INVITE Authorization: QWxhZGRpbjpvcGVuIHNlc2FtZQ== where authorization is base64(userid:password) • usually caller → callee.

domain="wcom. algorithm="MD5" • A tries again: INVITE sip:UserB@ss1.hgs/SIP Tutorial 73 Digest authentication • A calls B and fails: SIP/2. opaque="42". response="42ce3cef44b22f50c6a6071bc8" May 2001 . nonce="wf84f1ceczx41ae6cbe5aea9c8e88d359". stale="FALSE".0 Authorization:Digest username="UserA".com".wcom.com SIP/2. opaque="42". nonce="wf84f1ceczx41ae6cbe5aea9c8e88d359".0 401 Unauthorized Authenticate: Digest realm="GW service".wcom. uri="sip:UserB@ss1.com". realm="GW service".

hgs/SIP Tutorial 74 Digest authentication username: user authenticating herself realm: several per user. nonce-value : H(A2 )) for MD5: H(H(A1 ) : nonce-value : H(A2 ))) where A1 = username : realm : passwd A2 = method : uri May 2001 . used also for display nonce: copied into Authorization opaque: copied into Authorization uri: original request URL response: 32 hex digits: KD (H(A1 ).

hgs/SIP Tutorial 75 Quality of Service May 2001 .

hgs/SIP Tutorial 76 Quality of service • SIP and data paths disjoint « SIP can’t reserve resources • but: SDP may provide information to end systems on desired QoS • SDP contains range of codecs to allow mid-call adaptation May 2001 .

org 183 Session Progress (SDP) PRACK 200 OK (PRACK) reservation COMET 200 (COMET) 180 Ringing PRACK 200 OK (PRACK) 200 OK (INVITE) ACK (INVITE) UAC UAS May 2001 .hgs/SIP Tutorial 77 Interaction with resource reservation avoid “fast busy” after ringing « interleave INVITE alice@ieee.

hgs/SIP Tutorial 78 SIP Caller Preferences May 2001 .

hgs/SIP Tutorial


callee: scripts, CPL, REGISTER advice in Contact, . . . caller: help guide routing (“no home number”) and order of attempts when forking (“try videophone first, then phone, then answering service”) “caller proposes, callee disposes”

May 2001

hgs/SIP Tutorial


Extended SIP Contact header
q class description duplex feature language media mobility priority scheme service location preference business, residence show to caller full or half-duplex call handling features languages spoken audio, video, text/numeric, . . . fixed or mobile “only in case of emergency” URL schemes (tel, http, . . . ) IP, PSTN, ISDN, pager, . . .

May 2001

hgs/SIP Tutorial


Contact example
q=quality gives preference.
SIP/2.0 302 Moved temporarily Contact: sip:hgs@erlang.cs.columbia.edu ;action=redirect ;service=IP,voice-mail ;media=audio ;duplex=full ;q=0.7; Contact: tel:+1-415-555-1212 ; service=ISDN ;mobility=fixed ;language=en,es,iw ;q=0.5 Contact: tel:+1-800-555-1212 ; service=pager ;mobility=mobile ;duplex=send-only;media=text; q=0.1; priority=urgent; ;description="For emergencies only" Contact: mailto:hgs@cs.columbia.edu

May 2001

hgs/SIP Tutorial


Accept-Contact and Reject-Contact
• determine order of contacting users: Accept-Contact: sip:sales@acme.com ;q=0, ;media="!video" ;q=0.1, ;mobility="fixed" ;q=0.6, ;mobility="!fixed" ;q=0.4 « “avoid connecting me to sales; I prefer a landline phone; try • Reject-Contact: rule out destinations Reject-Contact: ;class=personal

May 2001

hgs/SIP Tutorial


• proxy or redirect • cancel ringing second phone after first picked up? • allow forking? • search recursively? • search sequentially or in parallel? • queue the call? Request-Disposition: proxy, recurse, parallel

May 2001

events and instant messaging May 2001 .hgs/SIP Tutorial 84 SIP presence.

com presence server PA alice@ example.com SUBSCRIBE UA NOTIFY registrar PUA PUA PA NOTIFY May 2001 .hgs/SIP Tutorial 85 SIP presence architecture presentity bob PUA REGISTER macrosoft.

alice@wonderland.g.. with several agents Registrar: receives REGISTER requests Presence user agent (PUA): generates REGISTER. generate NOTIFY Presence server: SIP proxy + PA Presence client: SIP UA + PA May 2001 .hgs/SIP Tutorial 86 SIP presence components Presentity: logical entity being subscribe to. but no SUBSCRIBE or NOTIFY « any non-presence-aware SIP software Presence agent: receive SUBSCRIBE. e.com.

PA bob SUBSCRIBE bob Event: presence From: alice To: bob 200 OK NOTIFY alice bob available 200 OK NOTIFY alice bob not available 200 OK May 2001 .hgs/SIP Tutorial 87 SIP presence protocol subcriber alice presentity.

com Call-ID: knsd08alas9dy@3.com From: sip:user@example.5.example.com SIP/2.com Contact: sip:user@userpc.0 Event: presence To: sip:bob@macrosoft. • 200 (OK) response contains current state.hgs/SIP Tutorial 88 SIP SUBSCRIBE example SUBSCRIBE sip:bob@macrosoft.4. May 2001 .6 CSeq: 1 SUBSCRIBE Expires: 3600 Content-Length: 0 • Forked to all PUAs that have REGISTERed with method SUBSCRIBE.

4.method=INVITE"> <status status="closed"/> </address> </atom> </presentity> </presence> May 2001 .com From: sip:alice@wonderland.dtd"> <presence> <presentity uri="sip:alice@wonderland.0//EN" "xpidf.method="SUBSCRIBE"> <atom id="779js0a98"> <address uri="sip:alice@wonderland.com Call-ID: knsd08alas9dy@3.com To: sip:user@example.hgs/SIP Tutorial 89 SIP NOTIFY example NOTIFY sip:user@userpc.6 CSeq: 1 NOTIFY Content-Type: application/xpidf+xml <?xml version="1.com.0"?> <!DOCTYPE presence PUBLIC "-//IETF//DTD RFCxxxx XPIDF 1.5.example.com.

1 process control packet audio/video 100 1 10 events (packets) / second • Event describes event type May 2001 .hgs/SIP Tutorial 90 SIP events • single-valued (light-switch) to complex (CD changer) to multi-valued (temperature samples) • both built-in and mediated (X10) • often combined with audio/video in same system: security. home entertainment • notification rates vary « gradual transition to continuous media IR detector 0. industrial control.01 temperature sensor 0.

home.net SIP proxy (RGW) (Work with Telcordia) May 2001 .net INVITE camera@alice.home.home.com SIP user agent DO light@alice.hgs/SIP Tutorial 91 Example home architecture SUBSCRIBE door@alice.net NOTIFY alice@work.

hgs/SIP Tutorial 92 SIP IM • send text or any other MIME type • either as SDP-initiated session or as individual messages • use MESSAGE May 2001 .

hgs/SIP Tutorial 93 Programming SIP Services May 2001 .

hgs/SIP Tutorial 94 Programming SIP services safety same as scripting same as Java very same as Java language? any Java XML Java party? callee callee both caller SIP-cgi servlets CPL applets May 2001 .

not generally for end users May 2001 .hgs/SIP Tutorial 95 Programming services • “caller proposes. allow mobile” • “try office and lab in parallel. forward to dial-a-joke” • phone: CTI = complex. callee disposes. if that fails. try home” • “allow call to mobile if I’ve talked to person before” • “if on telemarketing list. administrator decides” • web = static pages −→ cgi-bin −→ Java • “if somebody is trying to call for the 3rd time.

authentication. VB scripts May 2001 . . loop detection.hgs/SIP Tutorial 96 cgi-bin for SIP Servers • extend SIP user/proxy/redirect server functionality without changing server software • server manages retransmission. Tcl. . . • Perl.

hgs/SIP Tutorial 97 Examples • Call forward on busy/no answer • Administrative screening (firewall) • Central phone server • Intelligent user location • Third-party registration control • Calendarbook access • Client billing allocation (lawyer’s office) • End system busy • Phone bank tion/queueing) (call distribu- May 2001 .

hgs/SIP Tutorial 98 cgi Script Functionality called for any method except ACK or CANCEL • proxying of requests • returning responses • generate new requests once for each request or response or timeout May 2001 .

.hgs/SIP Tutorial 99 cgi Script Mechanism environment variables: headers. authenticated user. response. final response. never May 2001 . meta-requests: • CGI. stdin: body of request stdout: new request. . methods. default action • script cookie for state across messages • reexecute on all. .requests for proxying.

if (! defined( $to )) { fail("400". ’DB_File’. $reason) = @_. "Address database failure"). "Missing Recipient"). sub fail { my($status. exit 0.0 $status $reason\n\n". print "SIP/2. ’addresses. } tie %addresses. } May 2001 .hgs/SIP Tutorial 100 Cgi Example: Call Forwarding use DB_File.db’ or fail("500". $to = $ENV{’HTTP_TO’}.

0\n". # Close db file May 2001 . if (! defined( $destination )) { fail("404". print "CGI-Reexecute-On: never\n\n". untie %addresses. } print "CGI-PROXY-REQUEST-TO $destination SIP/2. "No such user").hgs/SIP Tutorial 101 $destination = $addresses{$to}.

2000 May 2001 .columbia.edu May 5.hgs/SIP Tutorial 102 The Call Processing Language Jonathan Lennox Columbia University lennox@cs.

hgs/SIP Tutorial 103 Purpose Allow users to create simple Internet telephony services Features: • Creatable and editable by simple graphical tools • Independent of signalling protocol • Safe to run in servers May 2001 .

com merge: clear redirect May 2001 .com proxy timeout: 10s timeout failure Call String-switch field: from match: *@example.hgs/SIP Tutorial 104 Abstract structure busy location url: sip:jones@ example. example.com otherwise location url: sip:jones@ voicemail.

based on outcome • Continue until we get to a node with no outputs May 2001 .hgs/SIP Tutorial 105 Abstract structure (cont) • Nodes and outputs — “boxes” and “arrows” • Nodes have parameters • Start from single root “call” node • Progress down tree of control • May invoke sub-actions • Follow one output of each node.

com"> <redirect /> </location> </subaction> May 2001 .hgs/SIP Tutorial 106 Textual representation <cpl> <subaction id="voicemail"> <location url="sip:jones@voicemail.example.

hgs/SIP Tutorial 107 Textual representation <incoming> <address-switch field="origin" subfield="host"> <address subdomain-of="example.com"> <location url="sip:jones@example.com"> <proxy> <busy> <sub ref="voicemail" /> </busy> <noanswer> <sub ref="voicemail" /> </noanswer> <failure> <sub ref="voicemail" /> </failure> </proxy> </location> </address> <otherwise> <sub ref="voicemail" /> </otherwise> </address-switch> </incoming> </cpl> May 2001 .

outgoing scripts are separate top-level tags • Nodes and outputs are both tags • Parameters are tag attributes • Multiple outputs to one input represented by subactions May 2001 .hgs/SIP Tutorial 108 Textual representation • Represent scripts as XML documents • Incoming.

Structure: <type-switch field=var> <type condition1="value1"> action1 </type> <type condition2="value2"> action2 </type> <not-present> action3 <otherwise> action4 </otherwise> </type-switch> May 2001 .hgs/SIP Tutorial 109 Switch nodes Switch nodes make decisions.

” “tel.hgs/SIP Tutorial 110 Address Switches: address Switch based on textual strings: is: (exact string match) contains: substring match: only for “display” subdomain-of: domain match: only for “host”.” “user.” “destination. “tel” Fields are “origin.” “display” May 2001 . with subfields “address-type.” “original-destination”.” “port.” “host.

organization. with conditions: is: exact string match contain: substring match Fields: subject. user-agent May 2001 .hgs/SIP Tutorial 111 String Switches: string Switch based on textual strings.

a2 − b2 . .hgs/SIP Tutorial 112 Time switches: time Switch based on the current time at the server. . timeofday • each condition is a list of ranges: a1 − b1 . day. month. • must fall within a range of all specified conditions May 2001 . timezone: which timezone the matching should apply in Conditions: • year. date. .

all day <time month="5" date="4"> May 4th. Monday through Friday. every week May 2001 . every year. 1999. all day <time day="1-5" timeofday="0900-1700"> 9 AM – 5 PM.hgs/SIP Tutorial 113 Time switches: examples <time month="12" date="25" year="1999"> December 25th.

1440-1555. 2:40 – 3:55 PM. and 4:10 – 5:25 PM.4"> 1:10 – 2:25 PM.hgs/SIP Tutorial 114 Time switches: examples <time timeofday="1310-1425. all day May 2001 . every week <time date="1-7" day="1"> The first Monday of every month.1610-1725" day="2. Tuesdays and Thursdays.

or clear the list May 2001 . or cascade locations • A CPL script has an implicit global list of locations • Location nodes can add to this list. redirect) take locations • Location nodes let you specify them • These are full-featured nodes because we might want to make decisions based on outcomes of location lookups.hgs/SIP Tutorial 115 Location nodes • A number of CPL actions (proxy.

Don’t use an explicit output node in the URL. May 2001 . cannot fail. url: explicitly specified location clear: clear earlier location values Only one output.hgs/SIP Tutorial 116 Simple location nodes: location Specify a location explicitly.

by where it should be looked up. notfound. Parameters: source: URL (ldap. http (CGI). etc) or non-URL source (“registration”) to search for locations timeout: time to wait use/ignore: • use: caller-preferences parameters to use • ignore: caller-preferences parameters to disregard merge: Outputs: success. failure May 2001 .hgs/SIP Tutorial 117 Location lookup nodes: lookup Specify a location abstractly.

param: caller preference parameters to apply value: values of parameters specified in “param” location: caller preference location to apply May 2001 . based on caller preferences/callee capabilities.hgs/SIP Tutorial 118 Location removal nodes: remove-location Remove locations from the location set. Has the same effect as a “Reject-Contact” header.

timeout: time before giving up on the proxy attempt recurse: recurse on redirect responses to the proxy attempt? ordering: try location in parallel. and automatically select one “best” final response.hgs/SIP Tutorial 119 Signalling Actions: proxy Proxy the call to the currently-specified set of locations. noanswer. first-only • Outputs: busy. failure • If the proxy attempt was successful. sequential. script terminates May 2001 .

May 2001 . This has no specific parameters.hgs/SIP Tutorial 120 Signalling Actions: redirect Redirect the call to the currently-specified set of locations. and causes the script to terminate.

This causes the script to terminate.” “reject. or a 4xx. May 2001 . reason: string explaining the failure. 5xx. status: “busy.” “notfound.hgs/SIP Tutorial 121 Signalling Actions: reject Reject the call attempt.” or “error”. or 6xx code (for SIP).

hgs/SIP Tutorial 122 Non-signalling action: mail Notify a user of something through e-mail. including any header parameters. May 2001 . url: the address to contact.

hgs/SIP Tutorial 123 Non-signalling action: log Store a record of the current call in a log. name: the name of the log this should be stored omment: a string explaining the log entry Outputs: success. failure May 2001 .

• for acyclicity. you can instead have a sub tag. May 2001 . we want CPLs to be represented as directed acyclic graphs. outside other actions.hgs/SIP Tutorial 124 Subactions • XML syntax defines a tree. with a ref parameter which refers to a subaction’s id. • Subactions are defined at the top level of the script. top-level actions and subactions may only call subactions which were defined earlier in the script. • Anywhere a node is expected.

hgs/SIP Tutorial 125 Example: Call Redirect Unconditional <cpl> <incoming> <location url="sip:smith@phone.example.com"> <redirect /> </location> </incoming> </cpl> May 2001 .

hgs/SIP Tutorial 126 Example: Call Forward Busy/No Answer <cpl> <subaction id="voicemail"> <location url="sip:jones@voicemail.com" > <proxy /> </location> </subaction> <incoming> <location url="sip:jones@jonespc.com"> <proxy timeout="8s"> <busy> </busy> <noanswer> <sub ref="voicemail" /> </noanswer> </proxy> </location> </incoming> </cpl> May 2001 .example.example.

hgs/SIP Tutorial 127 Example: Call Screening <cpl> <incoming> <address-switch field="origin" subfield="user"> <address is="anonymous"> <reject status="reject" reason="I don’t accept anonymous calls" /> </address> </address-switch> </incoming> </cpl> May 2001 .

dtd"> <cpl> <incoming> <time-switch timezone="US/Eastern"> <time day="1-5" timeofday="0900-1700"> <lookup source="registration"> <success> <proxy /> </success> </lookup> </time> <otherwise> <location url="sip:jones@voicemail.hgs/SIP Tutorial 128 Example: Time-of-day Routing <?xml version="1.example.com"> <proxy /> </location> </otherwise> </time-switch> </incoming> </cpl> May 2001 .0" ?> <!DOCTYPE call SYSTEM "cpl.

dtd"> <cpl> <incoming> <lookup source="http://www.example.com&Subject=lookup%20failed" /> </failure> </lookup> </incoming> </cpl> May 2001 .cgi?user=jones" timeout="8"> <success> <proxy /> </success> <failure> <mail url="mailto:jones@example.hgs/SIP Tutorial 129 Example: Non-call Actions <?xml version="1.0" ?> <!DOCTYPE call SYSTEM "cpl.com/cgi-bin/locate.

hgs/SIP Tutorial 130 SIP for Third-Generation Wireless Networks May 2001 .

TD-CDMA • 3GPP standardizes for W-CDMA (GSM follow-on). while 3GPP2 does CDMA 2000 • identified by releases (1999. R4. R5) May 2001 .hgs/SIP Tutorial 131 3G networks • successor to 2G mobile networks: GSM (TDMA) and IS-95 (CDMA) in 900/1800 MHz range • 2. CDMA 2000.5G: GSM −→ GPRS −→ EDGE • use different air interfaces in 2 GHz range: W-CDMA.

CS voice to base station.932 May 2001 . in Internet multimedia (IM) subsystem « IP to UE (user equipment) • uses AMR audio codec.75 to 12. with variable rate of 4. or GSM HR or EFR • UTRAN delays: see TR 25.2 kb/s. then ATM/IP packets • later (R5).hgs/SIP Tutorial 132 3G and VoIP • GPRS not suitable for VoIP: low bandwidth. high delay (500-600 ms RTT) • initially (R4).

Accesses the user’s profile. contacts the HSS and forwards SIP request. can be located in the home or visited network. acts as registrar and triggers and executes services. May 2001 . Interrogating CSCF: first point of contact in home network. It assigns the serving CSCF. finds the user’s home network and provide some translation. security and authorization functions Serving CSCF: controls sessions.hgs/SIP Tutorial 133 Signaling in 3GPP IM subsystem Uses SIP for session setup and defines new entities: Proxy CSCF: first point of contact in visited network.

hgs/SIP Tutorial 134 3G SIP registration mobility management signaling serving CSCF proxy interrogating interrogating home IM domain registration signaling (SIP)_ visited IM domain May 2001 .

hgs/SIP Tutorial 135 Differences to “standard” SIP • requires REGISTER before making call • INVITE uses authentication information provided by REGISTER « Path header • always visit I/P/S for “home” services • compression on link from UE to P-CSCF May 2001 .

hgs/SIP Tutorial 136 RFCs draft-ietf-sip-rfc2543bis-03 RFC 3087 RFC 3050 RFC 2916 RFC 2833 RFC 2806 RFC 2543 base protocol spec Control of Service Context using SIP Request-URI Common Gateway Interface for SIP E. Telephony Tones and Telephony Signals URLs for Telephone Calls SIP: Session Initiation Protocol May 2001 .164 number and DNS RTP Payload for DTMF Digits.

cs.html RTP: http://www.hgs/SIP Tutorial 137 For more information.edu/sip SDP: http://www.columbia.cs.edu/IRT May 2001 .columbia. .columbia. SIP: http://www.edu/˜hgs/rtp Papers: http://www.edu/˜hgs/internet/sdp.cs.columbia.cs. .