# Despliegue del agente para Linux

# Características del agente

Antes de iniciar cualquier proceso de instalación, actualización o desinstalación, es importante que conozca la estructura del agente para que prepare su infraestructura y permita su funcionamiento. A continuación se realizará una caracterización de sus propiedades:

<table border="1" id="bkmrk-conectividad-el-agen" style="border-collapse: collapse; width: 100%; height: 379.938px;"><colgroup><col style="width: 32.5488%;"></col><col style="width: 67.4512%;"></col></colgroup><tbody><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Conectividad**</td><td style="height: 80.1875px;">El agente requiere comunicarse con un servidor externo. Esta comunicación sucede solamente en una vía (agente -&gt; servidor) y lo hace por 2 puertos, uno TCP y uno UDP. Los clientes recibirán un correo indicando cuáles son estos puertos para que procedan a configurar sus Firewalls.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Seguridad en su ejecución**</td><td style="height: 63.3906px;">Los antivirus podrían impedir que el agente se ejecute, por ello será importante añadir a la lista de exclusión la carpeta donde se aloja y el MD5 y SHA-1 de su ejecutable. Además del antivirus, si su distribución es basada en Red Hat, el sistema SELinux podría bloquear el agente. Tome las medidas necesarias para que el agente no sea bloqueado de acuerdo a la distribución Linux que use.</td></tr><tr style="height: 114.375px;"><td style="height: 114.375px;">**Carpetas y archivos que se crean**</td><td style="height: 114.375px;">**/home/usuario/businessAnalytics** es la ruta donde se almacena todo el agente

<div><div>**/home/usuario/.local/share/gnome-shell/extensions/window-calls-extended** es la ruta donde se almacena la extensión de GNOME que permite el acceso a los datos de las ventanas.</div></div>**/home/usuario/businessAnalytics/config.ini** el archivo de configuración

**/home/usuario/businessAnalytics/agent.log** es el archivo de log

</td></tr><tr style="height: 32.5938px;"><td style="height: 32.5938px;">**Arranque**</td><td style="height: 32.5938px;">**/home/usuario/.autostart/enable-gnome-window-ext.desktop  solo funciona una vez y se encarga de habilitar la extensión de GNOME al reinicio del PC

**/home/usuario/.autostart/businessAnalytics.desktop** arranca el agente

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Espacio en disco duro**</td><td style="height: 29.7969px;">0.14 MB (144 Kb)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Memoria RAM que consume**</td><td style="height: 29.7969px;">Entre 8 MB y 25 MB de memoria RAM</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Compatibilidad con Linux**</td><td style="height: 29.7969px;">El agente es compatible con cualquier versión de Linux que tenga la interfaz gráfica GNOME y que use el administrador de ventanas Wayland. </td></tr></tbody></table>

Conociendo estas propiedades, puede proceder con el despliegue del agente.

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.</td></tr></tbody></table>

# Requisitos previos

Antes de ejecutar cualquier procedimiento en un sistema operativo Linux es importante tener en cuenta los siguientes requisitos previos:

Debe contar con la capacidad de realizar acciones administrativas en el sistema operativo Linux. El procedimiento de instalación del agente **NO debe ser ejecutado con usuario** **root**, mas bien, el usuario normal del sistema debe tener la capacidad de ejecutar comandos administrativos con el comando **sudo**. En caso de que el usuario normal no tenga permisos para usa **sudo**, se le debe habilitar temporalmente para instalar el agente. Una vez terminado el proceso de instalación se le pueden quitar los permisos.

Si su empresa tiene instalado un agente de despliegue masivo de software en el computador Linux, como lo puede ser System Center, Microsoft Intune o incluso el Directorio Activo, puede crear un procedimiento desde dichas consolas para instalar el agente antifraude ya que nuestro agente viene con un instalador único (**install.sh**).

Este agente tiene un sólo componente externo del cual depende su funcionamiento y es una extensión de GNOME. La interfaz gráfica de usuario en Linux requiere de la instalación de una extensión (disponible en la página de extensiones de GNOME) para permitir el acceso a los datos de una ventana. Nuestro agente necesita este acceso para extraer los datos semánticos. Todo el proceso de instalación de esta extensión es automático, el administrador no necesita instalar nada manualmente y todo lo gestiona el instalador **install.sh**.

Este agente es compatible con todas las versiones de Linux que usen GNOME y el administrador de ventanas Wayland. Entre las cuales se encuentran Ubuntu Linux desde la versión 24 y Fedora Linux desde la versión 39. Estas distribuciones (Ubuntu y Fedora) son las distribuciones de Linux más usadas en ambiente de escritorio en el mundo, tanto de forma corporativa como de forma personal.

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.</td></tr></tbody></table>

