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