A fully featured browser based WebRTC SIP phone for Asterisk
This web application designed to work with Asterisk PBX (supported versions unknown). Once loaded application will connect to Asterisk PBX on its web socket, and register an extension. Calls are made between contacts, and a full call detail is saved. Audio Calls can be recorded. Video Calls can be recorded, and can be saved with 5 different recording layouts and 3 different quality settings. This application does not use any cloud systems or services, and is designed to be stand-alone. Additional libraries will be downloaded at run time (but can also be saved to the web server for a complete off-line solution).
- SIP Audio Calling
- SIP Video Calling
- Call Transfer (Both Blind & Attended)
- 3rd Party Conference Call
- Call Detail Records
- Call Recording (Audio & Video)
- Screen Share during Video Call
- Scratchpad Share during Video Call
- Video/Audio File Share during Video Call
- SIP (text/plain) Messaging
- SIP Message Accept Notification (not delivery)
- Buddy (Contact) Management
- Useful debug messages sent to console.
- Works on: Chrome (all features work), Edge (same as Chrome), Opera (same as Chrome), Firefox (Most features work), Safari (Most feature work)
- Asterisk PBX (with WebRTC and Messaging)
- sip-0.11.6.js : WebRTC and SIP signaling library
- jquery-3.3.1.min.js : JavaScript toolkit
- jquery.md5-min.js : Md5 Hash plug-in (unused)
- Chart.bundle-2.7.2.js : Graph and Chart UI
- dhtmlx.js : Windowing & UI Library
- fabric-2.4.6.min.js : Canvas Editing Library
- moment-with-locales-2.24.0.min.js : Date & Time Library
- croppie.min.js : Profile Picture Crop Library
Note: These libraries will load automatically from CDN.
You can follow the How-to video to achieve the outcome for this project:
Or follow these steps.
Flash the you SD card using the Raspberry Pi Imager from https://www.raspberrypi.org/downloads/.
Write a blank text file named ssh (no extension) to the boot directory of the SD card. On Mac use:
sudo nano /Voumes/boot/ssh
and on Windows, you can just use Notepad and save it as: D:/ssh
Insert the SD Card into your Raspberry Pi, connect a Network Cable and boot up.
Connect to the raspberry pi over the network using Terminal (on Mac), or Putty (on Windows), as:
ssh pi@raspberrypi.local
The default password for raspberry pi is: raspberry
You have to be root, so:
$ sudo su
Issue and update:
# apt-get update
Install a few essential applications:
# apt-get instal samba ntp git
Add pi username to samba
# smbpasswd -a pi
Edit the smb.conf file and add share:
# nano /etc/samba/smb.conf
Add the following at the bottom of the file
[InnovateAsterisk]
path = /
browseable = yes
writeable = yes
read only = no
create mask = 0755
directory mask = 0755
guest ok = no
security = user
write list = pi
force user = root
Restart samba service:
# service smbd restart
exit su:
# exit
Create some folders:
$ mkdir /home/pi/ca
$ mkdir /home/pi/certs
$ mkdir /home/pi/csr
Create a Root CA Key:
$ openssl genrsa -des3 -out /home/pi/ca/InnovateAsterisk-Root-CA.key 4096
(Remember the password you used) Create Root Certificate Authority Certificate:
$ openssl req -x509 -new -nodes -key /home/pi/ca/InnovateAsterisk-Root-CA.key -sha256 -days 3650 -out /home/pi/ca/InnovateAsterisk-Root-CA.crt
Something like this should be fine:
Country Name (2 letter code) [AU]: GB
State or Province Name (full name) [Some-State]: None
Locality Name (eg, city) []: None
Organization Name (eg, company) [Internet Widgits Pty Ltd]: Innovate Asterisk
Organizational Unit Name (eg, section) []: www.innovateasterisk.com
Common Name (e.g. server FQDN or YOUR name) []: Innovate Asterisk Root CA
Email Address []: youremailgoes@here
Generate Certificate Signing Request & Private Key:
$ openssl req -new -sha256 -nodes -out /home/pi/csr/raspberrypi.csr -newkey rsa:2048 -keyout /home/pi/certs/raspberrypi.key
Generate SSL V3 file:
$ nano /home/pi/csr/openssl-v3.cnf
And populate with:
authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names
[alt_names]
DNS.1 = raspberrypi.local
Generate Server Certificate:
$ openssl x509 -req -in /home/pi/csr/raspberrypi.csr -CA /home/pi/ca/InnovateAsterisk-Root-CA.crt -CAkey /home/pi/ca/InnovateAsterisk-Root-CA.key -CAcreateserial -out /home/pi/certs/raspberrypi.crt -days 365 -sha256 -extfile /home/pi/csr/openssl-v3.cnf
Generate PEM Combo Certificate:
$ cat /home/pi/certs/raspberrypi.crt /home/pi/certs/raspberrypi.key > /home/pi/certs/raspberrypi.pem
Set Permission to Key:
$ chmod a+r /home/pi/certs/raspberrypi.key
Change to root:
$ sudo su
Install Opus dev files:
# apt-get install xmlstarlet libopus-dev libopusfile-dev
Exit root:
# exit
Wget the Asterisk source:
$ wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-13-current.tar.gz
Untar the download:
$ tar -xvf asterisk-[tab]
Change to Asterisk folder
$ cd aster[tab]
Going to install again, so go back to root:
$ sudo su
Install the prerequisites:
# contrib/scripts/install_prereq install
Configure Asterisk:
# ./configure --libdir=/usr/lib64 --with-pjproject-bundled
Enter menuselect, and turn off CDR, CEL, and change MOH to WAV:
# make menuselect
Call make
# make
Install the built code:
# make install
Configure Asterisk to start automatically:
# make config
Ensure Asterisk knows the location of its binary files:
# echo "/usr/lib64" > /etc/ld.so.conf.d/lib_asterisk.conf
# ldconfig
# ldd /usr/sbin/asterisk
Exit root:
# exit
Start Asterisk:
$ sudo service asterisk status
$ sudo service asterisk start
$ sudo service asterisk status
$ sudo asterisk -r
Not many of the modules will be loaded:
> [tab]
> exit
Return to home folder:
$ cd ~
Close the git project:
$ git clone https://github.com/InnovateAsterisk/Browser-Phone.git
Copy the config files:
$ sudo cp /home/pi/Browser-Phone/config/* /etc/asterisk/
Clear the existing files in static-http:
$ sudo rm /var/lib/asterisk/static-http/*
Copy the web pages:
$ sudo cp /home/pi/Browser-Phone/Phone/* /var/lib/asterisk/static-http/
Set the file permissions:
$ sudo chmod 744 /var/lib/asterisk/static-http/*
Copy the Opus codec to modules:
$ sudo cp /home/pi/Browser-Phone/modules/ast-13/codec_opus_arm.so /usr/lib64/asterisk/modules
Restart Asterisk and check the modules loaded:
$ sudo service asterisk restart
$ sudo asterisk -r
> [tab]
> exit
Open the original /etc/asterisk/sip.conf file and make the following changes:
websocket_enabled=yes
maxcallbitrate=5120
Add anywhere under [general]:
accept_outofcall_message=yes
auth_message_requests=no
outofcall_message_context=textmessages
Add to the bottom of /etc/asterisk/sip.conf:
[basic](!)
type=friend
qualify=yes
context=from-extensions
subscribecontext=subscriptions
host=dynamic
directmedia=no
nat=force_rport,comedia
dtmfmode=rfc2833
disallow=all
videosupport=yes
[phones](!)
transport=udp
allow=ulaw,alaw,g722,gsm,vp9,vp8,h264
[webrtc](!)
transport=wss
allow=opus,ulaw,vp9,vp8,h264
encryption=yes
avpf=yes
force_avp=yes
icesupport=yes
rtcp_mux=yes
dtlsenable=yes
dtlsverify=fingerprint
dtlscertfile=/home/pi/certs/raspberrypi.pem
dtlscafile=/home/pi/ca/InnovateAsterisk-Root-CA.crt
dtlssetup=actpass
[User1](basic,webrtc)
callerid="Conrad de Wet" <100>
secret=1234
[User2](basic,webrtc)
callerid="User 2" <200>
secret=1234
[User3](basic,phones)
callerid="User 3" <300>
secret=1234
Update the /etc/asterisk/extensions.conf to the following:
[general]
static=yes
writeprotect=yes
priorityjumping=no
autofallthrough=no
[globals]
ATTENDED_TRANSFER_COMPLETE_SOUND=beep
[textmessages]
exten => 100,1,Macro(send-text,User1)
exten => 200,1,Macro(send-text,User2)
exten => 300,1,Macro(send-text,User3)
exten => e,1,Hangup()
[subscriptions]
exten => 100,hint,SIP/User1
exten => 200,hint,SIP/User2
exten => 300,hint,SIP/User3
[from-extensions]
; Feature Codes:
exten => *65,1,Macro(moh)
; Extensions
exten => 100,1,Macro(dial-extension,User1)
exten => 200,1,Macro(dial-extension,User2)
exten => 300,1,Macro(dial-extension,User3)
; Anything else, Hangup
exten => _[+*0-9].,1,NoOp(You called: ${EXTEN})
exten => _[+*0-9].,n,Hangup(1)
exten => e,1,Hangup()
[macro-moh]
exten => s,1,NoOp(Music On Hold)
exten => s,n,Ringing()
exten => s,n,Wait(2)
exten => s,n,Answer()
exten => s,n,Wait(1)
exten => s,n,MusicOnHold()
[macro-dial-extension]
exten => s,1,NoOp(Calling: ${ARG1})
exten => s,n,Dial(SIP/${ARG1},30)
exten => e,1,Hangup()
[macro-send-text]
exten => s,1,NoOp(Sending Text To: ${ARG1})
exten => s,n,Set(PEER=${CUT(CUT(CUT(MESSAGE(from),@,1),<,2),:,2)})
exten => s,n,Set(FROM=${SHELL(asterisk -rx 'sip show peer ${PEER}' | grep 'Callerid' | cut -d':' -f2- | sed /^\ *//' | tr -d '\n')})
exten => s,n,MessageSend(sip:${ARG1},${FROM})
exten => s,n,Hangup()
Restart Asterisk or Reload SIP and Dialplan:
$ sudo asterisk -r
> sip reload
> dialplan reload