Acronis

• Introducción
• Matriz de compatibilidad
• Parámetros
• Prerrequisitos
• Ejecucion manual
• Configuracion en PandoraFMS
• Agentes y módulos generados por el plugin

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

Sistemas donde se ha probado	Rocky 9
Sistemas donde debería funcionar	Cualquier sistema linux soportado por PandoraFMS

Parámetros

Parámetro	Descripción
'-c', '--client'	Client ID de Acronis
'-p', '--password'	Secreto del cliente Acronis
'-u', '--url'	URL de la API de acronis : https://es01-cloud.acronis.com
--interval	Intervalo de creacion de los agentes.
--transfer_mode	Modo de transferencia. Local o tentacle son las opciones disponibles (opcional)
--tentacle_port	Puerto de tentacle.Por defecto 41121 (opcional)
--tentacle_address	Ip del servidor tentacle al que mandar los datos (opcional)
--agent_name	Para ponerle un nombre al agente que contendrá los módulos de las custom querys, por defecto : "Acronis" (opcional).
--prefix	Sirve para especificar un prefijo a los módulos y agente.(opcional)
--agent_group	Grupo de destino de Pandora FMS (opcional)
--data_dir	Directorio de datos de Pandora FMS. Por defecto es /var/spool/pandora/data_in/ (opcional)

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".

Daremos a seleccionar archivo.

Seleccionaremos el fichero pspz2 que contiene el plugin.

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

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

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).

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

Una vez configurado le daremos a "update"

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.