AMI - Historial de revisiones

SirLouen en 16:46 6 jul 2014

2014-07-06T16:46:38Z

SirLouen: /* Enlaces Externos */

2012-06-19T11:55:46Z

Enlaces Externos

SirLouen en 22:40 3 jun 2012

2012-06-03T22:40:58Z

SirLouen en 22:29 3 jun 2012

2012-06-03T22:29:29Z

SirLouen en 08:18 30 may 2012

2012-05-30T08:18:08Z

SirLouen en 23:30 29 may 2012

2012-05-29T23:30:15Z

SirLouen en 23:29 29 may 2012

2012-05-29T23:29:50Z

SirLouen en 22:28 29 may 2012

2012-05-29T22:28:04Z

SirLouen en 20:01 29 may 2012

2012-05-29T20:01:25Z

SirLouen en 20:00 29 may 2012

2012-05-29T20:00:00Z

← Revisión anterior		Revisión del 16:46 6 jul 2014
Línea 1:		Línea 1:
	Las siglas AMI vienen de '''Asterisk Manager Interface''', o Interfaz para la Gestión de Asterisk. Si pudieramos comparar a Asterisk con una [http://es.wikipedia.org/wiki/PBX PBX], AMI sería el equivalente a un CTI (Computer Interface Integration, o Interfaz de Integración con el Ordenador). Hay que considerar que aunque paradojicamente, Asterisk ya es un programa de ordenador en si, como veníamos diciendo, si consideraramos a Asterisk como otra PBX, sería como una interfaz para la integración con '''otras''' aplicaciones de ordenador.		Las siglas AMI vienen de '''Asterisk Manager Interface''', o Interfaz para la Gestión de Asterisk. Si pudieramos comparar a Asterisk con una [http://es.wikipedia.org/wiki/PBX PBX], AMI sería el equivalente a un CTI (Computer Interface Integration, o Interfaz de Integración con el Ordenador). Hay que considerar que aunque paradojicamente, Asterisk ya es un programa de ordenador en si, como veníamos diciendo, si consideraramos a Asterisk como otra PBX, sería como una interfaz para la integración con '''otras''' aplicaciones de ordenador.
		+
		+	{{Centrar\|{{#Widget:AdSense}}}}

	__TOC__		__TOC__

← Revisión anterior		Revisión del 11:55 19 jun 2012
Línea 223:		Línea 223:
	* [http://www.voip-info.org/wiki/view/asterisk+manager+events Información sobre eventos] de AMI, y ejemplos de algunos de los eventos más comunes.		* [http://www.voip-info.org/wiki/view/asterisk+manager+events Información sobre eventos] de AMI, y ejemplos de algunos de los eventos más comunes.

−	[[Categoría:~~General~~]]	+	[[Categoría:Avanzado‏‎]]

@@ Línea 1: / Línea 1: @@
 Las siglas AMI vienen de '''Asterisk Manager Interface''', o Interfaz para la Gestión de Asterisk. Si pudieramos comparar a Asterisk con una [http://es.wikipedia.org/wiki/PBX PBX], AMI sería el equivalente a un CTI (Computer Interface Integration, o Interfaz de Integración con el Ordenador). Hay que considerar que aunque paradojicamente, Asterisk ya es un programa de ordenador en si, como veníamos diciendo, si consideraramos a Asterisk como otra PBX, sería como una interfaz para la integración con '''otras''' aplicaciones de ordenador.
@@ Línea 182: / Línea 179: @@
 * '''AbsoluteTimeout''': Sirve para asignar un tiempo absoluto, equivalente a su [[Funciones|función]]
-=== Comandos para Recopilar Información ===
+=== Comandos para Mostrar Información ===
 Todos aquellos comandos que nos permiten obtener mas información de varios aspectos de Asterisk englobados en el comando '''reporting''':
@@ Línea 194: / Línea 191: @@
 * '''VoicemailUsersList''': Muestra la lista de usuarios del sistema de [[Buzones de Voz]].
 * '''MeetmeList''': Muestra los usuarios que se encuentran en una sala de conferencias [[MeetMe]].
-* '''CoreStatus'''       system,reportin  Show PBX core status variables.
+* '''CoreStatus''': Muestra el estado de las variables globales en Asterisk.
-* '''CoreSettings'''     system,reportin  Show PBX core settings (version etc).
+* '''CoreSettings''': Muestra la configuración general del sistema Asterisk
-* '''ShowDialPlan'''     config,reportin  Show dialplan contexts and extensions
+* '''ShowDialPlan''': Muestra los contextos y las extensiones del Dialplan
-* '''CoreShowChannel'''  system,reportin  List currently active channels.
+* '''CoreShowChannel''': Muestra todos los canales activos
-* '''MailboxCount'''     call,reporting,  Check Mailbox Message Count.
+* '''MailboxCount''': Comprueba el numero de mensajes en un buzon concreto.
-* '''MailboxStatus'''    call,reporting,  Check mailbox.
+* '''MailboxStatus''': Comprueba el estado de un [[Buzones de Voz||buzon de voz]]concreto
-* '''ExtensionState'''   call,reporting,  Check Extension Status.
+* '''ExtensionState''': Comprueba el estado de una extensión
-* '''Status'''           system,call,rep  List channel status.
+* '''Status''': Muestra el estado de un canal concreto.
-=== Comandos de Configuración ===
+=== Comandos de Configuración de Asterisk ===
-* '''Reload'''           system,config,a  Send a reload event.
+* '''Reload''': Recarga la configuración de asterisk
-* '''UpdateConfig '''    config,all       Update basic configuration.
+* '''UpdateConfig ''': Actualiza la configuración basica de Asterisk
-* '''ListCategories'''   config,all       List categories in configuration file.
+* '''ListCategories''': Muestra las categorias en un fichero de configuración
-* '''CreateConfig'''   config,all       Creates an empty file in the configuration directory.
+* '''CreateConfig''': Crea un fichero de configuración vacio en el directorio de configuración por defecto.
-* '''GetConfigJSON'''    system,config,a  Retrieve configuration (JSON format).
+* '''GetConfigJSON''': Recoge la información de configuración en formato JSON
-* '''GetConfig'''        system,config,a  Retrieve configuration.
+* '''GetConfig''': Recoge la información de configuración en texto plao
 == Referencias ==

@@ Línea 121: / Línea 121: @@
 Cada comando viene precedido como vimos antes por una cabecera '''Event:'''. A continuación vamos a ver algunos comandos de ejemplo, que podrían verse en una comunicación cualquiera:
--- Falta completar --
+=== Comandos Generales ===
 == Referencias ==
@@ Línea 135: / Línea 224: @@
 * [http://www.asternic.org Flash Operator Panel] es un panel de control para observar el estado de las lineas, las [[Colas]], y otros aspectos de Asterisk en tiempo real.
 [[Categoría:General]]

← Revisión anterior		Revisión del 08:18 30 may 2012
Línea 79:		Línea 79:
	Por otro lado, el resto de los parámetros definen algunos comportamientos y el resto de parámetros para su correcta autenticación:		Por otro lado, el resto de los parámetros definen algunos comportamientos y el resto de parámetros para su correcta autenticación:

		+	* '''secret''': La contraseña para el usuario que hayamos definido, en formato texto plano
		+	* '''deny''': Si queremos bloquear el acceso a alguna subred o dirección concreta, el formato: IP/Mascara de red, si ponemos la genérica 0.0.0.0/0.0.0.0 bloqueamos todo por defecto
		+	* '''permit''': Redes o Direcciones IP permitidas de acceso, justo lo contrapuesto, si hemos especificado la genérica en '''deny''' aqui podemos desbloquear las redes o direcciones a nuestra voluntad, esto aportaría un nivel mayor de [[Seguridad]] especialmente si pudiéramos identificar exactamente una dirección desde la cual van a producirse las conexiones a AMI.
		+	* '''eventfilter''': Este parámetro sirve si queremos establecer filtros de visualización en determinados Eventos exclusivos. Si tenemos un nivel de manejo sobre la aplicación que esta interfasada con nuestro AMI, o si es de nuestra propia creación, podríamos facilitar la tarea filtrando en detalle. Podemos poner varios tipos de expresiones regulares, incluyendo una exclamación para indicar lo que no queremos visualizar, y el Asterisco para indicar que afecta a todas las coincidencias que cumplan el resto de la expresión. Ej: '''Event: New*''', solo incluiría eventos tipo NewChannel, NewExten, etc...
		+	* '''writetimeout''': Expresado en milisegundos, considerar que dependiendo como hayamos diseñado el interprete de AMI es posible que si no establecemos unas "pausas" mínimas entre evento y evento, podrían escaparse algunos eventos y afectar al buen funcionamiento del mismo. Con este parámetro podremos regular esto, expresando de cuanto queremos que sean esos intervalos.

		+	Por último existen dos parámetros orientados a los permisos de acceso. Hay que considerar que cada Comando, necesita unos permisos de acceso u otros, y es posible, tanto dar permisos de lectura a estos comandos como de escritura. Los parámetros serían:
		+	* '''read''': Englobando todos los permisos de lectura
		+	* '''write''': Englobando los de escritura

		+	Los permisos de organizan por bloques. Si utilizamos el permiso '''all''' damos acceso a todos los comandos para un tipo de permiso de los dos, por tanto si especificamos:
		+
		+	* '''read = all'''
		+	* '''write = all'''
		+
		+	Para ese usuario en concreto damos acceso integral al sistema AMI. En cierto nivel, esto también supone un riesgo en la seguridad, por lo que sería conveniente intentar establecer los permisos acordes a lo que pueda hacer la aplicación, '''especialmente si se tratan de permisos de escritura''', dado que con ellos, se podría operar con nuestra máquina Asterisk como si estuviera físicamente en ella como podremos ver más en detalle en [[Seguridad]].
		+
		+	Los grupos de acceso son los siguientes:
		+
		+	* '''system''': Información del sistema interno Asterisk y la posibilidad de ejecutan comandos relacionados al sistema directamente, como reiniciar el servicio, etc.
		+	* '''call''': Información sobre los canales de llamada, y el acceso a poder cursar las mismas a través de ellos
		+	* '''log''': Acceso de lectura exclusivamente para el sistema de logging
		+	* '''verbose''': Acceso de lectura para las capacidad de mostrar información en detalle
		+	* '''agent''': Información sobre el sistema de [[Colas]] y la posibilidad de introducir Agentes dentro de las mismas.
		+	* '''user''': Posibilidad de mostrar y enviar eventos relacionados a Usuario, todavía no hay nada definido al respecto.
		+	* '''config''': Acceso informativo y posibilidad de modificar lo relación a ficheros de configuración.
		+	* '''command''': Posibilidad de lanzar y leer comandos de la [[CLI]]
		+	* '''dtmf''': Acceso de solo lectura para poder recibir las pulsaciones producidas por tonos [[DTMF]]
		+	* '''reporting''': Información general del sistema, como información sobre pares [[SIP]], [[IAX]], etc.
		+	* '''cdr''': Acceso de solo lectura, para información relativa al [[Registro Llamadas y Eventos]]
		+	* '''dialplan''': Acceso de solo lectura para ver el recorrido a traves del Dialplan de las llamadas en curso.
		+	* '''originate''': Posibilidad de generación automática de llamadas. Fundamental para los [[Generación Automática de Llamadas\|Marcadores]]
		+	* '''agi''': Integración entre [[AGI]] y AMI Podemos ver información sobre comandos AGI ejecutados, o lanzar aplicaciones AGI que conozcamos.
		+	* '''cc''': Acceso de solo lectura, sobre manipuladores de la llamada ([[Buzones de Voz]], transferencias, etc)
		+	* '''aoc''': Posibilidad de enviar y recibir mensajes de "Advice of Charge" <ref>[https://wiki.asterisk.org/wiki/display/AST/Advice+of+Charge Advice of Charge], Wiki Oficial de Asterisk en Ingles, Digium Inc.</ref>
		+	* '''test''': Si tenemos funciónes habilitadas de prueba, para depuración y modificación del codigo, podemos recibir los eventos de Test enviados al sistema de testing de Asterisk
		+	* '''message''': Podemos lanzar a AMI, mensajes de llamada.
		+
		+	== Registro de Comandos ==
		+
		+	Cada comando viene precedido como vimos antes por una cabecera '''Event:'''. A continuación vamos a ver algunos comandos de ejemplo, que podrían verse en una comunicación cualquiera:
		+
		+	-- Falta completar --

	== Referencias ==		== Referencias ==

@@ Línea 51: / Línea 51: @@
 Esto significa, que nuestra interfaz Asterisk, ha recibido un comando Hangup (Fin de la Conversación), por el canal SIP para el dispositivo ext11, y la Causa ha sido NO ANSWER (Sin respuesta). El Uniqueid, identificaría en este caso, un evento con un código único, basado en una marca de tiempo aleatoria, podría utilizarse con fines de indexación si estamos registrando todos los eventos de alguna forma.
-== Configuración del Manager ==
+== Configuración del Mánager ==
 Como comentábamos al principio, AMI es realmente un concepto de Comunicaciones Unificadas más que un simple CTI, y otra prueba de ello es que la conexión a AMI se realiza a través del protocolo TCP/IP. Concretamente el puerto por defecto que se suele utilizar para este propósito es el 5038. También existe la posibilidad de habilitar la funcionalidad de conectar con interfaces basadas en la web y aplicaciones como navegadores, utilizando el protocolo HTTP, gracias a una tecnología diseñada específicamente para Asterisk basada en Java y AJAX, llamada AJAM (Asynchronous Javascript Asterisk Manager), parecida a AJAX con respecto a la equivalencia con uso de mensajes XML, y para ello se utiliza por defecto el puerto 8088.
-== Configuración General ==
+=== Configuración General ===
 La estructura del fichero es muy estándar como vistas en otros módulos como [[SIP]], [[IAX]], e incluso el fichero referente a [[Colas]], definido por contextos entre corchetes, considerando uno general donde se engloban todas las opciones genéricas referentes al funcionamiento de AMI, y también otras que afectan a todos los contextos específicos por igual. En este caso el contexto principal sería '''<nowiki>[general]</nowiki>''', y el resto de los contextos serían los usuarios del sistema con sus parámetros concretos.
@@ Línea 73: / Línea 73: @@
 * '''httptimeout''': Elegimos la cantidad de segundos que una sesión HTTP puede quedar activa antes de necesitar volverse a autentificar, en terminos de vida de una "cookie", tiempo despues de complentar una acción con éxito, o tiempo después de recibir un evento tipo WaitEvent, sin respuesta
-== Configuración de Usuarios ==
+=== Configuración de Usuarios ===
 Por otra parte, tenemos que configurar los usuarios que tienen permitido el acceso a la interfaz. El nombre del contexto, tiene que ser justamente el mismo, que el nombre de usuario que queramos definir, por tanto si creamos el contexto <nowiki>[asterisk]</nowiki> tendremos un usuario para acceder a AMI llamado "asterisk".

@@ Línea 32: / Línea 32: @@
 == Funcionamiento General ==
-La interfaz AMI se basa en un flujo de datos en formato de texto plano (lo que puede ser un gran compromiso para la [[Seguridad]] de nuestro sistema Asterisk)
+La interfaz AMI se basa en un flujo de datos en formato de texto plano (lo que puede ser un gran compromiso para la [[Seguridad]] de nuestro sistema Asterisk), y con una estructura Estandarizada que se preserva desde la primera versión.
 == Referencias ==

@@ Línea 8: / Línea 8: @@
 == Introducción a CTI ==
-[[Image:key_system2.jpg|thumb|Clásico Key System de 6 Botones|right|200px]]
+[[Image:Early_302-based_model_464G_Western_Electric_Key_Telephone_Set.jpg|thumb|Clásico Key System de 6 Botones|right|200px]]
 Es interesante conocer algo sobre los sistemás CTI que incorporan muchas PBX del mercado. En los años 70, varios años después de la primera central conmutada, surgieron las primeras integraciones de sistemas no relacionadas exclusivamente con la función de conmutación de llamadas provenientes de los "Key Systems" (sistemas más sencillos que las PBX, basados en teléfonos con muchos botones) y de las propias PBX, que daban funcionalidades adicionales a las "sencillas" centralitas, como la posibilidad de tener una Operadora Autómatica, [[Buzones de Voz]] e incluso [[Generación Automática de Llamadas|Marcadores Predictivos]] bastante funcionales.

@@ Línea 26: / Línea 26: @@
 * Aplicaciones basadas en la Monitorización: Por ejemplo para el control de usuarios, colas como Flash Operator Panel <ref>[http://www.asternic.org Flash Operator Panel], Nicolás Gudiño (2004)</ref>
-* Aplicaciones relacionadas al control de las llamadas, como A2Billing <ref>[http://www.asterisk2billing.org/ A2Billing], Star2billing S.L. (2004) sistema de facturación integrado en Asterisk para el control de los tiempos de llamada.
+* Aplicaciones relacionadas al control de las llamadas, como A2Billing <ref>[http://www.asterisk2billing.org/ A2Billing], Star2billing S.L. (2004)</ref> sistema de facturación integrado en Asterisk para el control de los tiempos de llamada.
 * Sistemas para marcado, como son los Dialers según visto en [[Generación Automática de Llamadas]], basados en en la interfaz AMI para su funcionamiento.