Session Initiation Protocol

Transcription

1 Session Initiation Protocol G.Vanwormhoudt 1 Préambule (1) Evolution RTC (1ère gen) vers Réseaux Intelligents Réseaux Intelligents Introduction de l informatique dans les réseaux téléphoniques avec pour objectif création de services à valeur ajoutée Même fonctions dans le réseau téléphonique globale que le CTI (Computer Telephony Integration) dans l entreprise Centre d appel, gestion téléphonie personnelle, messagerie unifié, filtrage des appels, Signalisation puissante et sophistiquée (SS7) 2

2 Préambule (2) Irruption de la téléphonie sur les réseaux de données (IP) Circuits Paquets Réseaux Intelligents? Réseaux IP Applications Telecoms Quid des procédures de signalisations dans le monde IP? => Next Generation Network 3 Signalisation sur IP «La signalisation concerne l ensemble des informations échangés par les terminaux, les entités de contrôle et les gateways participant à toutes les phase d établissement de contrôle et de rupture de la connexion» [Susbielle99] Protocoles de signalisation existants Réseau intelligent : SS7 Réseau IP : H323, SIP, MEGACO, SIGTRAN Sur IP, les échanges de signalisation se font au niveau applicatif => pas de participations des routeurs et commutateurs 4

3 Généralités SIP Session Initiation Protocol Internet Engineering Task Force RFC2543, RFC3261, RFC3262, RFC3263, RF3264, Historique: 1997 (Columbia university), 1999 (SIP Working group) Protocole de signalisation applicatif (niveau 7) utilisé pour l établissement, la modification et la terminaison de sessions multimédias sur Internet Applications Téléphonie IP (fonctions analogues à SS7) Audio/Vidéo conférence Services multimédia à la demande Jeu, Domotique, Messagerie instantanée, Pilotage d appareils,.. 5 Vue générale Infrastructure SIP messages SIP messages SIP Internet messages SIP flux multimédia Alice s Bob s SIP Phone 6

4 Caractéristiques Protocole client/serveur de type requête/réponse Protocole transactionnel Toute opération SIP se compose d une série de messages (requête/réponse) Protocole orienté Internet Messages émis en mode texte Inspiration SMTP/HTTP compatible RFC 822 (mode texte / UTF-8) Indépendant de la couche transport TCP, UDP, UDP multicast 7 SIP et les autres protocoles IP 8

5 Fonctionnalités Localisation du(des) participant(s) à la session terminaux multiple, mobilité, identifiant unique,... Gestion de la disponibilité mise en attente, transfert, déviation (traitements sophistiqués) Gestion des capacités configuration, négociation des paramètres de la session, hétérogénéité des terminaux Etablissement de la session mise en relation des deux participants Gestion de la session modification, terminaison 9 Ce que SIP ne fait pas Ne décrit pas les sessions Ne contrôle pas les conférences Ne contrôle pas les passerelles Ne réserve pas les ressources pour la session Peut être utilisé conjointement avec d autres protocoles qui réalisent ses taches RTP RTSP SDP MEGACO... et autres 10

6 Les couches de SIP Transaction User layer (traitement applicatif, creation session) Transaction layer (gestion transactions, retransmission) Transport Layer (connection/déconnection, envoi/reception) Syntax and encoding layer (analyse et formatage messages) 11 Entités d une architecture SIP 1 Agent Utilisateur Client et Serveur Points finaux capables d émettre ou de recevoir des requêtes (resp. réponses) SIP Participants à une session SIP Types d agent serveur Personne physique, machine, enregistreur de message, serveur vidéo à la demande,... Serveur de localisation Offre des services pour obtenir et mettre à jour des informations sur le destinataire (adresse actuelle et multiple, droit, mot de passe, disponibilité,...) Entité utilisée par les serveurs proxy et serveurs de redirection 12

