php passport security,Laravel 的 API 认证系统 Passport 三部曲(一、passport安装+配置)

Laravel 的 API 认证系统 Passport 三部曲(一、passport安装+配置)

博主最近在搞app开发，但是用户的登录授权因为不能像web一样实用session驱动授权，这里我们使用Laravel 中的 Passport 实现 API 授权过程。Passport 基于 League OAuth2 server 实现。

坑：中文文档对授权的介绍不全，文档的例子都是基于laravel自带的user表来进行的设计开发，但是其用户表往往满足不了我们的需求，需要自己设计用户表，如何让自建的用户表去完美兼容auth认证，下文给你答案。

这里我的用户表为“login”表，主键为char(32)的guid(默认的user表主键为自增id)，用户名为varchar(64)的username(默认的user表用户名为email)

安装

和普通的composer组件安装一样，按照文档一步一步来即可

执行

composer require laravel/passport

将 Passport 的服务提供者注册到配置文件 config/app.php 的 providers 数组中：

Laravel\Passport\PassportServiceProvider::class,

Passport 使用服务提供者注册内部的数据库迁移脚本目录，所以上一步完成后，你需要更新你的数据库结构。Passport 的迁移脚本会自动创建应用程序需要的客户端数据表和令牌数据表：

地址：/vendor/laravel/passport/database/migrations

坑：由于用户表的用户id为char(32)，默认为自增id，这里四个表的用户id(user_id)类型需要进行修改为char(32)(如果设计到团队开发最好是新建修改字段类型的migration来修改用户id类型)

$table->char('user_id',32);

执行：

php artisan migrate

有些会报错“ Changing columns for table "oauth_auth_codes" requires Doctrine DBAL; install "doctrine/dbal". ”，需要安装组件，执行如下命令

composer require doctrine/dbal

接下来，你需要运行 passport:install 命令来创建生成安全访问令牌时用到的加密密钥，同时，这条 命令也会创建「私人访问」客户端和「密码授权」客户端：

执行：

php artisan passport:install

上面命令执行后，请将 Laravel\Passport\HasApiTokens Trait 添加到 App\Login 模型中，这个 Trait 会给你的模型提供一些辅助函数，用于检查已认证用户的令牌和使用作用域：

如果装了ideaHelp组件可以按ctrl追加进去看具体属性和功能

由于使用了自建用户表，这里要将表名、主键类型、主键名、用户名重写

namespace App\Model;

use Laravel\Passport\HasApiTokens;

use Illuminate\Notifications\Notifiable;

use Illuminate\Foundation\Auth\User as Authenticatable;

class Login extends Authenticatable

{

use HasApiTokens, Notifiable;

// 表名

protected $table = 'data_login_info';

// 主键

protected $primaryKey = 'guid';

// 主键类型

protected $keyType = 'string';

/**

* 说明:自定义授权用户名(默认为email)

*

* @param $username

* @return \Illuminate\Database\Eloquent\Model|null|static

* @author 郭庆

*/

public function findForPassport($username)

{

return CompanyLogin::where('username', $username)->first();

}

}

接下来，需要在 AuthServiceProvider 的 boot 方法中调用 Passport::routes 、enableImplicitGrant、tokensCan、tokensExpireIn、refreshTokensExpireIn具体作用看注释。

public function boot()

{

$this->registerPolicies();

// 会注册一些在访问令牌、客户端、私人访问令牌的发放和吊销过程中会用到的必要路由

Passport::routes();

// 简化授权

// Passport::enableImplicitGrant();

// 定义令牌作用域

Passport::tokensCan([

'place-orders' => 'Place orders',

'check-status' => 'Check order status',

]);

// accessToken有效期

Passport::tokensExpireIn(Carbon::now()->addDays(15));

// accessRefushToken有效期

Passport::refreshTokensExpireIn(Carbon::now()->addDays(30));

}

7. 最后，需要将配置文件 config/auth.php 中 api 部分的授权保护项( driver )改为 passport 。此调整会让你的应用程序在接收到 API 的授权请求时使用 Passport 的 TokenGuard 来处理：

```

'guards' => [

'web' => [

'driver' => 'session',

'provider' => 'login',

],

'api' => [

'driver' => 'passport',

'provider' => 'login',

],

],

'providers' => [

'login' => [

'driver' => 'eloquent',

'model' => App\Model\Login::class,

]

],

```

8. 以上步骤完成之后，passport的安装就完成了，具体配置的修改根据自己的新建的用户表来进行修改配置。

9. 明后天博主会出具体的令牌发放修改(二部曲)、整体实现api授权认证登录api整体流程(三部曲)尽请期待！

> 本文博主**亲自**手码，手写不易，欢迎转载，**打赏**，转载请**注明出处**，否则后果自负！