Uso en Pandora FMS

El  plugin Telegram® viene plenamente integrado en Pandora FMS versión 800. 

 El script por defecto está ubicado en:   /usr/share/pandora_server/util/pandora-telegram-cli.py . No obstante se puede usar cualquier ubicación siempre que el PFMS Server tenga acceso a esta. 

 Se debe asegurar de que se tienen todas las dependencias instaladas , p ara comprobarlo se ejecuta : 

 python3 pandora-telegram-cli.py 

 Se obtendrá una respuesta similar a esta: 

 

 En caso de tener algún error se deberán reinstalar las dependencias: 

 pip3 install -r requirements.txt 

   

 Comando de alerta Telegram 

 Teniendo el  plugin en el servidor y funcionando correctamente, ahora tenemos que configurarlo en la Consola web de Pandora FMS. Una vez accedemos como usuario administrador (o con permisos de gestión de alertas) se verifica la instalación del comando de alerta Telegram en el menú Management → Alerts→Commands . En Filter introduzca la clave de búsqueda: 

 

 Este comando carece de acciones de edición y borrado por lo que se considera de solamente lectura, utilizado por el sistema. Por ello deberá ir a la configuración general para grabar el  token  obtenido en el tema anterior. 

 Menú  Managements → Settings → System settings → General setup → Alerts configuration : 

 

 El campo muestra en  texto plano  el  token , tómese las precauciones del caso antes visualizaciones por terceros del mismo. 

 Al finalizar pulse el botón  Update  para guardar el  token de Telegram en la base de datos. 

 Acción de alerta Telegram 

 Vaya al menú Management→  Alerts→ Actions  y en  Filter  elija  Pandora Telegram  en el campo  Command . Serán mostradas las acciones de alerta que utilizan el comando  Pandora Telegram : 

 

 Bien puede: 

 

 Utilizar la acción que viene por defecto al instalar Pandora FMS. 

 Copiar la acción anterior y personalizar según necesidades. Puede darse el caso de que varios grupos de agentes utilicen distintas acciones de alerta configuradas según cada caso. 

 Crear una acción basada en el comando de alerta (de solo lectura) Telegram. 

 

 Para cualquiera de los tres casos  siempre  se deberá configurar el  Chat ID , obtenido según se indica en  tema anterior . 

 Sea edición, copia y edición o creación, el proceso de configuración es similar: 

 

 

 En nombre y grupo indique y elija según el caso. 

 Asegúrese que en la lista  Command  esté seleccionado  Pandora Telegram . 

 En  Chat ID  introduzca el identificador correspondiente.  Este campo no acepta macros, solamente introduzca dicho identificador. 

 En el campo  Message  para  Triggering , si está vacío, inserte  [PANDORA] Alert FIRED on _agent_ / _module_ / _timestamp_ / _data_  . Consulte las demás  macros disponibles  para insertar más información. 

 En el campo  Message  para  Recovery , si está vacío, inserte  [PANDORA] Alert RECOVERED on _agent_ / _module_ / _timestamp_ / _data_  . Consulte las demás  macros disponibles  para insertar más información. 

 Presione el botón  Create  si es está creando una acción de alerta o(  Update  si se está editando) para guardar los parámetros. 

 

 Haga clic en  Create . Una vez haya creado esta acción de alerta, esta puede ser incluida en  una política ,  una plantilla  o  Módulo . 

 Si se requiere información adicional visite la  documentación del  plugin .