7 Entités d une architecture SIP 2 Serveur proxy Entité intermédiaire active qui est à la fois client et serveur Retransmet les requêtes vers le destinataire (Routage) en s appuyant sur son service de localisation Traite les requêtes (analyse pour authentification, transformation, multi-diffusion,..) Mode opératoire stateless, call statefull, transaction stateful Serveur de redirection Reçoit des requêtes et renvoie à l émetteur une ou plusieurs adresses pour contacter le destinataire (régulation charge) A la différence du serveur proxy, ce serveur n initie pas de requêtes 13 Exemple d architecture SIP Non SIP Protocol SIP Request SIP Response SIP Redirect Server Location Information Service Sip proxy 11 Sip proxy (Registrar) 10 Sip proxy 8 9 User Agent A User Agent B Fig 2 14

8 Adresse SIP SIP exploite des formats d adresses de type user_id@host_name user_id peut être un individu, un groupe, un service,... Différents formes possibles user@domain vanwormhoudt@enic.fr user@host vanwormhoudt@gva.enic.fr user@ip_adress service1@ phone-number@gateway @passerelle.fr Résolution des adresses (directe, via DNS, SMTP) 15 URLs SIP Utilisé dans les requêtes (entête From, To, Contact) Intégration dans des pages HTML, s sip: domaine paramètres en-têtes infos_utilisateur (nom de l utilisateur:mot de passe) ou (numéro téléphone, si user=phone) domaine nom de domaine ou nom d hôte ou adresse IP: port paramètres en-têtes Exemples : ;transport=udp ou tcp ;user=phone ou IP ;method=invite, ACK, OPTIONS, BYE, CANCEL, REGISTER ;ttl=0 à 255 (time-to-live d un paquet IP multicast) ;maddr=adresse IP multicast ;tag=compteur? par1=valeur1 & par2=valeur2 & par3=valeur3... sip:meddahi@enic.fr sip: @passerelle.fr;user=phone 16

9 Message SIP Format générique des messages SIP - RFC822 (HTTP aussi) (Requête et réponse) Ligne de début En-tête message ligne vide Corps Message 17 Exemple de message SIP INVITE sip:pascal@int.fr SIP/2.0 Via: SIP/2.0/UDP gva.enic.fr; Max-Forwards: 70 To: Pascal<sip:pascal@int.fr> From: Vanwormhoudt<sip:vanwormhoudt@enic.fr>; Call-ID: a84b4c76e66710@gva.enic.fr CSeq: 1 INVITE Contact:<sip:vanwormh@gva.enic.fr> Content-Type: application/sdp Content-Length: 142 Ligne de début En-tête o=gva IN IP s=heure? e=gva@enic.fr c=in IP m=audio 3000 RTP/AVP 0 3 Corps 18

10 Requête SIP méthode URL SIP/2.0 Ligne début Via: From: To: Call-ID: Cseq: Content-Length Content-Type: Champ: SIP/2.0/protocole hôte:port username username numéro_seq méthode longueur du corps type de média du corps paramètre ;par1=valeur; par2= valeur En-tête message ligne vide V=0 o= user_origine timestamp timestamp IN IP4 hôte c=in IP4 média adresse_destination t=0 0 m= type_média port RTP/AVP types_payload Corps message 19 Méthodes de requête 1 Méthode REGISTER Gestion (ajout, maj, suppression) des liaisons (identifiant agent utilisateur, adresse contact) enregistrées dans le service de localisation Egalement utilisé pour interroger le service de liaison (serveur proxy, redirection) L agent utilisateur doit indiquer la durée de vie de la liaison L agent utilisateur est également responsable du rafraichissement de la liaison Méthode OPTIONS Permet d obtenir des informations sur les capacités d un agent utilisateur ou d un serveur sans avoir besoin d établir une session Informations : méthodes supportées, extension, type contenu,.. Peut être émis en dehors ou à l intérieur d une session 20

