1 API Externa de Pandora FMS

1.1 Seguridad

1.2 Extensión de nuevas llamadas en el API

1.3 Llamadas al API

1.3.1 RETORNO DE INFORMACIÓN

1.3.2 GET

1.3.3 SET

1.3.3.1 set new_agent

1.3.3.2 set update_agent

1.3.3.3 set update_agent_field

Esta llamada actualiza el o los campos de uno o varios Agentes (esto último si utiliza alias y existen varios que coincidan con ello.

Sintaxis de la llamada:

• op=set (obligatorio)
• op2=update_agent_field (obligatorio)
• id=<id_agente> o <alias> (obligatorio), dependiendo <alias> del parámetro id2.
• id2= <0> si es <id_agente> (opcional), <1> si es <alias> (obligatorio).
• other=<parámetros serializados> (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
  • <alias_agente> (opcional)
  • <direccion> (opcional)
  • <id_parent> (opcional)
  • <id_grupo> (opcional)
  • <cascade_protection> (opcional)
  • <cascade_protection_module> (opcional)
  • <intervalo> (opcional)
  • <id_os> (opcional)
  • <server_name> (opcional)
  • <custom_id> (opcional)
  • <modo> (opcional)
  • <disabled> (opcional)
  • <comentarios> (opcional)

1.3.3.3.1 Ejemplos

En caso de utilizar el identificador del Agente:

http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_agent_field&id=1&other=id_os,1|alias,pandora|direccion,192.168.10.16|id_parent,1cascade_protection,1|cascade_protection_module,1|intervalo,5||modo|3|&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora

En caso de utilizar alias, modifica todos los agentes que contengan ese alias:

http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_agent_field&id=pandora&id2=1&other=id_os,1|alias,pandora|direccion,192.168.10.16|id_parent,1cascade_protection,1|cascade_protection_module,1|intervalo,5||modo|3|&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora

1.3.3.133 set create_user_profile_info

Crea un nuevo perfil de usuario.

Sintaxis de la llamada:

• op=set (obligatorio)
• op2=create_user_profile_info (obligatorio)
• return_type=csv|json (obligatorio)
• other=<parámetros serializados> Por este orden

• <nombre> (obligatorio)
• <bits de acceso>: 1 si se quiere activar el bit y 0 en caso contrario. No son obligatorios pero si no se especifica ningún valor se marcará el bit como no activo. Por este orden: 

AR|AW|AD|LW|LM|UM|DM|ER|EW|EM|RR|RW|RM|MR|MW|MM|VR|VW|VM|PM

1.3.3.134 set update_user_profile_info

Actualiza nuevo perfil de usuario existente.

Actualiza nuevo perfil de usuario existente.

Sintaxis de la llamada:

• op=set (obligatorio)
• op2=update_user_profile_info (obligatorio)
• other=<parámetros serializados> (todos opcionales) Por este orden

• <nombre>
• <bits de acceso>: 1 si se quiere activar el bit y 0 si se quiere deshabilitar. Si no se especifica ningún valor, no cambiará. Por este orden:

AR|AW|AD|LW|LM|UM|DM|ER|EW|EM|RR|RW|RM|MR|MW|MM|VR|VW|VM|PM

1.4 Ejemplos

1.5 Futuro del API.php