Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- lager:oeff_netze:voip [05.06.2013 12:15] – richard
+++ lager:oeff_netze:voip [04.03.2023 17:20] (aktuell) – Status der Diskussion geändert richard
@@ Zeile 1: / Zeile 1: @@
-==== Übung zu VoIP ====
+~~DISCUSSION:closed|Ergänzungen~~
+====== Laborübung zu VoIP mit sipwitch ======
-Für die Übung zu VoIP wird der SIP-Proxy sipwitch als vermittelndes Element eingesetzt.
-Da der Proxy bereits beim Systemstart als Dienst (Daemon) mitgestartet wird, muss der Proxy zunächst gestoppt werden.
-Dies ist notwendig, um eine eigene Konfiguration (s.u.) verwenden zu können.
-<code>sudo sipwitch down</code>
-Dieser Schritt ist auch auf den Client-PCs durchzuführen. Bei den Clients ist zusätzlich zu beachten, dass nur EINE VoIP-Software aktiv ist, da sonst ebenfalls der Port für die zweite Anwendung blockiert ist.
+Für die Übung zu VoIP wird der SIP-Proxy ''sipwitch/sipw'' als vermittelndes Element eingesetzt. Im folgenden ist ein kurzes Howto inklusive einer Beispielkonfiguration, die an die eigenen Bedürfnisse anzupassen ist.
-Die Standard-Konfiguration liegt unter ''/etc/sipwitch.conf'' ((Basiskonfiguration)) und für die Anlage der Benutzer ''/etc/sipwitch.d/lab.xml-sample''((Beispiel für Benutzerkonfiguration --> ''<provision>'')).
+{{ :lager:oeff_netze:bilder:w02-voip-laboraufbau.png | Laboraufbau}}
-**ACHTUNG** diese Konfigurationsdateien sind schlecht bzw. fehlerhaft kommentiert.
-Die unten aufgeführte Datei kann als Beispiel für einen eigenen Aufbau genutzt werden. Dazu muss die Datei in ''/home/USER/.sipwitchrc'' abgelegt werden.
+===== Vorbereitung alle SIP-fähigen Prozesse stoppen ====
+Falls der Proxy bereits beim Systemstart als Dienst (Daemon) mitgestartet wird, muss der Proxy zunächst gestoppt werden.
+Mit dem folgenden Befehl lässt sich überprüfen, ob es einen entsprechenden Daemon-Prozess gibt.
+<code>ps aux | grep sip</code>
+Der SIP-Proxy kann mit dem folgenden Befehl gestoppt werrden
+<code>sudo sipwitch down</code>
-Der Proxy kann mit dem folgenden Befehl gestartet werden:
+Dieser Schritt ist ggf. auch auf den Client-PCs durchzuführen. Bei den Clients ist zusätzlich zu beachten, dass nur EINE VoIP-Software aktiv ist (Server oder Client), da sonst ebenfalls der Port für die zweite Anwendung blockiert ist.
-<code>sipw -x9 -f</code>
+===== SIP-Proxy-Konfiguration =====
+Der SIP-Proxy ''sipwitch'' wird normalerweise über zwei getrennt Konfigurationsdateien konfiguriert.
+Die Standard-Konfiguration liegt unter ''/etc/sipwitch.conf'' ((Basiskonfiguration)) und für die Anlage der Benutzer ''/etc/sipwitch.d/lab.xml-sample''((Beispiel für Benutzerkonfiguration --> ''<provision>'')).
+Diese Konfiguration wird verwendet, wenn der Proxy mit root-Rechten (sudo) gestartet wird.
+**ACHTUNG** Standard-Konfigurationsdateien sind schlecht bzw. fehlerhaft kommentiert. Insbesondere ist der ''<realm>''-Tag komplett falsch angegeben. Er darf KEINE Leerzeichen und MUSS mindestens einen Punkt enthalten. Aus diesem Grund sollte man eigene Konfigurationsdateien verwenden. Die unten angeführte Beispielkonfiguration ist entsprechenden überarbeitet und kann über den Nutzer ''keinpasswort'' verwendet werden.
+Die unten aufgeführte Datei kann als Beispiel für einen eigenen Aufbau genutzt werden. Dazu muss die Datei in ''/home/USER/.sipwitchrc'' abgelegt werden und der Proxy mit der folgenden Befehlszeile (ohne ''sudo'' !!) gestartet werden:
+<code>sipw -x9 -f</code>
+Ein Erklärung der einzelnen XML-Tags findet sich auf der Homepage des [[http://www.gnutelephony.org/index.php/Howto_Deploy_SIP_Witch_On_Ubuntu| GNU-Telephony-Projekts]].
-Die folgende Beispieldatei basiert auf diesen beiden Dateien, muss aber noch an die örtlichen Gegebenheiten angepasst werden.
+HINWEIS: Der Begriff ''Extension'' steht im Bereich Telefonie für Rufnummern bzw. Nebenstellen. Damit sind also die Rufnummern der
+einzelnen Teilnehmer gemeint.
+Die folgende Beispieldatei basiert auf den offiziellen Dateien, muss aber noch an die örtlichen Gegebenheiten angepasst werden.
+(Per Klick auf ''.sipwitchrc_sample'' kann die Datei direkt heruntergeladen werden.)
 <file xml .sipwitchrc_sample>
 <?xml version="1.0"?>
@@ Zeile 45: / Zeile 58: @@
 -->
     <test id="testing">
-      <secret>editme</secret>
+      <secret>EditMe</secret>
       <extension>299</extension>
       <answer>12</answer>
@@ Zeile 52: / Zeile 65: @@
     </test>
-    <user id="editme1">
+    <user id="EditMe1">
-      <secret>editme</secret>
+      <secret>EditMe</secret>
       <extension>201</extension>
-      <display>editme 1</display>
+      <display>EditMe1</display>
     </user>
-    <user id="editme2">
+    <user id="EditMe2">
       <secret>1234</secret>
       <extension>202</extension>
@@ Zeile 75: / Zeile 88: @@
 	<local>0.0.0.0/01</local>
 	<local>128.0.0.0/01</local>
+     Hier gehört das lokale Netz, in dem der Server betrieben wird hinein.
 -->
-    <local>editme</local>
+    <local>EditMe</local>
   </access>
@@ Zeile 97: / Zeile 111: @@
 -->
-    <mapped>200</mapped>
+    <mapped>100</mapped>
     <threading>2</threading>
     <interface>*</interface>
@@ Zeile 128: / Zeile 142: @@
   <timers>
-    <!-- ring every 4 seconds -->xml
+    <!-- ring every 4 seconds -->
     <ring>4</ring>
     <!-- call forward no answer after x rings -->
@@ Zeile 145: / Zeile 159: @@
     <range>100</range>
     <keysize>77</keysize>
-    <mapped>200</mapped>
+    <mapped>100</mapped>
     <!-- ACHTUNG: Der Tag <realm> muss mind. einen "." enthalten und darf keine
 	Leerzeichen beinhalten.!
 	s. Hier: http://lists.gnu.org/archive/html/sipwitch-devel/2011-01/msg00007.html  -->
-    <realm>editme</realm>
+    <realm>EditMe.de</realm>
   </registry>
@@ Zeile 158: / Zeile 172: @@
 </sipwitch>
+</file>
-</file>
+===== SIP-Client Softphone Linphone =====
+Als Softphone wird die Software ''Linphone'' verwendet. Bei der Konfiguration muss beachtet werden, dass im gesamten Szenario OHNE Domänen (z.B. ''www.irgendwas.de'') gearbeitet wird. Daher muss als Registrar die IP-Adresse des SIP-Proxy angegeben werden.
+Beispiel:
+SIP-Proxy läuft auf ''192.168.21.120'' -> ''user01@192.168.21.120''
+D.h. der Benutzer ''user01'' kann sich mit seinem Passwort auf dem Proxy 192.168.21.120 anmelden. Zusätzlich sollte als Registrar ebenfalls der SIP-Proxy angegeben werden.
+Wenn man einen anderen Benutzer auf demselben Proxy anrufen möchte, so reicht die Rufnummer (Extension) des Ziels.
+===== Aufgaben =====
+Protokollieren Sie den folgende Vorgänge mit:
+  - Anmeldung der Benutzer (einmal korrekt, einmal mit falschem Passwort, einmal mit falschem Benutzernamen)
+  - Verbindungsaufbau (einmal zu korrektem Ziel, einem zu nicht existierendem Ziel)
+  - Wiederanmeldung (Reregister) der Benutzer
+Achten Sie insbesondere auf die Statusmeldungen.