11 Méthodes de requête 2 Méthode INVITE Initie une session en invitant un agent utilisateur à une conférence ou à simple appel Le corps du message contient généralement une description de la session (utilisation de SDP: type de média audio, vidéo, data, format, codage en vigueur) Méthode ACK Indique que l appelant a reçu une réponse finale à l invitation Le corps du message peut contenir la description finale de la session (négociation des capacités) Un corps vide indique que la description du message Invite sera utilisée 21 Méthodes de requête 3 Méthode CANCEL Annule un requête (Invite) émise par l appelant Requête «Hop-by-hop» Doit être utilisé après la réception d une première réponse Utilisé par les serveurs proxy lors de recherches parallèles de localisation Méthode BYE indique à l autre participant que la session doit se terminer Autres méthodes UPDATE - mise à jour de la Session PRACK (RFC3262) - ACK for Provisional Responses SUBSCRIBE & NOTIFY (RFC3265) - Service de présence 22

12 Réponse SIP SIP/2.0 status reason-phrase type réponse Via: From: To: Call-ID: Cseq: Content-Length Content-Type: Champ: SIP/2.0/protocole hôte:port username username numéro_seq méthode longueur du corps type de média du corps paramètre ;par1=valeur; par2= valeur en-tête message ligne vide V=0 o= user_origine timestamp timestamp IN IP4 hôte c=in IP4 média adresse_destination t=0 0 m= type_média port RTP/AVP types_payload corps message 23 Statut des réponses 1xx : information sur le traitement des requêtes 100 trying, 180 ringing 2xx : succès 200 Ok 3xx : redirection 300 multiples choices, 302 moved temporarily 4xx : erreur client 401 unauthorized, 404 not found 5xx : erreur serveur 501 not implemented, 503 service unavailable 6xx : erreur globale 600 busy, 601 decline, 606 not acceptable 24

13 Exemples de réponse SIP/ OK Via: SIP/2.0/UDP sip-proxy.int.fr Via: SIP/2.0/UDP gva.enic.fr; Max-Forwards: 70 To: From: Call-ID: CSeq: 1 INVITE Contact:<sip:vanwormh@gva.enic.fr> Content-Type: application/sdp Content-Length: 142 Ligne de début En-tête o=pascal IN IP s=ok c=in IP4 goujon.int.fr m=audio 3000 RTP/AVP 0 3 Corps 25 Principaux champs d entêtes TO: URL-SIP de la destination From: URL-SIP de la source Call-ID: identifiant de session (vers.simple local-id@host) Maxforward: nombre max de sauts pour traiter le message Cseq(Command Sequence) : Numéro de transaction dans la session + méthode Via: route empruntée par un message jusqu à ce noeud prévention des boucles, garantie le chemin de retour (billing,...) Contact : pour l enregistrement d informations (Register) ou le reroutage Content-type : type de média du corps (application/sdp)... 26

14 Session Description Protocol SIP utilise le protocole SDP (session description protocol, RFC 2237) SDP est employé pour définir les attributs d une session SIP avec une syntaxe standard Echange des capacités des terminaux Les paramètres SDP sont placés dans le corps d une requête SIP Les entêtes SDP sont encodées en format text et sont de la forme <champ>=<valeur>. Le <champ> est toujours un simple caractère et la <valeur> est une chaine de caractères formatée selon le champ 27 Quelques champs SDP o owner/creator /session id propriétaire/créateur de la présentation s session name nom de la session b bandwith (kbps) bande passante a media attributes attributs de médias m session attributes attributs de session, description de média c information connection information sur la connexion (PSTN, IP) 28

15 Exemple SDP v=0 o=gva IN IP s=inquiry c=in IP m=audio 3000 RTP/AVP 0 m=video 4000 RTP/AVP Etablissement d une session Mode point à point meddahi@ gva@ INVITE gva@ SIP 180 Ringing SIP 200 OK! ACK! COMMUNICATION BYE SIP 200 OK User Agent Client User Agent Server 30

