README

使用 PHP 8.0 版本在微服务中管理 Lumen 和 Laravel 的 Auth0 集成。

安装

通过 composer

$ composer require carsguide/auth-manager

环境设置 .env 文件

AUTH0_AUDIENCE=
AUTH0_OAUTH_URL=
AUTH0_DOMAIN=
AUTH0_JWT_CLIENTID=
AUTH0_JWT_CLIENTSECRET=
AUTH0_ALGORITHM=

注册服务提供者

Lumen

将以下代码片段添加到 bootstrap/app.php 文件的 register service providers 部分

$app->register(Carsguide\Auth\Providers\AuthManagerServiceProvider::class);

Laravel

将以下代码片段添加到 config/app.php 文件的 register service providers 部分

Carsguide\Auth\Providers\AuthManagerServiceProvider::class,

注册中间件

要使用令牌和范围验证，请通过 routeMiddleware() 注册中间件

Lumen: bootstrap/app.php

$app->routeMiddleware([
    'auth' => Carsguide\Auth\Middlewares\Auth0Middleware::class,
]);

Laravel: app/Http/kernel.php

protected $routeMiddleware = [
    'auth' => \Carsguide\Auth\Middlewares\Auth0Middleware::class,
];

使用

生成 JWT 令牌

use Carsguide\Auth\AuthManager;
use GuzzleHttp\Client;

$auth = new AuthManager(new Client());
$auth = $auth->setAudience('foobar');
$auth->getToken();

使用 AuthManager Facade

use Carsguide\Auth\Facades\AuthManager;

AuthManager::setAudience('foobar')->getToken();

缓存 JWT 令牌

 AuthManager::setAudience('foobar')
    // By default, JWT will cache for 50 minutes
    // If you need to override the default length, 
    // pass minutes in cache(120) method.
    ->cache() // or ->cache($minutes = 120)
    ->getToken();

验证 JWT 令牌/范围访问

每个令牌都通过中间件进行验证。您必须在路由或控制器中调用中间件以验证访问。中间件需要定义范围，不能是全局的。

$this->middleware('auth:listings:read');

使用路由文件

$router->get('admin/profile', ['middleware' => 'auth:listings:read', function () {
    //
}]);