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