WebRTC and Asterisk 11 using sipML5 (with some FreePBX compatibility)

[UPDATED: 12 April 2013]

- WARNING – sipml5’s PATCH BELOW DOESN’T WORK ON NEW RELEASED AST 11.3 AND/OR THE LATEST CHROME Version 26.0.1410.64 m SEEM TO HAVE BROKE THIS AND CAUSES ONE WAY AUDIO. IF YOU DO NOT ENCOUNTER THIS, PLEASE LET ME KNOW. I COULD BE HAVING ISOLATED NAT ISSUES.

Hi guys, in a few days I’d be introducing WebRTC and all its jazz to our Malaysia Asterisk User Group (MAUG). I was asked to demonstrate WebRTC and how it changes everything (again).
The following guide was taken off various sources as initial references such as Digium’s Wiki and sipML5’s how to for Asterisk found here.
And yes, again, this guide is mainly targeted to Debian users, other OS users, please improvise and do your best. Otherwise, drop me a note at sanjayws@gmail.com
OK, to begin, here are my components I am using

1. Debian 6
2. Asterisk 11 (11.2.1 with a patch explained later)
3. Chrome version 24.0.1312.56 m
4. sipML5 (Thanks to Dubango Telekom http://www.doubango.org/)
5. FreePBX (optional)

First, you need a working Asterisk 11.2.1 installation. If you don’t have one, use this guide here.  Be sure to use 11.2.1 as this guide is designed for that version!
Here’s a step by step with some explanation, remember only # cli codes you can copy paste

1. Go to your source
2. # cd  /usr/src/
3. Get libsrtp (as WebRTC only allows comms using secure / encrypted connections)
4. # wget http://srtp.sourceforge.net/srtp-1.4.2.tgz && tar -zxvf srtp-1.4.2.tgz && cd srtp
5. # ./configure
6. # make && make install
7. Now, we upgrade/update/install asterisk 11.2.1 if you’re not already running that particular version, if you are, skip the related parts here (points 8-11)
   # wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-11.2.1.tar.gz && tar –zxvf asterisk-11.2.1.tar.gz
   # cd /usr/src/asterisk-11.2.1 && make clean
8. # contrib/scripts/get_mp3_source.sh
9. #  ./configure --with-crypto --with-ssl --with-srtp
10. # make menuselect.makeopts
11. # menuselect/menuselect --enable format_mp3 --enable res_config_mysql --enable app_mysql --enable app_saycountpl --enable cdr_mysql --enable EXTRA-SOUNDS-EN-GSM
12. # wget http://sipml5.googlecode.com/svn-history/r169/trunk/asterisk/asterisk_379070.patch  (see here what this patch do)
13. # patch -p0 -i ./asterisk_379070.patch
14. Now time to reconfigure and recompile Asterisk with SRTP etc…(WARNING, do not make samples if you have working configurations or use FreePBX etc…)
15. # make && make install
    (NOTE : THIS BELOW SEEM TO HAVE BEEN FIXED ON ASTERISK 11.2.1 …BUT..if you have issues compiling/recompiling with ccar errors, try removing it like this# nano ./res/pjproject/build/cc-auto.mak
    and remove the characters "cc" from "ccar" and "ccranlib" ie just showing only “ar” and “ranlib” respectively.). Rerun the above entire command line.
16. Configure some parameters on Asterisk / config files
17. Edit the /etc/asterisk/sip.conf (or modify Asterisk SIP Settings in FreePBX), add/modify the following settings, in [general]. Notice we add transport ws and wss, these are websocket and websocket secure
    
    udpbindaddr=0.0.0.0:5060
    realm=<yourIP or name> e.g. 192.168.2.239
    transport=udp,ws,wss
    
18. Edit the /etc/asterisk/rtp.conf and we add support for STUN (now supported on Asterisk 11). Read here for more info. Change/modify to your own if you don’t want to use the sample here.
    
    icesupport=yes
    stunaddr=132.177.123.6
    
    NOTE: The above IP was resolved from the free stun server stunserver.org
19. Edit the http.conf file /etc/asterisk/http.conf, look for and modify or with an empty config, paste this below (uncomment if they are commented with a ; )
    
    [general]
    enabled=yes
    bindaddr=0.0.0.0
    bindport=8088
    
    Be sure its running after restarting Asterisk, check like below, you should be seeing output showing LISTEN somewhere
    # netstat -an | grep 8088
    
20. Now, create one (or more if you wish to do browser to browser calls, for other phones create a normal SIP extensions like how you would do ) SIP accounts in /etc/asterisk/sip.conf with example below (FreePBX users modify it in /etc/asterisk/sip_custom.conf)
    
    [8000]
    secret=C@mplEX123
    context=from-internal
    host=dynamic
    trustrpid=yes
    sendrpid=no
    type=friend
    qualify=yes
    qualifyfreq=600
    transport=udp,wss,ws
    encryption=yes
    dial=SIP/8000
    callerid=Sanjay Willie <8001>
    callcounter=yes
    avpf=yes
    icesupport=yes
    directmedia=no
    
21. Note: Since I use FreePBX, I use the context from-internal, where my dialplans are already created by FreePBX for me. For this customized extension to work, I created a SIP extension 2001 but under the DIAL I placed SIP/8000 instead so that it will ring my custom sip account and also the dialplan is now registered inside FreePBX’s dialplan to reach 8000. So. basically, now when I want to reach 8000 I actually dial 2001, get it? Otherwise write a simple dialplan like shown below the image
    
    
    [from-internal-custom]
    exten => 8000,1,Dial(SIP/8000)
    same  => hangup()
    
22. Now, restart Asterisk (kill and start)
23. Now, its time we get the sipML5 softphone and get started!
24. Go to your source directory, e.g. /usr/src, get the source using SVN, if you don’t have SVN, you need to install it (see how here)
25. Assuming your web(http) default directory is in /var/www
26. # svn checkout http://sipml5.googlecode.com/svn/trunk/ /var/www/myphone (note, some systems it may be /var/www/html/myphone)
27. #  chown -R asterisk:asterisk /var/www/myphone/ (or /var/www/html/myphone)
28. Now, head on to your Google Chrome browser and type
29. http://<yourIP>/myphone/demos/call.htm (e.g. http://192.168.2.239/myphone/call.htm)
30. Click on Expert Mode, select to Disable Video.
31. Enter the information like below except change the part where it says the IP, of course, enter your own IP there
    
    Websocket URL: ws://192.168.2.239:8088/ws (Note this is not an SSL enabled site, i.e. using just ws, not wss, if you want to use WSS as the protocol, then you need to enable it on Asterisk’s HTTP server by generating keys etc…)
32. Click on Save
33. Go back to the other tab which the webphone is on, enter the SIP extension detailed you created above, or follow and modify per example below
    
    Display name: Sanjay Intuittech
    Private Identity: 8000 (or your extension number)
    Public Identity: sip:8000@192.168.2.239 (if you are doing some NAT, it will be like sip:8000@202.188.0.133 where the IP will be a public IP or name)
    Password: C@mplEX123
    Realm: 192.168.2.239
    Now click Login!, you should see the text Connected, like above in my picture
34. Now, dial and dial away…..e.g. outbound call
    
35. Now I use my Zoiper softphone to dial 2001 (remember, it’s a “virtual” number we manipulated on FreePBX to dial SIP/8000 instead and here’s how it looks! Chrome receiving a call!
    
36. Now you can go ahead and try using it on another Chrome browser or other browsers, like Internet Explorer, Firefox and the rest and do give your feedback. But for other browsers you need a piece of software or set some configuration, see here.
37. For mobile browsers with WebRTC support, Google is still working on it with Chrome on Android and iOS. Meantime, you can checkout Bowser (yes BOWSER a WebRTC supported mobile web browser for iPhone and Android, however I had some issues with javascript complaining, hope you have better luck…If you did manage to get it to work, let us know and share with the community.
38. An important thing to note, Webrtc definition uses only g711 and OPUS. So, consider bandwidth repercussions using this solution as OPUS is not yet ready on Asterisk, so we have to live with g711 for now.
39. SipML5 folks updated the UI to include below buttons…
    

Don’t want the headaches of all of these installation steps, use PIAX - http://pbxinaflash.com/community/index.php?threads/new-webrtc-with-asterisk-11.15274/#post-99636 …ready to rock with WebRTC