# Permisos de seguridad

Antes de iniciar la instalación, el usuario debe pertenecer al grupo **sudo**. Esto permitirá luego ejecutar el instalador desde el entorno del usuario.

[![LinuxGroups.png](https://library.nofraud.la/uploads/images/gallery/2026-06/scaled-1680-/8gj0ffGVj260yPtP-linuxgroups.png)](https://library.nofraud.la/uploads/images/gallery/2026-06/8gj0ffGVj260yPtP-linuxgroups.png)

Puede usar las herramientas de GNOME para modificar los grupos a los cuales pertenece un usuario pero también puede escribir el siguiente comando como root para lograrlo:

```bash
# usermod -aG sudo usuario
```

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.</td></tr></tbody></table>

# Video con todos los pasos

En vez de seguir los pasos documentados, también puede optar por visualizar este video.

<iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="allowfullscreen" frameborder="0" height="474" src="https://www.youtube.com/embed/C6Z_aRljIZE?si=L9fS7J3vIT8Xqjh0" style="border: 3px solid #EEE;" title="YouTube video player" width="843"></iframe>

El video contiene todos los pasos de la guía ejecutados de forma práctica y cada uno de los pasos está separado por capítulos.

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.</td></tr></tbody></table>

# Instalación del agente

Descargue el instalador del agente **businessAnalytics-Installer.zip** al equipo Linux. Lo puede colocar en la carpeta **Home** del usuario (/home/usuario) temporalmente. Una vez allí, ejecute estos comandos:

```bash
$ sudo apt install unzip
$ unzip businessAnalytics-Installer.zip
$ sudo ./install.sh
```

[![LinuxInstallCV.png](https://library.nofraud.la/uploads/images/gallery/2026-06/scaled-1680-/3PEHkxctaIBPmglf-linuxinstallcv.png)](https://library.nofraud.la/uploads/images/gallery/2026-06/3PEHkxctaIBPmglf-linuxinstallcv.png)

El instalador agregará el usuario al grupo input (para poder leer eventos de entrada), instalará la extensión de GNOME para acceder a los datos de las ventanas y creará las entradas necesarias para que el agente arranque siempre al iniciar la sesión en GNOME (autostart).

El agente empezará a funcionar en el **próximo reinicio**.

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.</td></tr></tbody></table>

# Verificación de la instalación

Para verificar la instalación se puede ejecutar la aplicación **Resources** accesible desde el menú principal de GNOME.

[![LinuxVerifyCV.png](https://library.nofraud.la/uploads/images/gallery/2026-06/scaled-1680-/xIQRPN0t8TOIvW4p-linuxverifycv.png)](https://library.nofraud.la/uploads/images/gallery/2026-06/xIQRPN0t8TOIvW4p-linuxverifycv.png)

En esta aplicación puede navegar en la pestaña **Processes** y buscar el programa **businessAnalytics**. Si el programa se encuentra, significa que se está ejecutando correctamente.

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.

</td></tr></tbody></table>

# Desinstalación del agente

Para desinstalar el agente debe abrir la aplicación **Terminal** y ejecutar el siguiente comando:

```bash
$ cd ; cd businessAnalytics
$ sudo ./uninstall.sh
```

Luego se le preguntará el password para poder usar sudo y la desinatalación se ejecutará.

[![LinuxUninstallCV.png](https://library.nofraud.la/uploads/images/gallery/2026-06/scaled-1680-/SNnQET2b6oWjOVkA-linuxuninstallcv.png)](https://library.nofraud.la/uploads/images/gallery/2026-06/SNnQET2b6oWjOVkA-linuxuninstallcv.png)

El agente dejará de funcionar de forma inmediata.

<table border="1" class="align-left" id="bkmrk-the-fraud-explorer-e" style="border-collapse: collapse; width: 100%; height: 68.9922px; background-color: rgb(242, 242, 242); border: 1px solid rgb(242, 242, 242);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 68.9922px;"><td style="border-color: rgb(242, 242, 242); height: 68.9922px;">**The Fraud Explorer** es un software que junto con **FraudGPT** detecta el fraude y la corrupción en las organizaciones. Este software está siendo desarrollado por [NOFRAUD.la](https://www.nofraud.la/). Este contenido es privado y únicamente está disponible para clientes de NOFRAUD. Está prohibida su publicación en fuentes abiertas o disponibles al público.</td></tr></tbody></table>