VoIPensando

TLS sobre Windows disponible

2010-10-06T01:24:00.004-05:00

Tiempo atrás estaba revisando la seguridad que permite TLS en las comunicaciones IP. Cuando comencé a trabajar con FreeSWITCH sobre Windows para realizar la configuración de TLS para asegurar la parte de la señalización SIP, ohh sorpresa, TLS para Windows no estaba listo.

Todavía no se podía configurar directamente una interfaz para que soportara TLS, el problema es que todavía no estaba integrado, por lo que era necesario descargar y construir por separado Openssl, ahora bien, no conseguí un proyecto que pudiera compilar y ejecutar desde Visual Sudio lo que hacia necesario descargar Perl y usar los scripts que entregan directamente desde el proyecto Openssl. Una vez descargadas las herramientas la construcción de Openssl es realmente fácil conseguir, el producto de esta generación son principalmente tres archivos: libeay32.dll, ssleay32.dll y openssl.exe.

El espíritu del código entregado por el equipo de FreeSWITCH es que la generación está integrado en una extensa solución de Visual Studio 2008 o 2010 que descarga y construye todas las dependencias de terceros, las librería y módulos propios de tal forma que finalizada la compilación está listo para ser usado.

Con esta necesidad latente me di a la tarea de construir los proyectos (.vcproj) en Visual Studio para que se pudiera integrar la construcción de Openssl en la solución de Visual Studio de FreeSWITCH y además se constituyera en una alternativa para obtener Openssl aún fuera del alcance de FreeSWITCH.

La buena noticia es que los proyectos para construir Openssl están integrados ahora en la solución de Visual Studio de FreeSWITCH y es posible usar TLS para asegurar las llamadas ejecutando FreeSWITCH sobre Windows.

Archivos de audio en español

2010-05-13T19:40:00.000-05:00

Según el más reciente anuncio de la liberación de FreeSWITCH de la versión 1.0.6 ya se tienen los archivos de sonido en español, aunque todavía no se han publicado ya que están en revisión pronto los tendremos disponibles. El español es latinoamericano.

Medir Tonos en líneas análogas

2010-04-07T21:34:00.000-05:00

Cuando se trabaja con líneas análogas ya sea de la red pública o de una extensión de una PBX es muy importante conocer la frecuencia de los tonos para realizar una buena detección del tono de marcado (dialtone), del tono de desconección (disconect tone) para terminar la llamada, y del tono de ocupado (busy).

Normalmente cuando no se configuran adecuadamente los tonos se presentan problemas por ejemplo al finalizar la llamada, el puerto puede seguir ocupado cuando ya nadie está hablando sobre la línea.

Existen varias formas de medir la frecuencia ya sea simple o compuesta de cada tono, entre ellas desde las mas complejas usando un osciloscopio, con algún software que escucha sobre la línea, o una forma bastante simple pero muy efectiva usando Audacity.

La idea es grabar en un archivo de audio por ejemplo .wav lo que sucede en la línea, y posteriormente abrir el archivo con Audacity y analizar su espectro con lo cual se pueden hallar las frecuencias con buena exactitud. Para un mayor detalle sobre el procedimiento pueden ver este buen artículo en el blog de Asterisk Medellín.

Welltech Gateway

2010-04-06T22:05:00.000-05:00

