在Laravel中验证第三方JWT（RS256 & JWKS）的教程

<?php

namespace App\Guard;

use App\Models\User; // 您自定义的用户模型
use Illuminate\Auth\GuardHelpers;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Http\Request;
use Tymon\JWTAuth\JWT;

class JWTGuard implements Guard
{
    use GuardHelpers;

    /**
     * @var JWT $jwt
     */
    protected JWT $jwt;

    /**
     * @var Request $request
     */
    protected Request $request;

    /**
     * JWTGuard constructor.
     * @param JWT $jwt
     * @param Request $request
     */
    public function __construct(JWT $jwt, Request $request)
    {
        $this->jwt = $jwt;
        $this->request = $request;
    }

    /**
     * 获取当前认证用户。
     *
     * @return \Illuminate\Contracts\Auth\Authenticatable|null
     */
    public function user()
    {
        if (!is_null($this->user)) {
            return $this->user;
        }

        // 尝试从请求中获取JWT，并检查其有效性
        if ($this->jwt->setRequest($this->request)->getToken() && $this->jwt->check()) {
            // 从JWT payload中获取用户标识（通常是'sub' claim）
            $id = $this->jwt->payload()->get('sub');

            // 根据IdP返回的用户信息创建或查找本地用户实例
            // 这里我们创建一个简单的User实例，您可以根据需要从数据库查找或设置更多自定义属性
            $this->user = new User();
            $this->user->id = $id;
            // 如果需要，可以从JWT payload中提取更多自定义声明并设置到用户模型
            // $this->user->email = $this->jwt->payload()->get('email');

            return $this->user;
        }

        return null;
    }

    /**
     * 验证用户凭据（在本场景中不使用，因为我们通过JWT验证）。
     *
     * @param array $credentials
     * @return bool
     */
    public function validate(array $credentials = [])
    {
        // 对于JWT验证，此方法通常留空或返回false
        return false;
    }
}

<?php

namespace App\Models;

use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
use Illuminate\Database\Eloquent\Model;

class User extends Model implements AuthenticatableContract
{
    // 这里可以添加您需要的自定义属性和方法
    // 例如，如果JWT中包含用户角色或权限信息，可以在这里处理

    /**
     * Get the name of the unique identifier for the user.
     *
     * @return string
     */
    public function getAuthIdentifierName()
    {
        return 'id'; // 假设您的用户模型使用'id'作为主键
    }

    /**
     * Get the unique identifier for the user.
     *
     * @return mixed
     */
    public function getAuthIdentifier()
    {
        return $this->id;
    }

    /**
     * Get the password for the user.
     *
     * @return string
     */
    public function getAuthPassword()
    {
        return ''; // 对于JWT认证，密码通常不直接存储或使用
    }

    /**
     * Get the "remember me" token value.
     *
     * @return string
     */
    public function getRememberToken()
    {
        return null; // 对于无状态JWT认证，不需要remember token
    }

    /**
     * Set the "remember me" token value.
     *
     * @param  string  $value
     * @return void
     */
    public function setRememberToken($value)
    {
        //
    }

    /**
     * Get the column name for the "remember me" token.
     *
     * @return string
     */
    public function getRememberTokenName()
    {
        return '';
    }
}

<?php

namespace App\Providers;

use App\Guard\JWTGuard; // 引入您的自定义守卫
use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
use Illuminate\Support\Facades\Gate;

class AuthServiceProvider extends ServiceProvider
{
    /**
     * The policy mappings for the application.
     *
     * @var array
     */
    protected $policies = [
        // 'App\Models\Model' => 'App\Policies\ModelPolicy',
    ];

    /**
     * Register any authentication / authorization services.
     *
     * @return void
     */
    public function boot()
    {
        $this->registerPolicies();

        // 扩展Laravel的认证系统，注册自定义的'jwt-auth'守卫
        $this->app['auth']->extend(
            'jwt-auth', // 守卫的驱动名称
            function ($app, $name, array $config) {
                $guard = new JWTGuard(
                    $app['tymon.jwt'], // 获取tymon.jwt实例
                    $app['request']    // 获取当前请求实例
                );

                // 确保每次请求时，守卫都能获取到最新的请求实例
                $app->refresh('request', $guard, 'setRequest');

                return $guard;
            }
        );
    }
}

<?php
// config/auth.php

return [
    'defaults' => [
        'guard' => 'web', // 默认守卫，可以根据需要调整
        'passwords' => 'users',
    ],

    'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        // ... 其他守卫

        'jwt' => [ // 定义您的JWT守卫
            'driver' => 'jwt-auth', // 对应AuthServiceProvider中extend的驱动名称
            'provider' => 'users'   // 可以是任何有效的provider，这里我们使用默认的users
        ],
    ],

    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\Models\User::class,
        ],
        // ...
    ],
    // ...
];

<?php
// routes/api.php 或其他路由文件

use Illuminate\Support\Facades\Route;
use Illuminate\Support\Facades\Auth;

Route::middleware('auth:jwt')->get('/user', function () {
    // 只有携带有效JWT并成功通过'jwt'守卫认证的请求才能到达这里
    return Auth::user(); // 返回当前认证用户实例
});

// 您也可以在控制器构造函数中使用
// public function __construct()
// {
//     $this->middleware('auth:jwt');
// }