88 lines
2.2 KiB
PHP
88 lines
2.2 KiB
PHP
<?php
|
|
/**
|
|
* ApiToken.php
|
|
*
|
|
* api_tokens simple tokens for api
|
|
*
|
|
* 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, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* 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.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* @package LibreNMS
|
|
* @link http://librenms.org
|
|
* @copyright 2018 Tony Murray
|
|
* @author Tony Murray <murraytony@gmail.com>
|
|
*/
|
|
|
|
namespace App\Models;
|
|
|
|
class ApiToken extends BaseModel
|
|
{
|
|
public $timestamps = false;
|
|
protected $table = 'api_tokens';
|
|
|
|
// ---- Helper Functions ----
|
|
|
|
/**
|
|
* Check if the given token is valid
|
|
*
|
|
* @param string $token
|
|
* @return bool
|
|
*/
|
|
public static function isValid($token, $user_id = null)
|
|
{
|
|
$query = self::query()->isEnabled()->where('token_hash', $token);
|
|
|
|
if (!is_null($user_id)) {
|
|
$query->where('user_id', $user_id);
|
|
}
|
|
|
|
return $query->exists();
|
|
}
|
|
|
|
/**
|
|
* Get User model based on the given API token (or null if invalid)
|
|
*
|
|
* @param string $token
|
|
* @return User|null
|
|
*/
|
|
public static function userFromToken($token)
|
|
{
|
|
return User::find(self::idFromToken($token));
|
|
}
|
|
|
|
/**
|
|
* Get the user_id for the given token.
|
|
*
|
|
* @param string $token
|
|
* @return int
|
|
*/
|
|
public static function idFromToken($token)
|
|
{
|
|
return self::query()->isEnabled()->where('token_hash', $token)->value('user_id');
|
|
}
|
|
|
|
// ---- Query scopes ----
|
|
|
|
public function scopeIsEnabled($query)
|
|
{
|
|
return $query->where('disabled', 0);
|
|
}
|
|
|
|
// ---- Define Relationships ----
|
|
|
|
public function user()
|
|
{
|
|
return $this->belongsTo('App\Models\User', 'user_id');
|
|
}
|
|
}
|