# Integración con Discord # Configuración en Discord: creación de un servidor Para integrar Pandora FMS con Discord se necesita de [un **servidor** y un canal](https://www.youtube.com/watch?v=qT8-AFgL0oQ&t=38s), en este caso un **canal de texto**. Si bien puede utilizar un servidor que ya disponga, acá se explica la creación de uno: en la barra lateral izquierda ubique el botón **Add server** y abrirá un pequeño asistente que indagará el propósito del nuevo servidor. [![PFMS_Discord_integration_010.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-010.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-010.png) Establezca un nombre de servidor (obligatorio) y una imagen que lo identifique (opcional): [![PFMS_Discord_integration_020.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-020.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-020.png) Para efectos prácticos es mejor tener un canal exclusivo para las alertas de Pandora FMS, aunque puede utilizar uno que ya tenga. Para crear un **canal de texto** haga clic en el botón "+" que acompaña el enunciado: [![PFMS_Discord_integration_030.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-030.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-030.png) Coloque un nombre adecuado para el nuevo canal de texto: [![PFMS_Discord_integration_040.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-040.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-040.png) Recuerde enviar invitación al servidor y canal a las personas que integran su departamento de trabajo. [< ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-discord) [SIGUIENTE >](https://pandorafms.com/guides/public/books/integracion-con-discord/page/configuracion-en-discord-creacion-de-un-enlace-de-conexion) # Configuración en Discord: creación de un enlace de conexión Se debe crear un *anzuelo web* o **webhook** el cual se encargará de "escuchar y pescar" los mensajes de alerta emitidos por Pandora FMS por medio de un enlace de conexión. [Para crear un *webhook*](https://www.youtube.com/watch?v=qT8-AFgL0oQ&t=136s) debe editar el canal de texto que fue creado en la página anterior: [![PFMS_Discord_integration_060.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-060.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-060.png) En el cuadro de diálogo que aparece, seleccione **Integrations** y luego **Create Webhook**: [![PFMS_Discord_integration_070.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-070.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-070.png) A continuación escriba un nombre para el nuevo *webhook*, si desea seleccione una imagen para el mismo. Luego **haga clic en el botón *Copy Webhook URL* y guárdelo ya que será necesario en la siguiente página.** Por último en Discord, guarde el *webhook* en el botón **Save Changes**. [![PFMS_Discord_integration_080.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-080.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-080.png) [< ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-discord/page/configuracion-en-discord-creacion-de-un-servidor) [SIGUIENTE >](https://pandorafms.com/guides/public/books/integracion-con-discord/page/configuracion-en-pandora-fms-creacion-de-un-comando-de-alerta) # Configuración en Pandora FMS: creación de un comando de alerta En la [Librería de Pandora FMS](https://pandorafms.com/library/discord-connector-cli/) se encuentra la integración con Discord además de una detallada documentación en caso de que necesite más instrucciones. Esencialmente debe tener instalado **python3** y **pip3** para cumplir con las dependencias. Descargue y descomprima el paquete y dentro de esa carpeta recién creada instale los requerimientos adicionales: ```shell pip3 install -r requirements.txt ``` Una vez hecho esto bien puede invocar la ayuda por medio de `python3 pandora_discord_cli.py -h` . Se recomienda [hacer una prueba](https://www.youtube.com/watch?v=qT8-AFgL0oQ&t=181s) desde la misma línea de comandos con el *enlace de conexión* **(webhook-url)** obtenido en la página anterior: ```shell python3 pandora_discord_cli.py -u -d "Data=5, Agent=Test, Module=Ping" ``` Espere unos instantes y vaya a Discord, deberá obtener algo parecido a la siguiente captura de pantalla: [![PFMS_Discord_integration_110.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-110.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-110.png) Asegúrese de que el integrador esté en la siguiente ruta: `/usr/share/pandora_server/util/pandora-discord` (o donde el servidor Pandora FMS tenga acceso al mismo). Para crear un [comando de alerta](https://pandorafms.com/manual/es/documentation/04_using/01_alerts) vaya a la [Consola web de Pandora FMS](https://pandorafms.com/manual/es/documentation/02_installation/03_interface) y haga clic en **Alerts** -> **Commands** -> **Create**. [![PFMS_Slack_integration_150.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-slack-integration-150.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-slack-integration-150.png) Configure cada uno de los siete campos que necesita el comando; en el fichero `test-exec` que [acompaña al *Discord connector CLI*](https://www.youtube.com/watch?v=qT8-AFgL0oQ&t=401s) puede obtener cada uno de ellos. Preste atención al campo número uno, el cual debe contener, de manera oculta, el *enlace de conexión* del *webhook* del canal de texto creado en Discord. Agregue el grupo que podrá acceder al envío de alertas. [![PFMS_Discord_integration_140.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-140.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-140.png) Presione el botón **Update** para guardar e ir al siguiente paso, la creación de una acción de alerta. [< ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-discord/page/configuracion-en-discord-creacion-de-un-enlace-de-conexion) [SIGUIENTE >](https://pandorafms.com/guides/public/books/integracion-con-discord/page/configuracion-en-pandora-fms-creacion-de-una-accion-de-alerta) # Configuración en Pandora FMS: creación de una acción de alerta Las [acciones de alerta](https://pandorafms.com/manual/es/documentation/04_using/01_alerts) permiten definir *el cómo* lanzar el comando. Vaya al menú **Alerts** -> **Actions** -> **Create**. [![PFMS_Slack_integration_170.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-slack-integration-170.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-slack-integration-170.png) Seleccione en **Command** el comando de alerta creado en la página anterior, los campos se rellenarán automáticamente. Sin embargo [siempre podrá personalizar los iconos o mensajes](https://www.youtube.com/watch?v=qT8-AFgL0oQ&t=465s) para los eventos de disparado de alerta y recuperación de alerta (**Triggering** y **Recovery**, respectivamente), por ejemplo el color, etcétera. [![PFMS_Discord_integration_160.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-discord-integration-160.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-discord-integration-160.png) Para guardar haga clic en **Update**. Para aplicar esta acción bien sea a un [Módulo o Política](https://pandorafms.com/manual/es/documentation/05_big_environments/02_policy?s%5B%5D=pol%C3%ADticas), establezca una [plantilla de alerta](https://pandorafms.com/manual/es/documentation/04_using/01_alerts?s%5B%5D=alertas#plantilla_de_alerta) para tal fin. [< ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-discord/page/configuracion-en-pandora-fms-creacion-de-un-comando-de-alerta)