16 Etablissement d une session avec localisation 1 1. Enregistrement de la localisation Identifiant d appel: <sip:alice@home.com> Alice enregistre son identifiant et son adresse actuelle dans le proxy de son domaine office.com Proxy REGISTER home.com SIP/2.0 To: sip:alice@home.com Contact: sip:alice@m2.home.com alice bob alice@home.com => alice@m2.home.com m2.home.com home.com 31 Etablissement d une session avec localisation 2 2. Appel (phase 1) Bob appelle Alice en utilisant alice@home.com Résolution DNS coté client office.com bob DNS lookup for sip.udp.home.com Resolve to pc4.home.com alice pc4.home.com m2.home.com home.com 32

17 Etablissement d une session avec localisation 3 2. Appel (phase 2) Envoi de la requête Invite sur le réseau office.com bob INVITE sip:alice@home.com To: sip:alice@home.com From: Bob <sip:bob@office.com> c=in IP m=audio 8000 RTP/AVP User agent client alice pc4.home.com m2.home.com home.com 33 Etablissement d une session avec localisation 4 3. Traitement de la requête par le proxy - Recherche de la localisation à partir de l identifiant - Retransmission vers l adresse actuelle d Alice office.com bob INVITE sip:alice@m2.home.com To: sip:alice@home.com From: Bob <sip:bob@office.com> Proxy pc4.home.com m2.home.com home.com alice 34

18 Etablissement d une session avec localisation 5 4. Attente du correspondant Le correspondant a été trouvé, son poste est en train de sonné L attente est traduite par une réponse Ringing office.com bob Proxy SIP/ Ringing alice pc4.home.com m2.home.com home.com 35 Etablissement d une session avec localisation 6 5. Etablissement de la session Quand l appel est accepté par Alice, la réponse OK est retournée à Bob L UAC de Bob accuse réception de la réponse avec un message ACK office.com bob ACK sip:alice@home.com To: sip:alice@home.com From: Bob <sip:bob...> c=in IP SIP/ OK c=in IP m=audio 9000 RTP/AVP 0 8 pc4.home.com m2.home.com home.com alice 36

19 Etablissement d une session avec localisation 7 6. Transmission des flux multimédia Paquets RTP audio office.com alice bob home.com 37 Etablissement d une session avec localisation 8 7. Fin de la session - Quand l un des 2 participants met fin à la session, la requête BYE est envoyée office.com BYE sip:bob@office.com alice bob home.com 38

20 Sequence des messages avec plusieurs proxys 39 Etablissement d une session mode redirect sip.enic.fr int.fr INVITE gva@enic.fr SIP 301 Moved Temporarily ACK Redirection Server Location Server Internet bob@ INVITE gva@ SIP 180 Ringing REGISTER SIP 200 OK ACK 40

21 Exemple de scénario possible avec SIP 1 5 SIP Server Lucent.com Bob@lab.columbia.edu Internet Backbone SIP Server columbia.edu Jack@att.com 16 9 Bob@office.columbia.edu 41 Exemple de scénario possible avec SIP 2 Description du scenario Bob a trois bureaux, un chez Lucent et deux à l université Columbia où il enseigne (bureau et lab) Bob publie une seule identifiant d appel: bob@lucent.com Un jour, Bob est à l université et enregistre sur le serveur SIP de Lucent l adresse bob@columbia.edu (1) Il enregistre aussi sur le serveur de Columbia, ses deux adresses à Columbia (2, 3) bob@office.columbia.edu, bob@lab.columbia.edu Le jour suivant, Bob configure son poste de labo pour qu il redirige automatiquement l appel vers son adresse chez lucent, oubliant les enregistrements précédents 42

