CN.as COM - SIP Spezifikationen Notruf
Transcription
CN.as COM - SIP Spezifikationen Notruf
CN.as COM - SIP Spezifikationen Notruf Anlagen Dokument-Nr. Version Gültig ab DokumentenStatus Verteilerstatus Arbeitsgruppe Anzahl Seiten 800.553.1601 1.00 01.04.2013 freigegeben öffentlich 000 10 PLaPB Technisches Planungshandbuch der ASFiNAG AUTOBAHNEN- UND SCHNELLSTRASSEN-FINANZIERUNGS-AKTIENGESELLSCHAFT Rotenturmstraße 5 –9, 1010 WIEN, Telefon +43 (0) 50108 - 10000, Telefax + 43 (0) 50108 – 10020 CN.as COM - SIP Spezifikationen Notruf Dokument-Nr. 800.553.1601 Version: 1.00 freigegeben Anlagen Änderungsberechtigte Name Firma / Abteilung Telefon - Nummer Fax - Nummer E - Mail Portschy Kurt ASFINAG BMG / EM +43 (0) 50108 14581 +43 (0) 50108 14522 [email protected] Dokumentenfreigabe Erstellt von: Geprüft von: Freigegeben von: Gesellschaft/Abt./Name Gesellschaft/Abt./Name Gesellschaft/Abt./Name BMG / E&M / K. Portschy BMG / TU / J. Kloimstein BMG / E&M / R. List Datum: 22.02.2013 Datum: 20.03.2013 Datum: 26.03.2013 Gültigkeit Version: gültig von: gültig bis: 1.00 01.04.2013 31.03.2018 Dokumentenhistorie Version gültig ab DokumentenStatus Verteiler-Status Verantwortlicher Änderungsgrund 1.00 01.04.2013 freigegeben öffentlich ASFiNAG Übernahem aus PLaPB BuS Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 2 von 10 Dokument-Nr. 800.553.1601 CN.as COM - SIP Spezifikationen Notruf Anlagen Version: 1.00 freigegeben Inhaltsverzeichnis 1 Allgemein .................................................................................................................... 4 1.1 Grundliegende Funktionen der Notrufeinrichtung ................................................... 4 1.2 Typprüfung (Integrationstest) .................................................................................... 4 2 Anbindung an die Notrufzentrale – Zusätzliche Informationen ............................... 6 2.1 SIP Endgeräte Adressierung und Parameter ............................................................ 6 2.2 Max-Forwards ............................................................................................................. 6 2.3 SIP Expire .................................................................................................................... 6 2.4 Notrufe ......................................................................................................................... 7 2.5 Anrufe an die Notrufsäule .......................................................................................... 7 2.6 Jitter Buffer ................................................................................................................. 7 3 Verwendete Software (und Version) – weiterführende Informationen .................... 9 3.1 Verwendete Software (Version) ................................................................................. 9 3.2 Kamailio SIP Proxy Parameter: .................................................................................. 9 Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 3 von 10 CN.as COM - SIP Spezifikationen Notruf Dokument-Nr. 800.553.1601 1 Anlagen Version: 1.00 freigegeben Allgemein Die Implementierung des CS2SaP SIP Proxy für Standard SIP Endgeräte erfolgt konform zu SIP RFC 3261 ohne optionale Erweiterungen unter Verwendung des SIP Proxy Kamailio in der Version 3.1.4 als Stateful Proxy Server und Registrar und Asterisk PBX als UAS in der Version 1.8.5. Die Anrufe und der RTP Datenstrom werden vom Asterisk Server terminiert und über einen weiteren Call über einen SIP Trunk weitergereicht. Die Übertragung der Sprachdaten erfolgt über RTP konform nach RFC 3550 zwischen SIP Endgerät und Asterisk PBX. 1.1 Grundliegende Funktionen der Notrufeinrichtung Folgende Funktionen müssen SIP fähige Notrufeinrichtungen mindestens unterstützen: ● Rufaufbau initiieren ● Eingehenden Anruf automatisch annehmen ● Regelmäßige Signalisierung von KeepAlive (Zeit konfigurierbar) durch regelmäßige REGISTER Requests der Notrufeinrichtung Ruf beenden ist von Seite der Notrufeinrichtung nicht durchzuführen. Der Ruf wird immer von Seite der Notrufzentrale beendet. Die dazugehörigen RFCs sind RFC3261, RFC 4566 (SDP) und RFC 3550 (RTP). Bei DUAL Sprechstellen (NRS Säulenpaar an einer Sprechstelle) ist vorzusehen, dass jede Notrufsprechstelle (Säule) eine eigene IP Adresse verwendet. 1.2 Typprüfung (Integrationstest) Sofern SIP Notrufeinrichtungen in einer Software- oder Hardware Release eingesetzt werden sollen, welche noch nicht im Rahmen eines Integrationstest mit der von ASF beigestellten Notrufzentrale getestet wurden (und ordnungsgemäß arbeiten), sind diese Notrufeinrichtungen im Rahmen eines Integrationstest gemeinsam mit dem Auftraggeber zu prüfen. Die Abstimmung des Testes obliegt dem Auftragnehmer und muss gemeinsam mit der Notrufprojektleitung der ASFINAG durchgeführt werden. Als Ergebnis wird ein Zertifikat für die NRE Type übergeben (mit dem entsprechenden Netzwerk Trace), dieses Zertifikat gilt als Nachweis der Kompatibilität. Testszenarien (Beispiel): ● Anbindung (Register) an das Notrufsystem ● ausgehender Anruf (Notruf) ● eingehender Anruf (Anruf an NRE) ● Weitervermittlung des Notrufes (durch die Notrufzentrale) Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 4 von 10 CN.as COM - SIP Spezifikationen Notruf Dokument-Nr. 800.553.1601 Anlagen Version: 1.00 freigegeben ● "Ping-of-Death" Test, daher Belastung des IP Stacks mit vielen großen PING Paketen ● Simulation Stromausfall (Wiederverbinden durch Neuregistrieren) ● Simulation Ausfall der Netzwerkverbindung (Wiederverbinden) ● … zusätzliche Tests sind nicht auszuschließen und werden im Zuge des Integrationstests durchgeführt. Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 5 von 10 CN.as COM - SIP Spezifikationen Notruf Dokument-Nr. 800.553.1601 Anlagen Version: 1.00 freigegeben 2 Anbindung an die Notrufzentrale – Zusätzliche Informationen 2.1 SIP Endgeräte Adressierung und Parameter Eine Kommunikation der Standard SIP Endgeräte mit dem Proxyserver erfolgt via SIP/UDP und IPV4. Hierbei erfolgt keine Authentifizierung. Ein SIP REGISTER wird mit einem SIP 200 OK direkt beantwortet ohne dass eine Proxy Challenge angefordert wird (konform zu RFC 3261 22.3 ohne Authentifizierung). Jedes SIP Endgerät muss sich über eine eindeutige Nutzerkennung und eine eindeutige IP Adresse identifizieren. Hierbei ist definiert, dass das Endgerät hierzu eine E164 Rufnummer als Nutzernamen (AOR Record und User Part der Contact URI) verwendet und nur ein Contact Header vorhanden ist, sowie ein Expires SIP Header. DUAL Sprechstellen müssen zwei IP Adressen (eine pro Notrufsäule) aufweisen. Bei ausgehenden SIP Requests vom SIP Endgerät ist als Mindestanforderung der AOR Record (E164 Rufnummer) in der From URI als User Part (From User), sowie die IP Adresse des SIP Proxy als Host (From Domain) in einer gültigen SIP URI zu senden. Beispiele mit 172.31.2.129 als Proxy Adresse: From: sip:[email protected];tag=a48s oder auch: From: "something" <sip:[email protected]>;tag=a48s 2.2 Max-Forwards Das Endgerät muss ein Routing über Record Router Header über mindestens einen Proxy Server an den Asterisk als UAS erlauben. Hierzu ist ein sinnvoller Wert für den Max-Forwards Header zu wählen (z.B. mindestens 10 um evtl. spätere Erweiterung zu erlauben). Beispiel: Max-Forwards: 10 2.3 SIP Expire Die SIP Expire Werte müssen minimal einen Delta Wert von 60 Sekunden haben (siehe Default Parameter Kamailio Modul registrar min_expires). RFC 2543 absolute Timestamp (Datumswerte) sind nicht gültig. Für einen sinnvollen Betrieb zur Erkennung von Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 6 von 10 CN.as COM - SIP Spezifikationen Notruf Dokument-Nr. 800.553.1601 Anlagen Version: 1.00 freigegeben ausgefallenen SIP Endgeräten sollte der Expires Wert einen Wert von 300 Sekunden nicht überschreiten. Dieser Wert muss parametrierbar sein, um bei Bedarf eine Anpassung durchführen zu können. Beispiele: 2.4 ● Expires: 300 ● Expires: 60 Notrufe Bei einem Notruf kann als Zielrufnummer eine beliebige numerische Rufnummer mit 1-n Stellen angegeben werden. Im SIP Header sind hierbei in der From Zeile die E164 Rufnummer des anrufenden Endgerätes (From User bzw. AOR) und als Domain die IP des SIP Proxy (From Domain) in der SIP URI anzugeben. Die einzutragende (anrzurufende) Nummer wird durch den Auftraggeber übergeben. In der To URI ist als Rufnummer (To User) die numerische Rufnummer anzugeben und als Domain die IP des SIP Proxy (To Domain). Beispiele mit 172.31.2.129 als Proxy und Anruf an die Rufnummmer 1: From: "4922890909870" <sip:[email protected]>;tag=1n0obglnpp To: <sip:[email protected]> oder From: <sip:[email protected]>;tag=1n0obglnpp To: <sip:[email protected]> 2.5 Anrufe an die Notrufsäule Ein Anruf an die Notrufsäule erfolgt über einen SIP URI Call an die Notrufsäule. Das Endgerät muss diesen Anruf bei einem eingehenden SIP INVITE auf Port 5060 UDP automatisch annehmen. 2.6 Jitter Buffer Zur Kompensation von Laufzeitschwankungen im IP-Netz benötigen die SIP Endgeräte zwingend einen Jitter-Buffer zum Ausgleich. Der Buffer muss folgende Kriterien erfüllen: Der Buffer muss in der Lage sein mindestens bis zu 200ms an RTP-Daten zu speichern. Das sind 10 Pakete à 20ms oder 20 Pakete à 10ms. Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 7 von 10 Dokument-Nr. 800.553.1601 CN.as COM - SIP Spezifikationen Notruf Anlagen Version: 1.00 freigegeben Die tatsächlich verwendete Größe des Buffers (10 – 200ms/ 1 – 20 Pakete) sollte entweder dynamisch geregelt werden (dynamischer Jitter-Buffer) oder in der Konfiguration einstellbar sein (statischer Jitter-Buffer). Die Größe des Buffers sollte als Anzahl der Pakete oder die Dauer der zu speichernden Daten in Millisekunden anzugeben sein. Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 8 von 10 CN.as COM - SIP Spezifikationen Notruf Dokument-Nr. 800.553.1601 Anlagen Version: 1.00 freigegeben 3 Verwendete Software (und Version) – weiterführende Informationen 3.1 Verwendete Software (Version) 3.2 ● Kamailio SIP Proxy 3.1.4 ● Asterisk Server 1.8. Kamailio SIP Proxy Parameter: Als Standardparameter sind die im RFC 3261 genannten Wertebereiche möglich. Hierbei sind die optional definierbaren Wertebereich entsprechend der Kamailio SIP Proxy Standardkonfiguration verwendet, wie in der Dokumentation zu Kamailio 3.1.x vom Kamailio Projekt definiert: http://www.kamailio.org/dokuwiki/doku.php/core-cookbook:3.1.x sowie der Kamailio Module: http://www.kamailio.org/docs/modules/3.1.x/modules_k/rr.html http://www.kamailio.org/docs/modules/3.1.x/modules_k/registrar.html http://www.kamailio.org/docs/modules/3.1.x/modules/sanity.html http://www.kamailio.org/docs/modules/3.1.x/modules/sl.html http://www.kamailio.org/docs/modules/3.1.x/modules/tm.html http://www.kamailio.org/docs/modules/3.1.x/modules_k/usrloc.html Abweichend von den Standardwerten im SIP Stack des Kamailio SIP Proxy sind folgende Werte abweichend zur Standardkonfiguration gesetzt: modparam("tm", "fr_timer", 8000) # SIPa final response timer modparam("rr", "enable_full_lr", 1) modparam("rr", "append_fromtag", 0) modparam("rr", "enable_double_rr", 0) Die Dokumentation zu den entsprechenden Werten findet sich in der Kamailio Dokumentation. Beispiel: Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 9 von 10 Dokument-Nr. 800.553.1601 CN.as COM - SIP Spezifikationen Notruf Anlagen Version: 1.00 freigegeben modparam("tm"... ist in http://www.kamailio.org/docs/modules/3.1.x/modules/tm.html dokumentiert. Druckdatum: 18.03.2013 Dokumentname: PLaPB 800.553.1601 2013 ASFINAG Autobahnen- und Schnellstraßen-Finanzierungs-Aktiengesellschaft Seite 10 von 10