# Google Drive

# Introducción

**Ver**. 26-03-2024

Este plugin tiene como finalidad monitorizar el espacio y la fecha del último cambio de un archivo de Google Drive.

**Tipo**: Plug-in server

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha-1" style="width: 74.8148%;"><tbody><tr><td style="width: 56.7204%;">**Sistemas donde se ha probado**</td><td style="width: 43.2796%;">Rocky linux, Fedora 34</td></tr><tr><td style="width: 56.7204%;">**Sistemas donde funciona**</td><td style="width: 43.2796%;">Cualquier sistema linux</td></tr></tbody></table>

# Pre requisitos

- Google Drive API habilitada
- Archivo JSON con las credenciales

### Habilitar la API de Google Drive:

1. Ve a la [Consola de Desarrolladores de Google](https://console.developers.google.com/).
2. Crea un nuevo proyecto o selecciona uno existente.
3. En el panel izquierdo, haz clic en "Biblioteca".
4. Busca "Google Drive API" en la lista de APIs disponibles.
5. Haz clic en "Google Drive API".
6. Haz clic en "habilitar" para habilitar la API para tu proyecto.

### Crea credenciales de API:  


1. **Configurar la pantalla de consentimiento OAuth**:
    
    
    - En el menú de navegación, ve a `APIs & Services > OAuth consent screen`.
    - Configura la pantalla de consentimiento, asegurándote de agregar el `scope` necesario para Google Drive.
2. **Crear credenciales**:
    
    
    - Ve a `APIs & Services > Credentials`.
    - Haz clic en "Create Credentials" y selecciona "OAuth 2.0 Client IDs".
    - Configura el tipo de aplicación ( "Desktop app") y descarga el archivo JSON de credenciales.

### Generar token para el plugin:

1. Ejecutar el plugin manualmente con los parámetros obligatorios especificados en apartado "parámetros" (ejemplo en apartado "ejecucion manual", en un entorno con GUI, para generar un fichero token.json.
2. Se nos abrirá el navegador y nos solicitará iniciar sesión con una cuenta de google.
3. El token.json generado, deberá estar ubicado en el mismo directorio en el que se configura el plugin PandoraFMS. Junto al creds.json.

<p class="callout warning">Es necesario la ejecución en un entorno con GUI para autenticar por primera vez y generar un token. </p>

# Parámetros

**Parámetros conexión google**

<table border="1" id="bkmrk---url-url-de-conexi%C3%B3" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--creds\_json**</td><td style="height: 29.7969px;">Fichero json con las credenciales de google</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--creds\_base64**</td><td style="height: 29.7969px;">Base 64 del fichero json con las credenciales de google</td></tr><tr><td>**--port**</td><td>Puerto. Default : 8080</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--file\_name**</td><td style="height: 29.7969px;">Nombre del archivo, del que se pretende monitorizar la fecha de su último cambio. Se requiere ser propietario o tener permisos de edición.</td></tr><tr><td>**--log\_file**</td><td>Ruta del fichero de logs</td></tr></tbody></table>

**Parámetros configuración Pandora**

<table border="1" id="bkmrk---agent_name-nombre-" style="width: 100.247%; height: 327.766px;"><colgroup><col style="width: 34.0551%;"></col><col style="width: 65.9449%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--agent\_prefix**  
</td><td style="height: 29.7969px;">Prefijo para todos los agentes creados por el plugin  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--module\_prefix**</td><td style="height: 29.7969px;">Prefijo para todos los módulos creados por el plugin</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--interval**</td><td style="height: 29.7969px;">Intervalo de monitorización del agente</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--temporal**</td><td style="height: 29.7969px;">Directorio temporal de PandoraFMS</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--data\_dir**  
</td><td style="height: 29.7969px;">Directorio de datos de PandoraFMS</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--transfer\_mode**  
</td><td style="height: 29.7969px;">Modo de transferencia de datos, local o tentacle</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--tentacle\_client**  
</td><td style="height: 29.7969px;">Ruta del cliente de tentacle, por defecto "tentacle\_client"</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--tentacle\_opts**  
</td><td style="height: 29.7969px;">Opciones adicionales de tentacle  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--tentacle\_port**  
</td><td style="height: 29.7969px;">Puerto de tentacle  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**--tentacle\_address**  
</td><td style="height: 29.7969px;">IP de tentacle</td></tr></tbody></table>

# Ejecución manual

El formato de ejecución del plugin es el siguiente :

```
./pandora_googledrive --creds_json/creds_base64 <file credentials> \
[--file_name <file_name>] \
[--module_prefix <module_prefix>] \
[--agent_prefix <agent_prefix>] \
[--group <group>] \
[--interval <interval>] \
[--temporal <temporal>] \
[--data_dir <data_dir>] \
[--transfer_mode <transfer_mode>] \
[--tentacle_client <tentacle_client>] \
[--tentacle_opts <tentacle_opts>] \
[--tentacle_port <tentacle_port>] \
[--tentacle_address <tentacle_address>] \
[--log_file <log_file>]
```

Ejemplo:

```
./pandora_google_drive --creds_json "creds.json" --tentacle_address 174.42.42.123 --file_name "sistema_de_alertas.mp4"
```

# Configuración en PandoraFMS

Para configurar el plugin en PandoraFMS, se deben seguir los siguientes pasos :

**1. Subir el plugin a PandoraFMS, por ejemplo en la siguiente ruta:**

```
/usr/share/pandora_server/util/plugin
```

**2. Dirigirse al apartado plugins y crear uno nuevo:**

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/scaled-1680-/VNOimagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/VNOimagen.png)

 **3. Se le añade nombre, descripción y timeout:**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/scaled-1680-/PxRimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/PxRimage.png)

**4. Se añade la ruta del plugin en el comando y los parámetros necesarios para la ejecución de este.**

<p class="callout info">Para cada parámetro se debe configurar una macro, siendo la sintaxis de esta macro la siguiente : \_fieldx\_, siendo x el numero posicional del parámetro.</p>

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/scaled-1680-/kNgimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/kNgimage.png)

**5. Se configuran las macros anteriores, añadiendo en cada una el valor del parámetro:**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/scaled-1680-/Jy6image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/Jy6image.png)

**6.** **Una vez configurado se debe crear un módulo en un agente que ejecute el plugin. En el menu de módulos de un agente creamos un módulo de tipo plugin nuevo:**

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/scaled-1680-/503imagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/503imagen.png)

**7. En el menú de configuración del módulo, le ponemos un nombre, seleccionamos el plugin antes configurado y se le debe dar a "crear".**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/scaled-1680-/7RLimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/7RLimage.png)

**8. Se creara el agente con los módulos o los módulos en el agente seleccionado en la siguiente ejecución del plugin :**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/scaled-1680-/njBimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-03/njBimage.png)

# Agentes y módulos generados por el plugin

El plugin creará un agente llamado &lt;Prefijo&gt;Google Drive, con los siguientes módulos:

<table border="1" id="bkmrk-%3C-prefijo-%3E-%3C-google" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>&lt; Prefijo &gt; &lt; Google Drive Used &gt;</td></tr><tr><td>&lt; Prefijo &gt; &lt; Nombre archivo &gt;</td></tr></tbody></table>