22 Exemple de scénario possible avec SIP 3 Plus tard le même jour, jack@att.com appel bob@lucent.com (4) (résolution DNS = Serveur SIP Lucent) Le serveur SIP de Lucent localise l adresse courante de bob (5) et retransmet donc l appel à bob@columbia.edu (6) Le Service SIP de Columbia détermine qu il existe deux adresses possibles (7) et diffuse l appel (i.e «fork») vers celles-ci (8,9) Le poste de labo selon sa configuration redirige l appel vers le serveur SIP de Lucent qui détecte une boucle et retourne une erreur (10,11) L erreur est propagée par le poste au serveur SIP de Columbia (12) Dans le même temps, Bob a répondu à l appel depuis son bureau (13) 43 Exemple de scénario possible avec SIP 4 Le serveur SIP de Columbia a maintenant les deux réponses et peut retourné l acceptation de l appel au Serveur SIP de Lucent (14) qui fait de même vers l agent de jack (15) A ce stade, Les serveurs peuvent détruire les états liés à l appel Jack et Bob communique directement sans passer par les serveurs intermédiaires (16) Caractéristiques de SIP mises en évidence par ce scénario Forking Mobilité utilisateur Détection de boucle 44

23 Programmation de services SIP 1 " Solutions suggérées par l IETF SIP Call Processing Language ( SIP CPL ) Langage de scripts pour décrire des services d appels Syntax XML, extensible, éditable // Script qui intercepte les appels anonymes - <?xml version="1.0"?> <!DOCTYPE cpl PUBLIC "-//IETF//DTD RFCxxxx CPL 1.0//EN" "cpl.dtd"> <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> Scritp interprété par le serveur SIP Call not match match actions 45 Programmation de services SIP 2 - SIP Common Gateway Interface ( SIP CGI ) similaire au CGI-HTTP Indépendant du langage (Perl, Tcl, C, C++,...) activation d un exécutable réalisant le service Passage des parametres à travers les variables d environnement // traite tout appel du boss comme urgent if (defined $ENV{SIP_FROM} && $ENV{SIP_FROM} =~ /sip:boss@mycompany.com/) { foreach $reg (get_regs()) print "CGI-PROXY-REQUEST $reg SIP/2.0\n"; print "Priority: urgent\n\n"; } 46

24 Programmation de services SIP 3 SIP Servlet similaire aux servlets HTTP - même propriété Encapsulation des messages SIP dans des objets Java, Multithreading Portabilité entre les OS et les serveurs public class RejectServlet extends SipServletAdapter { public boolean doinvite(siprequest req) { SipResponse res = req.createresponse(); res.setstatus(603); res.send(); return true; } } Autre effort : JAIN (cf suite du cours) 47 Passerelle PSTN <-> SIP (1) Telephone subscriber Telephone network SIP/PSTN gateway SIP server IP endpoint #Traduction audio (PCMU/PCMA) #Traduction du signal (PRI/T1,ISUP) #Overlap signaling #Perte des caractéristiques avancées de SIP in PSTN #Traduction des identifiers (numéro tel.) # xxxx 48

25 Passerelle PSTN <-> SIP (2) Au debut de la communication la passerelle reçoit ISUP (Protocole de signalisation) du PSTN et emploie l'encapsulation et la traduction dans les messages SIP envoyés au travers du réseau VoIP. Pour le proxy l utilisation du contenu de l'isup est donc ignoré et seulement le contenu de SIP est transféré au téléphone SIP. 49 Agents SIP existants EZ-Phone Ubiquity SIP Phone 50

26 Conclusion sur SIP Autres aspects de SIP non abordés Sécurity (Authentification, cryptage d entête, du contenu) Qualité de services Pas de réservation des ressources Combinaison avec d autres protocoles: RSVP, COPS (SDP) Présence (SUBSCRIBE, NOTIFY méthodes,...) Préférences d appels Essayer vidéophone d abord, ensuite le téléphone, enfin la messagerie Extension du champ CONTACT Conference, Facturation Plus d infos sur JAIN - SIP Gilles Vanwormhoudt 52

