# Acronis

# Introducción

El script consulta el estado de las copias de seguridad de **Acronis Cloud** mediante su API y genera módulos de **Pandora FMS** con esa información, exportándolos en formato XML para que el agente de Pandora los procese automáticamente.

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 84px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde se ha probado**</td><td style="width: 50%; height: 28px;">Rocky 9

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde debería funcionar**</td><td style="width: 50%; height: 28px;">Cualquier sistema linux soportado por PandoraFMS

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

# Parámetros

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 408.284px;"><tbody><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">**Parámetro**</td><td style="width: 50%; height: 29.7167px;">**Descripción**</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">'-c', '--client'</td><td style="width: 50%; height: 29.7167px;">Client ID de Acronis</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">'-p', '--password'</td><td style="width: 50%; height: 29.7167px;">Secreto del cliente Acronis</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">'-u', '--url'</td><td style="width: 50%; height: 29.7167px;">URL de la API de acronis : https://es01-cloud.acronis.com</td></tr><tr style="height: 31px;"><td style="width: 50%; height: 31px;">--interval</td><td style="width: 50%; height: 31px;">Intervalo de creacion de los agentes.</td></tr><tr><td style="width: 50%;">--transfer\_mode</td><td style="width: 50%;">Modo de transferencia. Local o tentacle son las opciones disponibles (opcional)</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">--tentacle\_port</td><td style="width: 50%; height: 29.7167px;">Puerto de tentacle.Por defecto 41121 (opcional)</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">--tentacle\_address</td><td style="width: 50%; height: 29.7167px;">Ip del servidor tentacle al que mandar los datos (opcional)</td></tr><tr style="height: 46.5167px;"><td style="width: 50%; height: 46.5167px;">--agent\_name</td><td style="width: 50%; height: 46.5167px;">Para ponerle un nombre al agente que contendrá los módulos de las custom querys, por defecto : "Acronis" (opcional).</td></tr><tr style="height: 46.5167px;"><td style="width: 50%; height: 46.5167px;">--prefix</td><td style="width: 50%; height: 46.5167px;">Sirve para especificar un prefijo a los módulos y agente.(opcional)</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">--agent\_group</td><td style="width: 50%; height: 29.7167px;">Grupo de destino de Pandora FMS (opcional)</td></tr><tr style="height: 46.5167px;"><td style="width: 50%; height: 46.5167px;">--data\_dir</td><td style="width: 50%; height: 46.5167px;">Directorio de datos de Pandora FMS. **Por defecto** es /var/spool/pandora/data\_in/ (opcional)</td></tr></tbody></table>

# Prerrequisitos

Permisos necesarios para usar la API de Acronis con el plugin  
  
**El cliente (application) usado por el plugin debe tener los siguientes permisos:**

*- resource\_management:read*  
*- policy\_management:read*  
*- backup\_management:read*

Para obtener estos permisos, los pasos son los siguientes:

**1. Inicia sesión en el portal de administración de Acronis:**  
 https://cloud.acronis.com/

**2. Ve a:**  
 Configuración → Aplicaciones (Applications) → Registrar aplicación

**3. Crea una nueva aplicación:**  
\- Tipo: Confidential  
\- Nombre: PandoraFMS-Acronis (por ejemplo)  
\- Redirigir URI: dejar vacío

**4. Copia el `client\_id` y `client\_secret` generados.**

**5. Asigna permisos a la aplicación:**  
\- En la sección \*\*Permissions / Scopes\*\* marca:  
 ```  
 resource\_management:read  
 policy\_management:read  
 backup\_management:read  
 ```

**6. Guarda los cambios.**

**Probar el acceso**  
Puedes verificar que la autenticación funciona con

```
curl -X POST https://<tu-dominio-acronis>/api/2/idp/token \
  -d "grant_type=client_credentials" \
  -d "client_id=<CLIENT_ID>" \
  -d "client_secret=<CLIENT_SECRET>"
```

# Ejecucion manual

El formato de ejecucion del plugin es el siguiente :

```
./pandora_acronis -c < ID de cliente de Acronis > -p < Secreto de cliente de Acronis > -u < URL base de la API de Acronis > 
[--data_dir < Ruta del directorio data_in de Pandora. Por defecto: /var/spool/pandora/data_in/ >] 
[--prefix < Prefijo para los agentes generados. Por defecto: vacío >] 
[--agent_name < Nombre del agente. Por defecto: Acronis >] 
[--agent_group < Grupo del agente. Opcional >] 
[--interval < Intervalo de ejecución del agente en segundos. Por defecto: 300 >] 
[--transfer_mode < Modo de transferencia: tentacle o local. Por defecto: tentacle >] 
[--tentacle_ip < IP del servidor Tentacle. Por defecto: 127.0.0.1 >] 
[--tentacle_port < Puerto del servidor Tentacle. Por defecto: 41121 >] 
[-v | --verbose < Habilita salida detallada >]
```

Por ejemplo :

```
./pandora_acronis \
  -c 1234567890abcdef1234567890abcdef \
  -p s3cr3tCl13ntKey987654321 \
  -u https://eu-cloud.acronis.com \
  --agent_group "Acronis_Backups" \
  --prefix "ACR_" \
  --interval 300 \
  --transfer_mode tentacle \
  --tentacle_ip 127.0.0.1 \
  --tentacle_port 41121
```

# Configuracion en PandoraFMS

**Instalación desde consola**

Para el registro del plugin, desde la consola, se debe ir al apartado "registrar plugin".

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

Daremos a seleccionar archivo.

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/Rnvimagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/Rnvimagen.png)

Seleccionaremos el fichero pspz2 que contiene el plugin.

Se nos mostrará un mensaje de que se ha instalado correctamente.

[![Captura desde 2025-11-04 18-33-41.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-33-41.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-33-41.png)

Una vez registrado el plugin, lo veremos en el apartado plugins.

[![servers_plugins.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/IAxservers-plugins.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/IAxservers-plugins.png)

En el apartado parámetros saldrán todos los que contiene el plugin y se podrá configurar, los parametros obligatorios son el client id, secret y url ( -c, -p, y -u).

[![Captura desde 2025-11-04 18-36-36.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-36-36.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-36-36.png)

Abajo se le podrá asignar un valor a cada macro.

[![Captura desde 2025-11-04 18-45-59.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-45-59.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-45-59.png)  
  
Una vez configurado le daremos a "update"

[![Captura desde 2025-11-04 18-46-53.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-46-53.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-46-53.png)

# Agentes y módulos generados por el plugin

El plugin creará un agente. El nombre de este agente es "Acronis" por defecto y es configurable con el parámetro "--agent\_name". Al agente se le puede añadir prefijo con el parámetro "--prefix".

El plugin creará un módulo de tipo "generic\_proc" por cada máquina con estado de su backup e información de este estado en la descripción.