siproxd.txt

   1 AUTHOR:         Jim Gifford <lfs-hints@jg555.com>
   2
   3 DATE:           2004-05-18
   4
   5 LICENSE:        GNU Free Documentation License Version 1.2
   6
   7 SYNOPSIS:       How to setup siproxd to use a SIP Phone under LFS
   8
   9 DESCRIPTION:    This hint will show you how to use a SIP phone
  10                 with LFS.
  11
  12 PREREQUISITES:  Files listed in hint must be downloaded
  13
  14 HINT:
  15
  16 Introduction:
  17
  18 This hint will help you configure a SIP proxy server for use with LFS.
  19 The one problem with using a SIP phone is generally most of use are not
  20 connected directly to the internet with out phones. The phones are part
  21 of are LAN and have IP addresses that are internal to our network. The
  22 SIP proxy server allows the phone to communicate to the outside and
  23 makes sure the proper phone gets the calls routed to them.
  24
  25 Programs Used
  26
  27 Program Name            libosip2
  28 Download location               http://osip.atosc.org/download/osip
  29 Version used            2.0.7
  30
  31 Program Name            siproxd
  32 Download location               http://siproxd.sourceforge.net
  33 Version used            0.5.5
  34
  35 -----
  36 What is siproxd:
  37
  38 Siproxd is an proxy/masquerading daemon for the SIP protocol.
  39 It handles registrations of SIP clients on a private IP network
  40 and performs rewriting of the SIP message bodies to make SIP
  41 connections possible via an masquerading firewall.
  42 It allows SIP clients (like kphone, linphone) to work behind
  43 an IP masquerading firewall or router.
  44
  45 -----
  46 libosip2
  47
  48         Before you can setup siproxd you will need to setup lisosip2.
  49
  50         ./configure --prefix=/usr &&
  51         make &&
  52         make install
  53
  54 ----
  55 sirpoxd
  56
  57 Before Compiling
  58
  59         Before compiling siproxd you will need to create a user and a group.
  60
  61         In /etc/passwd add : siproxd:x:117:117::/dev/null:/bin/false
  62
  63         In /etc/group add : siproxd:x:117:
  64
  65 Compiling
  66
  67
  68         ./configure --prefix=/usr --sysconfdir=/etc/siproxd &&
  69         make &&
  70         make install
  71
  72 Configuring
  73
  74         To configure siproxd use the following commands to make a siproxd.conf file
  75
  76         cd /etc/siproxd
  77         cp siproxd.conf.example siproxd.conf
  78
  79         Now you will need to change the following entries in the file
  80
  81         if_inbound  = eth0      to      if_inbound = {Your LAN Interface}
  82         if_outbound = ppp0      to      if_outbound = {Your Internet Interface}
  83
  84         #hosts_allow_reg = 192.168.1.8/24 to hosts_allow_reg = {Your LAN Network)
  85
  86 Bootup Script
  87
  88         #!/bin/bash
  89         # Begin $rc_base/init.d/siproxd
  90
  91         # Based on sysklogd script from LFS-3.1 and earlier.
  92         # Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
  93
  94         source /etc/sysconfig/rc
  95         source $rc_functions
  96
  97         case "$1" in
  98                 start)
  99                         echo "Creating IPTables Rules for Siproxd..."
 100                         iptables -A INPUT -i {if_inbound from siproxd} -p udp --dport 5006 -j ACCEPT
 101                         iptables -A INPUT -i {if_inbound from siproxd} -p udp --dport 7070:7080 -j ACCEPT
 102                         echo "Starting Siproxd..."
 103                         loadproc /usr/sbin/siproxd
 104                         ;;
 105
 106                 stop)
 107                         iptables -D INPUT -i {if_inbound from siproxd} -p udp --dport 5006 -j ACCEPT
 108                         iptables -D INPUT -i {if_inbound from siproxd} -p udp --dport 7070:7080 -j ACCEPT
 109                         killproc /usr/sbin/siproxd
 110                         echo "Stopping Siproxd..."
 111                         ;;
 112
 113                 restart)
 114                         $0 stop
 115                         sleep 1
 116                         $0 start
 117                         ;;
 118                 *)
 119                         echo "Usage: $0 {start|stop|restart}"
 120                         exit 1
 121                         ;;
 122         esac
 123
 124         # End $rc_base/init.d/siproxd
 125 -----
 126
 127 Phone/Software Configuration
 128
 129         You will need to specify the IP address of the server that you loaded
 130         the software on as the outgoing proxy.
 131
 132 -----
 133 Testing
 134
 135         I am a member of freeworlddialup.com, they provide some test #'s you can
 136         use. For example 958 would give you your phone #. 612 would give you the
 137         time.
 138
 139         Check the providor your using, they may have the same features with different
 140         #'s.
 141
 142         You can also call me at 275410, if I'm around I will answer.
 143
 144 -----
 145 Linux SIP Software
 146
 147         Here are some links for software phones, utilizing your sound card and a microphone.
 148
 149         Cornfed SIP User Agent          http://www.cornfed.com/products
 150         linphone                        http://www.linphone.org
 151         Kphone                          http://www.wirlab.net/kphone/index.html
 152
 153 -----
 154
 155 Questions or Comments
 156
 157         If you have any question's or comments you can either email me at lfs-hints@jg555.com
 158         or call me via FDW at 275410.
 159
 160 -----
 161
 162 VERSION:        1.2
 163
 164 CHANGELOG:      1.2 Updated Verion
 165                 1.1 Forgot Phone Configuration. Update Script to delete iptables rules
 166                 1.0 Initial Version
 167
 168  New Version of this document can be viewed from http://cvs.jg555.com/viewcvs.cgi/lfs-hints