27 Java API for Integrated Networks 1 JAIN est un ensemble d API Java pour le développement rapide de produits/services de télécoms de la prochaine génération (25 API spécifiés par plus de 80 companies) Objectifs Portabilité des services (Write Once, Run anywhere) Abstraction des réseaux pour les applications: (Any network) réseaux paquets (IP), réseaux circuits (PSTN) et réseaux sans fils Accès réseau sécurisé : ouverture controlée et sécurisée des capacités du réseaux aux applications Java Vision de JAIN Faire évoluer le domaine des télécommunications qui repose sur une architecture de boites matérielles et logicielles propriétaires vers une architecture ouverte où les services peuvent être rapidement créés et déployés, peu importe la plateforme et le réseau 53 JAIN 2 54

28 Architecture de JAIN 55 Couches d abstraction JAIN Telecomm. Wireless IP Couche service Service Control Point (SCP) Base station controller, Home Location Register,... Serveur d applications Internet Couche signalisation Signaling Service Point (SSP) Mobile Switching Center (MSC) Proxy, Redirect, H323 Gatekeeper,... Couche réseau Réseau intelligent, SS7, ISUP, TCAP SS7 avec applications mobiles (MAP) SIP,MGCP, Megaco, H323 56

29 APIs JAIN 1 57 APIs JAIN 2 58

30 JAIN Protocol API JAIN SS7 API Fournit des API pour permettre à une application développée en Java (ex. SCP et SSP) d accéder aux services fournis par SS7 Protocoles supportés: TCAP, ISUP, MAP, INAP JAIN IP API Fournit des API pour permettre à une application développée en Java (ex: Media gateway, Call Agent, Proxy, Gateway controller) d établir des communications avec différents protocoles IP Protocoles supportés : H323, MGCP, SIP 59 Principes Architecturaux de JAIN Protocol API Application Listener Stack Event JAIN Protocol Layer Provider Protocol Stack 60

31 JAIN JCC/JCAT API JCC (Java Call Control) API API pour le contrôle d appel en Java Création, observation, manipulation, traitement des appels Basé sur un modèle d appel générique supportant des sessions multi-médias, multi-parties et multi-protocoles JCAT (Java Coordination and Transaction) API API pour l invocation des services/applications avant, durant et après les appels ainsi que pour le traitement des paramètres d appels 61 JAIN JCC/JCAT API 62

32 Concepts de JCC/JCAT 1 JCC/JCAT API 63 Concepts de JCC/JCAT 2 64

33 JAIN SLEE : Service Logic Execution Environnement 1 Environnement d exécution générique des services/applications JAIN (Gateway, Proxy, SCP, SSP) Rôle analogue aux serveurs d applications d entreprise (exemple conteneur EJB, conteneur Web) Conçu et optimisé pour ce type de services/applications Gestion des évènements très efficace, invocation asynchrones, transactions légères, Fournit des fonctionnalités communes Transaction, persistence, régulation de charge, sécurité Facilite le déploiement dynamique de services, leur administration et leur maintenance Fournit une interface JAIN Parlay pour les services à l extérieur du réseau (untrusted services) 65 JAIN SLEE : Service Logic Execution Environnement 2 66

34 JAIN SLEE : Service Logic Execution Environnement 3 67 JAIN et SIP JAIN-SIP API de bas niveau basée sur le RFC 2543 JAIN-SIP Lite API de haut niveau pour créér un agent SIP JAIN-SIP Servlet API pour programmer des servlets SIP 68

35 JAIN-SIP Interface JAVA standard qui encapsule une pile de signalisation SIP Spécification JSR - SUN Historique: JSR Approval 1999, Final Aout Spécification actuelle : 1.2 Offre les abstractions du protocole SIP sousforme d objets JAVA Permet à une application/une servlet ou un bean d embarquer un pile SIP et d accéder à des fonctionnalités d appel de bas niveau. 69 JAIN-SIP Simplifie la construction des entités SIP Agents Utilisateurs, Serveurs Proxy, Serveur de redirection JAIN SIP peut être utilisé dans un agent utilisateur ou un proxy Garantit la portabilité des applications entre pile JAIN-SIP via la définition des interfaces et le comportement à l exécution (TCK test suite) 70

