Zabbix

<?php declare(strict_types = 0);

/*

** Copyright (C) 2001-2025 Zabbix SIA

**

** This program is free software: you can redistribute it and/or modify it under the terms of

** the GNU Affero General Public License as published by the Free Software Foundation, version 3.

**

** 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 Affero General Public License for more details.

**

** You should have received a copy of the GNU Affero General Public License along with this program.

** If not, see <https://www.gnu.org/licenses/>.

**/

​

​

/**

 * Connector API implementation.

 */

class CConnector extends CApiService {

​

    public const ACCESS_RULES = [

        'get' =>    ['min_user_type' => USER_TYPE_SUPER_ADMIN],

        'create' => ['min_user_type' => USER_TYPE_SUPER_ADMIN],

        'update' => ['min_user_type' => USER_TYPE_SUPER_ADMIN],

        'delete' => ['min_user_type' => USER_TYPE_SUPER_ADMIN]

    ];

​

    protected $tableName = 'connector';

    protected $tableAlias = 'c';

    protected $sortColumns = ['connectorid', 'name', 'data_type', 'status'];

​

    private array $output_fields = ['connectorid', 'name', 'protocol', 'data_type', 'url', 'item_value_type',

        'authtype', 'username', 'password', 'token', 'max_records', 'max_senders', 'max_attempts', 'attempt_interval',

        'timeout', 'http_proxy', 'verify_peer', 'verify_host', 'ssl_cert_file', 'ssl_key_file', 'ssl_key_password',

        'description', 'status', 'tags_evaltype'

    ];

​

    /**

     * @param array $options

     *

     * @throws APIException

     *

     * @return array|string

     */

    public function get(array $options = []) {

        if (self::$userData['type'] != USER_TYPE_SUPER_ADMIN) {

            self::exception(ZBX_API_ERROR_PERMISSIONS,

                _s('No permissions to call "%1$s.%2$s".', 'connector', __FUNCTION__)

            );

        }

​

        $api_input_rules = ['type' => API_OBJECT, 'fields' => [

            // filter

            'connectorids' =>               ['type' => API_IDS, 'flags' => API_ALLOW_NULL | API_NORMALIZE, 'default' => null],

            'filter' =>                     ['type' => API_FILTER, 'flags' => API_ALLOW_NULL, 'default' => null, 'fields' => ['connectorid', 'name', 'protocol', 'data_type', 'url', 'item_value_type', 'authtype', 'username', 'token', 'max_records', 'max_senders', 'max_attempts', 'attempt_interval', 'timeout', 'http_proxy', 'verify_peer', 'verify_host', 'ssl_cert_file', 'ssl_key_file', 'status', 'tags_evaltype']],

            'search' =>                     ['type' => API_FILTER, 'flags' => API_ALLOW_NULL, 'default' => null, 'fields' => ['name', 'url', 'username', 'token', 'attempt_interval', 'timeout', 'http_proxy', 'ssl_cert_file', 'ssl_key_file', 'description']],

            'searchByAny' =>                ['type' => API_BOOLEAN, 'default' => false],

            'startSearch' =>                ['type' => API_FLAG, 'default' => false],

            'excludeSearch' =>              ['type' => API_FLAG, 'default' => false],

            'searchWildcardsEnabled' =>     ['type' => API_BOOLEAN, 'default' => false],

            // output

            'output' =>                     ['type' => API_OUTPUT, 'in' => implode(',', $this->output_fields), 'default' => API_OUTPUT_EXTEND],

            'countOutput' =>                ['type' => API_FLAG, 'default' => false],

            'selectTags' =>                 ['type' => API_OUTPUT, 'flags' => API_ALLOW_NULL | API_ALLOW_COUNT, 'in' => implode(',', ['tag', 'operator', 'value']), 'default' => null],

            // sort and limit

            'sortfield' =>                  ['type' => API_STRINGS_UTF8, 'flags' => API_NORMALIZE, 'in' => implode(',', $this->sortColumns), 'uniq' => true, 'default' => []],

            'sortorder' =>                  ['type' => API_SORTORDER, 'default' => []],

            'limit' =>                      ['type' => API_INT32, 'flags' => API_ALLOW_NULL, 'in' => '1:'.ZBX_MAX_INT32, 'default' => null],

            // flags

            'preservekeys' =>               ['type' => API_BOOLEAN, 'default' => false]

        ]];

​

        if (!CApiInputValidator::validate($api_input_rules, $options, '/', $error)) {

            self::exception(ZBX_API_ERROR_PARAMETERS, $error);

        }

​

        $db_connectors = [];

​

        if ($options['output'] === API_OUTPUT_EXTEND) {

            $options['output'] = $this->output_fields;

        }

​

        $resource = DBselect($this->createSelectQuery('connector', $options), $options['limit']);

​

        while ($row = DBfetch($resource)) {

            if ($options['countOutput']) {

                return $row['rowscount'];

            }

​

            $db_connectors[$row['connectorid']] = $row;