2021-06-26 11:23:15 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace BookStack\Api;
|
2019-12-29 08:02:26 -05:00
|
|
|
|
2023-05-17 12:56:55 -04:00
|
|
|
use BookStack\Activity\Models\Loggable;
|
|
|
|
use BookStack\Users\Models\User;
|
2023-07-12 11:16:12 -04:00
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
2019-12-29 08:02:26 -05:00
|
|
|
use Illuminate\Database\Eloquent\Model;
|
2019-12-29 21:16:07 -05:00
|
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
2019-12-30 09:51:28 -05:00
|
|
|
use Illuminate\Support\Carbon;
|
2019-12-29 08:02:26 -05:00
|
|
|
|
2020-11-20 13:53:01 -05:00
|
|
|
/**
|
2021-06-26 11:23:15 -04:00
|
|
|
* Class ApiToken.
|
|
|
|
*
|
|
|
|
* @property int $id
|
2020-11-20 13:53:01 -05:00
|
|
|
* @property string $token_id
|
|
|
|
* @property string $secret
|
|
|
|
* @property string $name
|
|
|
|
* @property Carbon $expires_at
|
2021-06-26 11:23:15 -04:00
|
|
|
* @property User $user
|
2020-11-20 13:53:01 -05:00
|
|
|
*/
|
|
|
|
class ApiToken extends Model implements Loggable
|
2019-12-29 08:02:26 -05:00
|
|
|
{
|
2023-07-12 11:16:12 -04:00
|
|
|
use HasFactory;
|
|
|
|
|
2019-12-29 08:02:26 -05:00
|
|
|
protected $fillable = ['name', 'expires_at'];
|
2019-12-29 12:03:52 -05:00
|
|
|
protected $casts = [
|
2021-06-26 11:23:15 -04:00
|
|
|
'expires_at' => 'date:Y-m-d',
|
2019-12-29 12:03:52 -05:00
|
|
|
];
|
2019-12-29 21:16:07 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the user that this token belongs to.
|
|
|
|
*/
|
|
|
|
public function user(): BelongsTo
|
|
|
|
{
|
|
|
|
return $this->belongsTo(User::class);
|
|
|
|
}
|
2019-12-30 09:51:28 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the default expiry value for an API token.
|
|
|
|
* Set to 100 years from now.
|
|
|
|
*/
|
|
|
|
public static function defaultExpiry(): string
|
|
|
|
{
|
|
|
|
return Carbon::now()->addYears(100)->format('Y-m-d');
|
|
|
|
}
|
2020-11-20 13:53:01 -05:00
|
|
|
|
|
|
|
/**
|
2021-10-26 17:04:18 -04:00
|
|
|
* {@inheritdoc}
|
2020-11-20 13:53:01 -05:00
|
|
|
*/
|
|
|
|
public function logDescriptor(): string
|
|
|
|
{
|
|
|
|
return "({$this->id}) {$this->name}; User: {$this->user->logDescriptor()}";
|
|
|
|
}
|
2019-12-29 08:02:26 -05:00
|
|
|
}
|