36 Architecture de JAIN-SIP SIPListeners SIPListeners Messages SIP Evénements Messages SIP Evénements SIPProvider SIPProvider SIPStack Réseau SIPStack Agent Client Agent Serveur 71 Responsabilités de l application L application doit utiliser l interface du provider pour tous accès à la pile (pas d accès directe aux couches sousjacentes) L application doit enregistrer auprès de la pile un ou plusieurs objets implantant l interface SipListener L application est notifiée de l arrivée de message SIP, elle est responsable des réponses Pour une mode sans état, l application est responsable du traitement de retransmission en cas de timeout lié à un message 72

37 Responsabilités de la pile Offre des méthodes pour formater et envoyer des messages SIP Analyse les messages SIP entrants et en construit un représentation sous forme objets que l application peut accéder et modifier à travers des interfaces Java standardisés Invoque les gestionnaires d événements de l application quand un événement intéressant se produit Fournit le support des transactions Gère les transactions et les dialogues pour l application 73 Vue interne de la Pile SIP 74

38 Paquetages JAIN-SIP jain.protocol.ip.sip SipStack, SipProvider, SipListener,... jain.protocol.ip.sip.header: Fabrique d entêtes, interfaces pour chaque entête SIP supportée jain.protocol.ip.sip.message Fabrique de messages : Message, Request, Response jain.protocol.ip.sip.address Fabrique d adresses : Analyse et construction d adresses URL 75 Abstractions JAIN-SIP 1 jain.protocol.ip.sip.sipfactory: Fabrique pour construire l objet implantant la Pile et les autres fabriques d objets jain.protocol.ip.sip.sipstack Analyse les messages entrants et génère les évènements associés Gère les transactions et génére des événements timeout associés Les objets transactions ne sont pas directement accessibles par l application 76

39 Abstractions JAIN-SIP 2 jain.protocol.ip.sip.listeningpoint Correspond à l adresse de la pile (UDP/TCP) C est l adresse IP et le port à partir desquels la pile recoit et envoie les messages La pile peut être configurée pour un ou plusieurs Listeningpoint jain.protocol.ip.sip.provider Fournit des facilités pour le programme d application (sendrequest, sendresponse, sendack ) 77 Fabriques d objets SipFactory +getinstance +setpathname +createsipstack +createaddressfactory +createheaderfactory crée MessageFactory +createrequest SipStack crée SipProvider +addsiplistener +getnewcallidheader +sendack +sendrequest +sendresponse +createsipprovider +getlisteningpoints * ListeningPoint AddressFactory +createsipurl +createnameaddress HeaderFactory +createfromheader +createtoheader +createviaheader +createcontenttypeheader +createcseqheader +gethost +getport 78

40 JAIN SIP Object Architecture Fonction Initialisation createlistener() SIP Listener getinstance() SIP Factory Event Registration createprovider() createstack() Pile SIP Réseau SIP SIP Provider Stack Pile SIP Propriétaire 79 Abstractions JAIN-SIP 3 jain.protocol.ip.sip.message.message Représente un message SIP Interface pour extraire le type, les entêtes et le contenu du message Interface pour construire un message jain.protocol.ip.header.header Représente une entête d un message SIP Entête général : inclus dans requête ou réponse Entête de requête Entête de réponse Entête d entité : decrit le corps du message SIP 80

41 Messages SIP Message +getcallidheader() +getbodyasstring() CallIdHeader +getcallid() : String Request +getmethod() : String Response +getstatuscode() : int MessageFactory +createrequest(uri, method, ) +createresponse(status, request,..) 81 L interface SipListener 1 Tout programme d applications JAIN-SIP doit implanter l interface jain.protocol.ip.sip.siplistener Un programme peut être client et serveur (proxy) public interface SipListener extends java.util.eventlistener { public void processresponse(sipevent responsereceivedevent); public void processrequest(sipevent requestreceivedevent); public void processtimeout(sipevent transactiontimeoutevent); } SipEvent représente une événement transmis à tous les listeners (accès identifiant transaction + message) 82

