EVOLUTION-MANAGER
Edit File: apiclient.class.php
<?php /** * --------------------------------------------------------------------- * GLPI - Gestionnaire Libre de Parc Informatique * Copyright (C) 2015-2018 Teclib' and contributors. * * http://glpi-project.org * * based on GLPI - Gestionnaire Libre de Parc Informatique * Copyright (C) 2003-2014 by the INDEPNET Development Team. * * --------------------------------------------------------------------- * * LICENSE * * This file is part of GLPI. * * GLPI 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; either version 2 of the License, or * (at your option) any later version. * * GLPI 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. * * You should have received a copy of the GNU General Public License * along with GLPI. If not, see <http://www.gnu.org/licenses/>. * --------------------------------------------------------------------- */ /** * @since 9.1 */ class APIClient extends CommonDBTM { const DOLOG_DISABLED = 0; const DOLOG_LOGS = 1; const DOLOG_HISTORICAL = 2; static $rightname = 'config'; // From CommonDBTM public $dohistory = true; static function canCreate() { return Session::haveRight(static::$rightname, UPDATE); } static function canPurge() { return Session::haveRight(static::$rightname, UPDATE); } static function getTypeName($nb = 0) { return _n("API client", "API clients", $nb); } function defineTabs($options = []) { $ong = []; $this->addDefaultFormTab($ong) ->addStandardTab('Log', $ong, $options); return $ong; } function rawSearchOptions() { $tab = []; $tab[] = [ 'id' => 'common', 'name' => self::GetTypeName() ]; $tab[] = [ 'id' => '1', 'table' => $this->getTable(), 'field' => 'name', 'name' => __('Name'), 'datatype' => 'itemlink' ]; $tab[] = [ 'id' => '2', 'table' => $this->getTable(), 'field' => 'id', 'name' => __('ID'), 'massiveaction' => false, 'datatype' => 'number' ]; $tab[] = [ 'id' => '3', 'table' => $this->getTable(), 'field' => 'is_active', 'name' => __('Active'), 'datatype' => 'bool' ]; $tab[] = [ 'id' => '4', 'table' => $this->getTable(), 'field' => 'dolog_method', 'name' => __('Log connections'), 'datatype' => 'specific' ]; $tab[] = [ 'id' => 'filter', 'name' => __('Filter access') ]; $tab[] = [ 'id' => '5', 'table' => $this->getTable(), 'field' => 'ipv4_range_start', 'name' => __('IPv4 address range')." - ".__("Start"), 'datatype' => 'specific' ]; $tab[] = [ 'id' => '6', 'table' => $this->getTable(), 'field' => 'ipv4_range_end', 'name' => __('IPv4 address range')." - ".__("End"), 'datatype' => 'specific' ]; $tab[] = [ 'id' => '7', 'table' => $this->getTable(), 'field' => 'ipv6', 'name' => __('IPv6 address'), 'datatype' => 'text' ]; $tab[] = [ 'id' => '8', 'table' => $this->getTable(), 'field' => 'app_token', 'name' => __('Application token'), 'massiveaction' => false, 'datatype' => 'text' ]; return $tab; } static function getSpecificValueToDisplay($field, $values, array $options = []) { switch ($field) { case 'dolog_method' : $methods = self::getLogMethod(); return $methods[$values[$field]]; case 'ipv4_range_start': case 'ipv4_range_end': if (empty($values[$field])) { return ''; } return long2ip((int)$values[$field]); } return parent::getSpecificValueToDisplay($field, $values, $options); } /** * Show form * * @param integer $ID Item ID * @param array $options Options * * @return void */ function showForm ($ID, $options = []) { $this->initForm($ID, $options); $this->showFormHeader($options); echo "<tr class='tab_bg_1'>"; echo "<td>".__('Name')."</td>"; echo "<td>"; Html::autocompletionTextField($this, "name"); echo "</td>"; echo "<td rowspan='3'>".__('Comments')."</td>"; echo "<td rowspan='3'>"; echo "<textarea name='comment' >".$this->fields["comment"]."</textarea>"; echo "</td></tr>"; echo "<tr class='tab_bg_1'>"; echo "<td >".__('Active')."</td>"; echo "<td>"; Dropdown::showYesNo("is_active", $this->fields["is_active"]); echo "</td></tr>"; echo "<tr class='tab_bg_1'>"; echo "<td >".__('Log connections')."</td>"; echo "<td>"; Dropdown::showFromArray("dolog_method", self::getLogMethod(), ['value' => $this->fields["dolog_method"]]); echo "</td></tr>"; echo "<tr class='tab_bg_1'>"; echo "<th colspan='4'>"; echo "<div class='center'>". __("Filter access")."</div>"; echo "</th></tr>"; echo "<tr class='tab_bg_1'>"; echo "<td colspan='4'>"; echo "<i>".__('Leave these parameters empty to disable API access restriction')."</i>"; echo "<br><br><br>"; echo "</td></tr>"; echo "<tr class='tab_bg_1'>"; echo "<td>".__('IPv4 address range')."</td>"; echo "<td colspan='3'>"; echo "<input type='text' name='ipv4_range_start' value='". ($this->fields["ipv4_range_start"] ? long2ip($this->fields["ipv4_range_start"]) : '') . "' size='17'> - "; echo "<input type='text' name='ipv4_range_end' value='" . ($this->fields["ipv4_range_end"] ? long2ip($this->fields["ipv4_range_end"]) : '') . "' size='17'>"; echo "</td></tr>"; echo "<tr class='tab_bg_1'>"; echo "<td>".__('IPv6 address')."</td>"; echo "<td>"; Html::autocompletionTextField($this, "ipv6"); echo "</td>"; echo "<td colspan='2'></td>"; echo "</tr>"; echo "<tr class='tab_bg_1'>"; echo "<td>".sprintf(__('%1$s (%2$s)'), __('Application token'), "app_token")."</td>"; echo "<td colspan='2'>"; Html::autocompletionTextField($this, "app_token"); echo "<br><input type='checkbox' name='_reset_app_token' id='app_token'> "; echo "<label for='app_token'>".__('Regenerate')."</label>"; echo "</td><td></td></tr>"; $this->showFormButtons($options); } function prepareInputForAdd($input) { return $this->prepareInputForUpdate($input); } function prepareInputForUpdate($input) { if (isset($input['ipv4_range_start'])) { $input['ipv4_range_start'] = ip2long($input['ipv4_range_start']); } if (isset($input['ipv4_range_end'])) { $input['ipv4_range_end'] = ip2long($input['ipv4_range_end']); } if (isset($input['ipv4_range_start']) && isset($input['ipv4_range_end'])) { if (empty($input['ipv4_range_start'])) { $input['ipv4_range_start'] = "NULL"; $input['ipv4_range_end'] = "NULL"; } else { if (empty($input['ipv4_range_end'])) { $input['ipv4_range_end'] = $input['ipv4_range_start']; } if ($input['ipv4_range_end'] < $input['ipv4_range_start']) { $tmp = $input['ipv4_range_end']; $input['ipv4_range_end'] = $input['ipv4_range_start']; $input['ipv4_range_start'] = $tmp; } } } if (isset($input['ipv6']) && empty($input['ipv6'])) { $input['ipv6'] = "NULL"; } if (isset($input['_reset_app_token'])) { $input['app_token'] = self::getUniqueAppToken(); $input['app_token_date'] = $_SESSION['glpi_currenttime']; } return $input; } /** * Get log methods * * @return array */ static function getLogMethod() { return [self::DOLOG_DISABLED => __('Disabled'), self::DOLOG_HISTORICAL => __('Historical'), self::DOLOG_LOGS => _n('Log', 'Logs', Session::getPluralNumber())]; } /** * Get app token checking that it is unique * * @return string app token */ static function getUniqueAppToken() { $ok = false; do { $key = Toolbox::getRandomString(40); if (countElementsInTable(self::getTable(), ['app_token' => $key]) == 0) { return $key; } } while (!$ok); } }