Entre los Gateway con soporte para puertos FXO y FXS que son económicos y usan UDP para el transporte se encuentran los Welltech (http://www.welltech.com) yo los he usado y se portan bien ademas de mencionar la operabilidad que tienen con FreeSWITCH.

Hasta ahora el único detalle que he tenido que solucionar es el tema del manejo del flash-hook para los puertos FXO, si es necesario, no basta solo con enviar <action application="send_dtmf" data="F"/> ya que esto solo se interpreta del lado del Gateway como un tomo mas. Para conseguir que pueda propagar el flash-hook desde la señalización IP es necesario hacerlo con SIP INFO incluyendo en el body \n\r. Esto me valio para solicitar soporte a la gente de Welltech por el link de Support de su página y la verdad me ayudaron bastante con el tema y la atención fue rapida y efectiva.

Mod event socket en modo inbound

2010-02-22T21:18:00.000-05:00

“inbound” modo significa que usando ESL la aplicación se conecta como cliente a FreeSWITCH (FS) para el envío y recepción de eventos y comandos. (http://wiki.freeswitch.org/wiki/Mod_event_socket)

Ejemplo usando managed ESL

El siguiente fragmento de código establece una conexión con FS, subscribe a todos los eventos en formato de texto plano, y entra en un bucle esperando por un evento e imprimiéndole en pantalla cuando llega.

//Initializes a new instance of ESLconnection, and connects to the host $host on the port $port, and supplies $password to freeswitch
ESLconnection eslConnection = new ESLconnection("localhost", "8021", "ClueCon");

if (eslConnection.Connected() != ESL_SUCCESS)
{
Console.WriteLine("Error connecting to FreeSwitch");
return;
}

//Set log level
//ESL.eslSetLogLevel((int)enLogLevel.DEBUG);

// Subscribe to all events
ESLevent eslEvent = eslConnection.SendRecv("event plain ALL");

if (eslEvent == null)
{
Console.WriteLine("Error subscribing to all events");
return;
}

//Turns an event into colon-separated 'name: value' pairs. The format parameter isn't used
Console.WriteLine(eslEvent.Serialize(String.Empty));

// Grab Events until process is killed
while (eslConnection.Connected() == ESL_SUCCESS)
{
eslEvent = eslConnection.RecvEvent();
Console.WriteLine(eslEvent.Serialize(String.Empty));
}

managed ESL

2010-02-21T10:01:00.001-05:00

¿Qué es managed ESL ?

Es la librería que permite desde un lenguaje de .Net usar la Event Socket Library (ESL) de FreeSWITCH (FS).

Managed ESL establece comunicación con FreeSWITCH (FS) a través de socket encapsulando todo el manejo del socket y exponiendo los servicios suministrados por FS como clases manejadas en C#.

Managed ESL son clases que encapsulan los servicios de mod_event_socket (http://wiki.freeswitch.org/wiki/Mod_event_socket) expuestos con la estandarización obtenida de SWIG. Con SWIG se consigue una interfaz nativa en C++ y wrappers en C# que usan la interfaz de C++.

¿Qué se puede hacer?

Con managed ESL se puede conseguir control de la llamada, envío y recepción de eventos y comandos.

Como managed ESL se ejecuta fuera del contexto de ejecución de los procesos de FS, la aplicación que usa managed ESL puede ser publicada en una maquina remota o expuesta como un servicio simpre que se tenga conexión con FS a través un socket.

Construyendo managed ESL

En este momento solo se ha probado usando VisualStudio 2008 sobre Windows con Framework 2.0. Pronto se estará liberando para mono.

Pre-requisitos

VisualStudio 2008 (soporte para C y C#)
Framework 2.0
Windows

La solución de VS2008 para compilar managed ESL se encuentra en libs/esl/managed, es necesario que se tenga compilada la librería esl.lib que se construye con FreeSWITCH.

ESL, Manejo de eventos en FreeSwitch

2010-01-23T23:10:00.000-05:00

Si buscan manejar eventos sin depender del core de FreeSwitch o mejor sin necesitar que se ejecute, recomiendo que le den una revisada a ESL (Event Socket Library).

Con ESL se pueden recibir eventos y enviar comandos a FreeSwitch.

http://wiki.freeswitch.org/wiki/Event_Socket_Library

FreeSWITCH, Configuración de extensiones

2009-08-19T20:31:00.000-05:00

directory en FreeSWITCH

La carpeta directory contiene las extensiones SIP que se pueden registrar con FreeSWITCH, la configuración por default obliga a que las extensiones se autentiquen antes de aceptar su registro, posteriormente veremos como cambiar este comportamiento.

Cuando se instala en la carpeta directory se encuentra el archivo default.xml el cual define principalmente:

Mas información en:
http://wiki.freeswitch.org/wiki/Default_config
http://wiki.freeswitch.org/wiki/Config_directory.xml

domain: dominio o IP que identifica la extensión SIP de la forma numero_extension@domain_o_IP (ej: 1000@192.168.7.100).
group: definición de grupos de extensiones para hacer llamadas a un grupo
de tal forma que timbren todas las extensiones, la sintaxis para crealos es
la siguiente:

numero_extension_1 debe existir como un archivo XML en la carpeta directory

El tipo "pointer" permite que la misma definición de la extensión se pueda usar en multimples grupos sin ser necesario crear multiples
archivos XML con la información de la extensión.

Uno de las entradas mas importantes de default.xml es la inclusión de todos los archivos XML que se encuentran ubicados en
directroy/default/*.xml, con lo cual las extensiones se deberían definir en esta carpeta.

Extensiones en FreeSWITCH

Las extensiones que se registran con FreeSWITCH se deben ubicar en la carpeta conf/directory/default, estan definidas en archivo XML, comunmente los archivos se nombran con el identificador de la extensión.

Por ejemplo para definir la extensíón 1000 creamos el archivo 1000.xml con el siguiente contenido:

Algunas de las no obvias definiciones son:

vm-password: clave para accesar el buzón de voz
toll_allow: tipo de llamadas permitidas para la extensión: domestic,international,local.

Esta definición tiene sentido en el plan de marcación ( http://www.mail-archive.com/freeswitch-users@lists.freeswitch.org/msg02616.html)

accountcode: código asignado a la extensión, es usado para fines de tarificación por ello debe ser único por extensión

user_context: contexto de la extensión, define a que contexto pertenece la extensión. Un contexto una form lógica para agrupar extensiones.

FreeSWITCH, versión 1.0.4 oficialmente liberada

2009-08-06T07:27:00.000-05:00

El equipo de FreeSWITCH anunció la liberación de la versión 1.0.4, la última versión estable del producto que incluye muchas mejoras, corrección de bugs y nuevas características. Para mas información visitar. http://www.freeswitch.org/node/184

FreeSWITCH, archivos de configuración

2009-08-03T18:49:00.000-05:00

Los archivos de configuración

En la anterior entrega vimos como construir FreeSWITCH desde el código fuente, los archivos XML de configuración se encuentran en el directorio conf/, en el caso de Windows este directorio esta ubicado en Debug/ o Release/ según se haya escogido para su construcción desde el Visual Studio 2008. Para mayor información visitar: http://wiki.freeswitch.org/wiki/Getting_Started_Guide

freeswitch.xml

Es el archivo maestro de la configuración de FreeSWITCH, éste incluye los demas archivos de configuración convirtiendose en el punto de entrada en la carga de la configuración y preprosesamiento de variables.

vars.xml

Define variables globales al sistema que pueden ser accedidas desde un plan de marcación, este archivo contiene algunas líneas con la marca especial X-PRE-PROCESS, estas líneas no pueden ser comentados.

La sintaxis usada para definir una variable es:

<X-PRE-PROCESS cmd="set" data="nombre_variable=valor"/>

El valor de una variable previamente definida se obtiene así:

${nombre_variable} o $${nombre_variable}

La diferencia entre $ y $$ es el tipo de acceso, con $ el valor se obtiene cuando se usa la variable, con $$ se maneja como valor de preprocesador y se obtiene durante la carga de FreeSWITCH o se recarga la configuración del archivo freeswicth.xml con el comando relaodxml. La diferencia básica es que el valor con $ es expandido en el uso mientras con $$ es expandio en la carga del sistema.

- base_dir: define el directorio raíz donde se ejecuta FreeSWITCH

- sound_prefix: define el direcotrio donde se encuentran los archivos de audio (esta variable esta en revisión todavia aunque se usa en la actualidad)

- local_ip_v4: dirección IP local, esta variable la define automáticamente FreeSWITCH

- domain: define el dominio para identificar las extensiones registradas, asignado por defecto como $${local_ip_v4}

- global_codec_prefs: codecs disponibles para la negociación con las extensiones registradas

- outbound_codec_prefs: ocedecs disponibles para la negociación con gateways

- outbound_caller_name: este nombre se usa para mostrarlo en el teléfono cuando se hace una llamada

- outbound_caller_id: número usado para mostrarlo en el teléfono cuando se hace una llamada

El directorio autoload_configs contiene algunos archivos de configuración muy importante:

modules.conf.xml

Este archvio determina que modulos se van a carga durante el inicio de FreeSWITCH

sofia.conf.xlm

Archivo de configuración para definicioenes SIP

Plan de marcación (dialplan)

Los planes de marcación se definen en el directorio dialplan.

Extensiones (directory)

Las extensiones que pueden registrarse con FreeSWITCH se encuentran en el directorio directory.

FreeSWITCH, descarga y construcción

2009-08-02T18:23:00.000-05:00

Introducción

FreeSWITCH es uno de los mejores proyectos de comunicaciones de código abierto que hay en la actualidad, como lo describen en su sitio oficial http://www.freeswitch.org/

“FreeSWITCH is an open source telephony platform designed to facilitate the creation of voice and chat driven products scaling from a soft-phone up to a soft-switch. It can be used as a simple switching engine, a PBX, a media gateway or a media server to host IVR applications using simple scripts or XML to control the callflow.”

FreeSWITCH (escribiendo SWITCH en mayúscula) es una plataforma de telefonía de código abierto diseñada para facilitar la creación de productos de voz y chat escalando desde un soft-phone hasta un soft-switch. Puede ser usado como un motor de conmutación, una PBX, un media Gateway o un servidor de medios (media server) para alojar aplicaciones de IVR usando simples scritps o archivos XML para el control de flujo de la llamada.

En otras palabras FreeSWITCH se puede comportar como un simple soft-phone, una PBX o en realidad un soft-switch, por ello el campo de aplicación de esta plataforma resulta tan interesante.

Otra característica importante para los usuarios y programadores del mundo Windows es que puede ser construido y correr nativamente sobre Windows, también sobre Linux, Mac OS, BSD y Solaris tanto para 32 como para 64 bits (http://wiki.freeswitch.org/wiki/Specsheet).

Descargar el código fuente
FreeSWITCH está construido en lenguaje C y el proyecto usa Subversion como controlador de código fuente. Se pueden obtener dos revisiones desde el sitio de FreeSWITCH. Una de estas revisiones se consigue accediendo directamente a través de un cliente de Subversión el trunk de proyecto que tiene la versión más actualizada del código fuente pero no necesariamente estable. La otra revisión son las versiones estables o de prueba que se pueden acceder directamente a través una URL.

Bajando el código fuente a través de Subversion
En este link se encuentra información del sitio oficial para la descarga: http://wiki.freeswitch.org/wiki/Download_FreeSWITCH

Cuando se trabaja en Windows se tienen varias opciones para acceder a un repositorio manejado con Subversion, en esta entrega vamos a usar RapidSVN (http://rapidsvn.tigris.org/) que es un cliente sencillo pero trabaja bien y nos va a permitir descarga el código fuente.

El código fuente puede ser conseguido desde:

http://svn.freeswitch.org/svn/freeswitch/trunk

Una vez instalamos RapidSVN se debe configurar la URL desde el menú Repositorio -> Exportar e ingresamos la URL del código fuente para su descarga.

Figura 1. Configuración RapidSVN para descarga del código fuente.

Se debe escoger el directorio destino y seleccionar la opción “Sobrescribir”, ver figura 1.

Si tenemos la posibilidad de usar los programas de línea de comandos de Subversion se puede obtener el código fuente desde:

svn co http://svn.freeswitch.org/svn/freeswitch/trunk directorio_destino

Bajar el código fuente directamente desde los archivos de FreeSWITCH
Las versiones de prueba o estables son normalmente publicadas en http://files.freeswitch.org/

Una vez obtenido el archivo se descomprime y el código fuente estará disponible.

Construcción desde el código fuente
Se debe contar con Visual Studio 2008 la versión licenciada o la versión Express, para la compatibilidad con C# es necesario que se tenga instalado el Framework 3.5 o Mono 2.0 y que el Visual Studio pueda compilar código fuente C y C#.
Más información: http://wiki.freeswitch.org/wiki/Installation_Guide

Se debe abrir la solución Freeswitch.2008.sln

Una vez abierta la solución se debe construir, es necesario garantizar la conexión a Internet ya que se van a descargar automáticamente algunos componentes. Una vez terminada la construcción ya contamos con los ejecutables:

- FreeSwitch.exe (ejecuta una instancia de FreeSWITCH)
- fs_cli.exe (permite conectar a una instancia de FreeSWITCH que se está ejecutando).

En la próxima entrega veremos la configuración de FreeSWITCH.