42 L interface SipListener 2 <<interface>> SipListener +processrequest( :SipEvent ) +processresponse( :SipEvent ) +processevent( :SipEvent ) Abonné Notifie SipProvider +addsiplistener( :SipListener ) MonApplicationSip +processrequest( :SipEvent ) +processresponse( :SipEvent ) +processevent( :SipEvent ) SipEvent +gettransactionid() : long +getmessage() : Message 83 Squelette d applications JAIN-SIP 1 1. Creation d une instance de SIPFactory sipfactory = SipFactory.getInstance(); sipfactory.setpathname("gov.nist"); 2. Creation d une instance de pile SIP try { sipstack = sipfactory.createsipstack(); } catch(sippeerunavailableexception e) { System.exit(-1); } catch(sipexception e) { System.exit(-1); } 84

43 Squelette d applications JAIN-SIP 2 3. Création des fabriques d entête et de messages HeaderFactory headerfactory = sipfactory.createheaderfactory(); AddressFactory addressfactory = sipfactory.createaddressfactory(); MessageFactory messagefactory = sipfactory.createmessagefactory(); 4 Création d un provider associé à un port Listening listeningpoint = sipstack.createlisteningpoint(port,format); SipProvider sipprovider = sipstack.createsipprovider(listeningpoint); 85 Squelette d applications JAIN-SIP 3 5 Construction & envoi des messages 5.1 Construction des entêtes du message fromaddress = addressfactory.createsipurl("caller", sipprovider.getlisteningpoint().gethost()); fromaddress.setport(sipprovider.getlisteningpoint().getport()); fromnameaddress = addressfactory.createnameaddress ("Caller", fromaddress); fromheader = headerfactory.createfromheader(fromnameaddress); contenttypeheader = headerfactory.createcontenttypeheader("application", "sdp");... 86

44 Squelette d applications JAIN-SIP Construction du message callidheader = sipprovider.getnewcallidheader(); cseqheader = headerfactory.createcseqheader(1,request.invite); invite = messagefactory.createrequest(requesturi, Request.INVITE, callidheader,cseqheader, fromheader, toheader, viaheaders); invite.setbody("b=32000", contenttypeheader); 87 Squelette d applications JAIN-SIP Envoi de messages transactionid = sipprovider.sendrequest(invite); // Le résultat d une émission de requête est un identifiant de transaction. Une transaction est un échange de messages sipprovider.sendresponse( transactionid, Response.OK, strbody, «application!», «!sdp!»); // L émission d une réponse nécessite un identifiant de transaciton, le code statut de la réponse, le corps de la réponse, le type mime sipprovider.sendack( clienttransactionid ); // L emission d un accusé de réception nécessite un identifiant 88

45 Squelette d applications JAIN-SIP 5 Traitement des requêtes (serveur, proxy) public void processrequest(sipevent requestreceivedevent) { Request request = (Request)requestReceivedEvent.getMessage(); long servertransactionid = requestreceivedevent.gettransactionid(); try { if (request.getmethod().equals(request.invite)) processinvite(request,servertransactionid); else if (request.getmethod().equals(request.ack)).. } catch (SipParseException ex) { ex.printstacktrace(); } } 89 Squelette d applications JAIN-SIP 6 Traitement des réponses (client, proxy) public void processresponse(sipevent responsereceivedevent) { Response response = (Response)responseReceivedEvent.getMessage(); long clienttransactionid = responsereceivedevent.gettransactionid(); try { String method = response.getcseqheader().getmethod(); int statuscode = response.getstatuscode(); if((statuscode == Response.OK) && (method.equals(request.invite))) { sipprovider.sendack(clienttransactionid); } else... } catch(sipexception e) { } } 90