1 / 21

Asterisk

Asterisk. Asterisk Manager Interface. ASTERISK MANAGER API. Permite a una aplicación cliente conectarse a una instancia de Asterisk vía TCP/IP y ejecutar comandos o leer eventos. Generalmente, se utiliza el puerto 5038.

leroy-atkins
Télécharger la présentation

Asterisk

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Asterisk Asterisk Manager Interface

  2. ASTERISK MANAGER API Permite a una aplicación cliente conectarse a una instancia de Asterisk vía TCP/IP y ejecutar comandos o leer eventos. Generalmente, se utiliza el puerto 5038. Utiliza un protocolo en modo texto que consiste en líneas de tipo "clave: valor". Conjunto de líneas: paquete. Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  3. MANAGER: PROTOCOLO 1) Se debe establecer una sesión con el manager antes de ejecutar comandos. 2) Los paquetes pueden ser transmitidos en ambas direcciones. 3) El orden de las líneas dentro del paquete es indistinto. 4) Las líneas se delimitan con CRLF y una línea en blanco (2 CRLF consecutivos) indica el final del paquete. Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  4. MANAGER: TIPOS DE PAQUETE El tipo de paquete está dado por las siguientes claves: Action: paquete originado en el cliente requiriendo llevar a cabo una acción particular. Contiene el nombre de la acción y los parámetros de la misma. Response: la respuesta del Asterisk a la Acción requerida por el cliente. Event: datos correspondientes a un evento generado dentro del núcleo de Asterisk o módulo. Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  5. MANAGER: AUTENTICACIÓN Las cuentas de usuario se configuran en /etc/asterisk/manager.conf. Por ej: [general] enabled=yes [admin] secret = claveadmin deny=0.0.0.0/0.0.0.0 permit=127.0.0.1/255.255.255.0 read = system,call,log,verbose,command,agent,user,originate write = system,call,log,verbose,command,agent,user,originate En este caso, "admin" es el nombre de usuario, la clave es "claveadmin" y sólo se permiten conexiones para este usuario vía localhost. El resto de las líneas establecen permisos (r,w,r/w) para cada clase (system, call, etc.). Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  6. MANAGER: CONEXIÓN Enviar un mensaje con acción "Login", junto con el usuario y la clave como parámetros. Por ej: Action: login Username: admin Secret: adminclave Events: off (La última línea indica que la conexión no recibirá eventos por parte del Asterisk.) Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  7. MANAGER: CONEXIÓN Se recibirá por parte del servidor Asterisk Call Manager/1.0 Response: Success Message: Authentication accepted O, en caso de error: Asterisk Call Manager/1.0 Response: Error Message: Authentication failed Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  8. MANAGER: PAQUETES ACTION Se pueden proveer parámetros adicionales (por ej, un número a llamar o canal a desconectar). En el caso que la acción determine la ejecución de una entrada del plan de marcación, también se pueden proveer variables. Formato: Action: <action type><CRLF> <Key 1>: <Value 1><CRLF> <Key 2>: <Value 2><CRLF> ... Variable: <Variable 1>=<Value 1><CRLF> Variable: <Variable 2>=<Value 2><CRLF> ... <CRLF> Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  9. MANAGER: PAQUETES ACTION Algunos ejemplos de acciones Command: ejecuta un comando (por ej, reload) (privilege: command,all) DAHDIHangup: cuelga un canal DAHDI DAHDIShowChannel: muestra los canales DAHDI DAHDITransfer: transfiere un canal DAHDI Events: controla el flujo de los eventos Hangup: colgar canal (privilege: call,all) IAXpeers: lista los peers IAX (privilege: system,all) ListCommands: lista los comando disponibles del manager Logoff: logoff del manager MailboxCount: verifica la cantidad de mensajes en el mailbox (privilege: call,all) MailboxStatus: verifica el status del mailbox (privilege: call,all) Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  10. MANAGER: PAQUETES ACTION Algunos ejemplos de acciones (cont.) Monitor: comienza a monitorear un canal (graba un archivo con el audio) (privilege: call, all). Originate: origina llamada (privilege: call,all,originate) Park: realiza un parking de la llamada. ParkedCalls: lista las parked calls (privilege: call, all). QueueAdd: agrega un miembro a la cola (privilege: agent,all) Queues: devuelve configuración e información estadística de las colas. QueueRemove: remueve un miembro de la cola (privilege: agent,all) SIPpeers: lista los peers SIP (privilege: system,all) Status: Status (privilege: call,all) Redirect: transfiere una llamada (privilege: call, all) UpdateConfig: actualiza configuración básica del servidor (privilege: config,all) Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  11. MANAGER: CLI Los siguientes comandos pueden ser ejecutados en la CLI para obtener información sobre el manager: manager show command <command>: muestra información sobre el comando <command> del manager manager show commands: lista todos los comandos del manager manager show connected: lista los usuarios conectados al manager manager show users: lista los usuarios configurados para acceder al manager Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo 11

  12. MANAGER: EJEMPLO LLAMADA El cliente envía: ACTION: Originate Channel: SIP/12345 Exten: 1234 Priority: 1 Context: default El cliente recibe, en caso de éxito: Event: Newchannel Channel: SIP/12345-ed8f State: Down CallerID: Uniqueid: 1124982019.19157 Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  13. MANAGER: EJEMPLO LLAMADA El cliente recibe, en caso de éxito (cont): Event: Newchannel Channel: SIP/12345-ed8f State: Ringing CallerID: Uniqueid: 1124982019.19157 Event: Newstate Channel: SIP/12345-ed8f State: Up CallerID: Uniqueid: 1124982019.19157 Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  14. MANAGER: EJEMPLO LLAMADA El cliente recibe, en caso de éxito (cont): Event: Newexten Channel: SIP/12345-ed8f Context: default Extension: 1234 Priority: 1 Application: Dial AppData: SIP/pepe Uniqueid: 1124982019.19157 Response: Success Message: Originate successfully queued Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  15. MANAGER: EJEMPLO LLAMADA El cliente recibe, en caso de error: Event: Newexten Channel: OutgoingSpoolFailed Context: default Extension: failed Priority: 1 Application: SetVar AppData: extension=failed Uniqueid: 1124981514.58775 Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  16. MANAGER: EJEMPLO LLAMADA El cliente recibe, en caso de error (cont): Event: Hangup Channel: OutgoingSpoolFailed Uniqueid: 1124981514.58775 Cause: 0 Response: Error Message: Originate failed Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  17. MANAGER: Ejemplo en PHP <?php // Apertura del socket $socket = fsockopen("127.0.0.1","5038", $errno, $errstr, $timeout); // Login del usuario fputs($socket, "Action: Login\r\n"); fputs($socket, "UserName: admin\r\n"); fputs($socket, "Secret: amp111\r\n\r\n"); // Lista los comandos disponibles para la clave Action fputs($socket, "Action: ListCommands\r\n\r\n"); // Logoff del usuario fputs($socket, "Action: Logoff\r\n\r\n"); Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo 17

  18. MANAGER: Ejemplo en PHP // Obtiene la respuesta del manager while (!feof($socket)) { $wrets .= fread($socket, 8192); } // Cierra el socket fclose($socket); // Muestra la salida del manager por pantalla echo <<<ASTERISKMANAGEREND ASTERISK MANAGER OUTPUT: $wrets ASTERISKMANAGEREND; ?> Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo 18

  19. MANAGER: PROBLEMAS La documentación sobre el protocolo y la funcionalidad del manager está incompleta. No es estable con el manejo de una cantidad grande de conexiones a la vez. Es recomendada la utilización de un Proxy (por, ej ProxyAstMan), para sistemas que hagan un uso intensivo del manager, como pueden ser sistemas de monitoreo, panel de control y campañas/encuestas telefónicas. Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  20. Ejercicio 11: AMI Administrar y utilizar la funcionalidad del servidor Asterisk vía la AMI Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

  21. julian@dunayevich.com lazaro.baca@gmail.com abrassara@gmail.com salberch@gmail.com antoniwolf@gmail.com Curso elaborado por Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch y Antonio Lobo Detalles de la licencia: http://creativecommons.org/licenses/by-nc-sa/2.5/deed.es_AR Autores: Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo(cc) Creative Commons - Attribute Non-Commercial Share-Alike 2.5 Basándose en: Irontec: contacto@irontec.com (CC) Asterisk, The Future of Telephony, Jim Meggelen, Jared Smith, and Leif Madsen, O´REILLY, 2005 Julián Dunayevich, Lázaro Baca, Andrés Brassara, Santiago Alberch, Antonio Lobo

More Related