pandorafms/pandora_console/include/lib/Group.php

755 lines
22 KiB
PHP

<?php
/**
* Group entity class.
*
* @category Class
* @package Pandora FMS
* @subpackage OpenSource
* @version 1.0.0
* @license See below
*
* ______ ___ _______ _______ ________
* | __ \.-----.--.--.--| |.-----.----.-----. | ___| | | __|
* | __/| _ | | _ || _ | _| _ | | ___| |__ |
* |___| |___._|__|__|_____||_____|__| |___._| |___| |__|_|__|_______|
*
* ============================================================================
* Copyright (c) 2005-2023 Pandora FMS
* Please see https://pandorafms.com/community/ for full contribution list
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation for version 2.
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* ============================================================================
*/
// Begin.
namespace PandoraFMS;
global $config;
require_once $config['homedir'].'/include/functions_groups.php';
/**
* PandoraFMS Group entity.
*/
class Group extends Entity
{
/**
* List of available ajax methods.
*
* @var array
*/
private static $ajaxMethods = [
'getGroupsForSelect',
'distributionBySoGraph',
'groupEventsByAgent',
'loadInfoAgent',
'getAgentsByGroup',
];
/**
* Instances a new object using array definition.
*
* @param array $data Fields data.
* @param string $class_str Class name.
*
* @return object With current definition.
*/
public static function build(array $data=[], string $class_str=__CLASS__)
{
return parent::build($data, $class_str);
}
/**
* Builds a PandoraFMS\Group object from a group id.
*
* @param integer $id_group Group Id.
* @param boolean $recursive Create parents as objects.
*/
public function __construct(?int $id_group=null, bool $recursive=false)
{
if ($id_group === 0) {
parent::__construct('tgrupo');
$this->fields['id'] = 0;
$this->fields['nombre'] = 'All';
} else if (is_numeric($id_group) === true) {
parent::__construct('tgrupo', ['id_grupo' => $id_group]);
if ($recursive === true) {
// Customize certain fields.
$this->fields['parent'] = new Group($this->fields['parent']);
}
} else {
// Empty skel.
parent::__construct('tgrupo');
}
}
/**
* Return an array of ids with all children
*
* @param boolean $ids_only Return an array of id_groups or
* entire rows.
* @param boolean $ignorePropagationState Search all children ignoring or
* depending on propagate_acl flag.
*
* @return array With all children.
*/
public function getChildren(
bool $ids_only=false,
bool $ignorePropagationState=false
):array {
$available_groups = \groups_get_children(
$this->id_grupo(),
$ignorePropagationState
);
if (is_array($available_groups) === false) {
return [];
}
if ($ids_only === true) {
return array_keys($available_groups);
}
return $available_groups;
}
/**
* Alias of 'nombre'.
*
* @param string|null $name Name of group.
*
* @return string|void Name assigned or void if set operation.
*/
public function name(?string $name=null)
{
if ($name === null) {
return $this->nombre();
}
return $this->nombre($name);
}
/**
* Retrieves a list of groups fitered.
*
* @param array $filter Filters to be applied.
*
* @return array With all results or false if error.
* @throws Exception On error.
*/
private static function search(array $filter):array
{
// Default values.
if (empty($filter['id_user']) === true) {
// By default query current user groups.
$filter['id_user'] = false;
} else if ((bool) \users_is_admin() === false) {
// Override user queried if user is not an admin.
$filter['id_user'] = false;
}
if (empty($filter['id_user']) === true) {
$filter['id_user'] = false;
}
if (empty($filter['keys_field']) === true) {
$filter['keys_field'] = 'id_grupo';
}
if (isset($filter['returnAllColumns']) === false) {
$filter['returnAllColumns'] = true;
}
$groups = \users_get_groups(
$filter['id_user'],
$filter['privilege'],
$filter['returnAllGroup'],
// Return all columns.
$filter['returnAllColumns'],
// Field id_groups is not being used anymore.
null,
$filter['keys_field'],
// Cache.
true,
// Search term.
$filter['search']
);
if (is_array($groups) === false) {
return [];
}
return $groups;
}
/**
* Returns an hierarchical ordered array.
*
* @param array $groups All groups available.
*
* @return array Groups ordered.
*/
private static function prepareGroups(array $groups):array
{
$return = [];
$tree_groups = \groups_get_groups_tree_recursive($groups);
foreach ($tree_groups as $k => $v) {
$return[] = [
'id' => $k,
'text' => \io_safe_output(
\ui_print_truncate_text(
$v['nombre'],
GENERIC_SIZE_TEXT,
false,
true,
false
)
),
'level' => $v['deep'],
];
}
$unassigned = [];
$processed = array_keys($tree_groups);
foreach ($groups as $k => $v) {
if (in_array($k, $processed) === true) {
continue;
}
$unassigned[] = [
'id' => $k,
'text' => \io_safe_output(
\ui_print_truncate_text(
$v,
GENERIC_SIZE_TEXT,
false,
true,
false
)
),
'level' => 0,
];
}
return array_merge($unassigned, $return);
}
/**
* Saves current group definition to database.
*
* @return mixed Affected rows of false in case of error.
* @throws \Exception On error.
*/
public function save()
{
if (\is_management_allowed() !== true) {
$msg = 'cannot be modified in a centralized management environment';
throw new \Exception(
get_class($this).' error, '.$msg
);
}
$updates = $this->fields;
if (is_numeric($updates['parent']) === false) {
$updates['parent'] = $this->parent()->id_grupo();
}
// Clean null fields.
foreach ($updates as $k => $v) {
if ($v === null) {
unset($updates[$k]);
}
}
if (isset($updates['propagate']) === false) {
$updates['propagate'] = 0;
}
if (isset($updates['disabled']) === false) {
$updates['disabled'] = 0;
}
if ($this->fields['id_grupo'] > 0) {
return \db_process_sql_update(
'tgrupo',
$updates,
['id_grupo' => $this->fields['id_grupo']]
);
} else {
// Create new group.
$this->fields['id_grupo'] = \db_process_sql_insert(
'\tgrupo',
$updates
);
if ($this->fields['id_grupo'] === false) {
global $config;
$msg = __(
'Failed to save group %s',
$config['dbconnection']->error
);
throw new \Exception(
get_class($this).' error, '.$msg
);
} else {
return true;
}
}
return false;
}
/**
* Delete this group.
*
* @return void
*/
public function delete()
{
// Propagate parents.
\db_process_sql_update(
'tgrupo',
['parent' => $this->parent()->id_grupo()],
['parent' => $this->id_grupo()]
);
// Remove stats.
\db_process_sql_delete(
'tgroup_stat',
['id_group' => $this->id_grupo()]
);
// Remove group.
\db_process_sql_delete(
'tgrupo',
['id_grupo' => $this->id_grupo()]
);
unset($this->fields['id_grupo']);
}
/**
* Return error message to target.
*
* @param string $msg Error message.
*
* @return void
*/
public static function error(string $msg)
{
echo json_encode(['error' => $msg]);
}
/**
* Verifies target method is allowed to be called using AJAX call.
*
* @param string $method Method to be invoked via AJAX.
*
* @return boolean Available (true), or not (false).
*/
public static function ajaxMethod(string $method):bool
{
return in_array($method, self::$ajaxMethods) === true;
}
/**
* This method is being invoked by select2 to improve performance while
* installation has a lot of groups (more than 5k).
*
* Security applied in controller include/ajax/group.php.
*
* @return void
* @throws \Exception On error.
*/
public static function getGroupsForSelect()
{
$id_user = get_parameter('id_user', false);
$privilege = get_parameter('privilege', 'AR');
$returnAllGroup = get_parameter('returnAllGroup', false);
$id_group = get_parameter('id_group', false);
$keys_field = get_parameter('keys_field', 'id_grupo');
$search = get_parameter('search', '');
$step = get_parameter('step', 1);
$limit = get_parameter('limit', false);
$not_condition = get_parameter('not_condition', false);
$exclusions = get_parameter('exclusions', '[]');
$inclusions = get_parameter('inclusions', '[]');
if (empty($id_user) === true) {
$id_user = false;
}
$groups = self::search(
[
'id_user' => $id_user,
'privilege' => $privilege,
'returnAllGroup' => $returnAllGroup,
'returnAllColumns' => true,
'id_group' => $id_group,
'keys_field' => $keys_field,
'search' => $search,
]
);
$exclusions = json_decode(\io_safe_output($exclusions), true);
if (empty($exclusions) === false) {
foreach ($exclusions as $ex) {
unset($groups[$ex]);
}
}
$inclusions = json_decode(\io_safe_output($inclusions), true);
if (empty($inclusions) === false) {
foreach ($inclusions as $k => $g) {
if (empty($groups[$k]) === true) {
if (is_numeric($g) === true) {
$groups[$k] = \groups_get_name($k);
}
if (empty($groups[$k]) === true) {
// Group does not exist, direct value assigned.
$groups[$k] = $g;
}
}
}
}
$return = self::prepareGroups($groups);
// When not_condition is select firts option text change All to None.
if ($not_condition === 'true') {
$return[0]['text'] = 'None';
}
if (is_array($return) === false) {
return;
}
// Use global block size configuration.
global $config;
$limit = $config['block_size'];
$offset = (($step - 1) * $limit);
// Pagination over effective groups retrieved.
// Calculation is faster than transference.
$count = count($return);
if (is_numeric($offset) === true && $offset >= 0) {
if (is_numeric($limit) === true && $limit > 0) {
$return = array_splice($return, $offset, $limit);
}
}
if ($step > 2) {
$processed = (($step - 2) * $limit);
} else {
$processed = 0;
}
$current_ammount = (count($return) + $processed);
echo json_encode(
[
'results' => $return,
'pagination' => [
'more' => $current_ammount < $count,
],
]
);
}
/**
* Draw a graph distribution so by group.
*
* @return void
*/
public static function distributionBySoGraph()
{
global $config;
$id_group = get_parameter('id_group', '');
include_once $config['homedir'].'/include/functions_graph.php';
$out = '<div style="flex: 0 0 300px; width:99%; height:100%;">';
$out .= graph_so_by_group($id_group, 300, 200, false, false);
$out .= '<div>';
echo $out;
return;
}
/**
* Draw a graph events agent by group.
*
* @return void
*/
public static function groupEventsByAgent()
{
global $config;
$id_group = get_parameter('id_group', '');
include_once $config['homedir'].'/include/functions_graph.php';
$out = '<div style="flex: 0 0 300px; width:99%; height:100%;">';
$out .= graph_events_agent_by_group($id_group, 300, 200, false, true, true);
$out .= '<div>';
echo $out;
return;
}
/**
* Draw in modal a agent info
*
* @return void
*/
public static function loadInfoAgent()
{
$extradata = get_parameter('extradata', '');
echo '<div class="info-agent">';
if (empty($extradata) === false) {
$extradata = json_decode(io_safe_output($extradata), true);
$agent = agents_get_agent($extradata['idAgent']);
if (is_array($agent)) {
$status_img = agents_tree_view_status_img(
$agent['critical_count'],
$agent['warning_count'],
$agent['unknown_count'],
$agent['total_count'],
$agent['notinit_count']
);
$table = new \stdClass();
$table->class = 'table_modal_alternate';
$table->data = [
[
__('Id'),
$agent['id_agente'],
],
[
__('Agent name'),
'<a href="index.php?sec=gagente&sec2=godmode/agentes/configurar_agente&tab=main&id_agente='.$agent['id_agente'].'"><b>'.$agent['nombre'].'</b></a>',
],
[
__('Alias'),
$agent['alias'],
],
[
__('Ip Address'),
$agent['direccion'],
],
[
__('Status'),
$status_img,
],
[
__('Group'),
groups_get_name($agent['id_grupo']),
],
[
__('Interval'),
$agent['intervalo'],
],
[
__('Operative system'),
get_os_name($agent['id_os']),
],
[
__('Server name'),
$agent['server_name'],
],
[
__('Description'),
$agent['comentarios'],
],
];
html_print_table($table);
}
}
echo '</div>';
}
/**
* Get agents by group for datatable.
*
* @return void
*/
public static function getAgentsByGroup()
{
global $config;
$data = [];
$id_group = get_parameter('id_group', '');
$id_groups = [$id_group];
$groups = groups_get_children($id_group);
if (count($groups) > 0) {
$id_groups = [];
foreach ($groups as $key => $value) {
$id_groups[] = $value['id_grupo'];
}
}
$start = get_parameter('start', 0);
$length = get_parameter('length', $config['block_size']);
$orderDatatable = get_datatable_order(true);
$pagination = '';
$order = '';
try {
ob_start();
if (isset($orderDatatable)) {
switch ($orderDatatable['field']) {
case 'alerts':
$orderDatatable['field'] = 'fired_count';
break;
case 'status':
$orderDatatable['field'] = 'total_count';
default:
$orderDatatable['field'] = $orderDatatable['field'];
break;
}
$order = sprintf(
' ORDER BY %s %s',
$orderDatatable['field'],
$orderDatatable['direction']
);
}
if (isset($length) && $length > 0
&& isset($start) && $start >= 0
) {
$pagination = sprintf(
' LIMIT %d OFFSET %d ',
$length,
$start
);
}
$sql = sprintf(
'SELECT id_agente,
alias,
critical_count,
warning_count,
unknown_count,
total_count,
notinit_count,
ultimo_contacto_remoto,
fired_count
FROM tagente t
LEFT JOIN tagent_secondary_group g ON g.id_agent = t.id_agente
WHERE disabled = 0 AND
total_count <> notinit_count AND
(id_grupo IN (%s) OR id_group IN (%s))
%s %s',
implode(',', $id_groups),
implode(',', $id_groups),
$order,
$pagination
);
$data = db_get_all_rows_sql($sql);
$sql = sprintf(
'SELECT
id_agente,
alias,
critical_count,
warning_count,
unknown_count,
total_count,
notinit_count,
ultimo_contacto_remoto,
fired_count
FROM tagente t
LEFT JOIN tagent_secondary_group g ON g.id_agent = t.id_agente
WHERE disabled = 0 AND
total_count <> notinit_count AND
(id_grupo IN (%s) OR id_group IN (%s))
%s',
implode(',', $id_groups),
implode(',', $id_groups),
$order,
);
$count_agents = db_get_num_rows($sql);
foreach ($data as $key => $agent) {
$status_img = agents_tree_view_status_img(
$agent['critical_count'],
$agent['warning_count'],
$agent['unknown_count'],
$agent['total_count'],
$agent['notinit_count']
);
$data[$key]['alias'] = '<a href="index.php?sec=estado&sec2=operation/agentes/ver_agente&id_agente='.$agent['id_agente'].'"><b>'.$agent['alias'].'</b></a>';
$data[$key]['status'] = $status_img;
$data[$key]['alerts'] = agents_tree_view_alert_img($agent['fired_count']);
}
if (empty($data) === true) {
$total = 0;
$data = [];
} else {
$total = $count_agents;
}
echo json_encode(
[
'data' => $data,
'recordsTotal' => $total,
'recordsFiltered' => $total,
]
);
// Capture output.
$response = ob_get_clean();
} catch (\Exception $e) {
echo json_encode(['error' => $e->getMessage()]);
exit;
}
json_decode($response);
if (json_last_error() === JSON_ERROR_NONE) {
echo $response;
} else {
echo json_encode(
[
'success' => false,
'error' => $response,
]
);
}
exit;
}
}