简介
除了典型的基于表单的身份验证之外,Laravel 还提供了一种使用 Laravel Socialite对 OAuth providers 进行身份验证的简单方便的方法。 Socialite 目前支持 Facebook,Twitter,LinkedIn,Google,GitHub,GitLab 和 Bitbucket 的身份验证。
安装
在开始使用 Socialite 之前,通过 Composer 软件包管理器将软件包添加到项目的依赖项中:
composer require laravel/socialite
升级
升级到 Socialite 的新主要版本时,请务必仔细查看 the upgrade guide.
配置
在使用 Socialite 之前,你需要为应用程序使用的OAuth提供程序添加凭据。通常,可以通过在要验证的服务的仪表板中创建“开发人员应用程序”来检索这些凭据。
这些凭证应该放在你的 config/services.php
配置文件中, 并且应该使用 facebook
, twitter
(OAuth 1.0), twitter-oauth-2
(OAuth 2.0), linkedin
, google
, github
, gitlab
, 或者 bitbucket
, 取决于应用程序所需的提供商:
'github' => [ 'client_id' => env('GITHUB_CLIENT_ID'), 'client_secret' => env('GITHUB_CLIENT_SECRET'), 'redirect' => 'http://example.com/callback-url', ],
认证
路由
要使用 OAuth 提供程序对用户进行身份验证,你需要两个路由:一个用于将用户重定向到 OAuth provider,另一个用于在身份验证后接收来自 provider 的回调。下面的示例控制器演示了这两个路由的实现:
use Laravel\Socialite\Facades\Socialite; Route::get('/auth/redirect', function () { return Socialite::driver('github')->redirect(); }); Route::get('/auth/callback', function () { $user = Socialite::driver('github')->user(); // $user->token });
redirect
提供的方法 Socialite
facade 负责将用户重定向到 OAuth provider,而该 user 方法将读取传入的请求并在身份验证后从提供程序中检索用户的信息。
身份验证和存储
从 OAuth 提供程序检索到用户后,你可以确定该用户是否存在于应用程序的数据库中并验证用户。如果用户在应用程序的数据库中不存在,通常会在数据库中创建一条新记录来代表该用户:
use App\Models\User; use Illuminate\Support\Facades\Auth; use Laravel\Socialite\Facades\Socialite; Route::get('/auth/callback', function () { $githubUser = Socialite::driver('github')->user(); $user = User::updateOrCreate([ 'github_id' => $githubUser->id, ], [ 'name' => $githubUser->name, 'email' => $githubUser->email, 'github_token' => $githubUser->token, 'github_refresh_token' => $githubUser->refreshToken, ]); Auth::login($user); return redirect('/dashboard'); });
访问作用域
在重定向用户之前,你还可以使用 scopes
方法在请求中添加其他「作用域」。此方法会将所有现有作用域与你提供的作用域合并:
use Laravel\Socialite\Facades\Socialite; return Socialite::driver('github') ->scopes(['read:user', 'public_repo']) ->redirect();
你可以使用 setScopes
方法覆盖所有现有范围:
return Socialite::driver('github') ->setScopes(['read:user', 'public_repo']) ->redirect();
可选参数
许多 OAuth providers 支持重定向请求中的可选参数。 要在请求中包含任何可选参数,请使用关联数组调用 with
方法:
use Laravel\Socialite\Facades\Socialite; return Socialite::driver('google') ->with(['hd' => 'example.com']) ->redirect();
检索用户详细信息
在将用户重定向回你的身份验证回调路由之后,你可以使用 Socialite 的 user
方法检索用户的详细信息。user
方法为返回的用户对象提供了各种属性和方法,你可以使用这些属性和方法在你自己的数据库中存储有关该用户的信息。
你可以使用不同的属性和方法这取决于要进行身份验证的 OAuth 提供程序是否支持 OAuth 1.0 或 OAuth 2.0:
从令牌中检索用户详细信息 (OAuth2)use Laravel\Socialite\Facades\Socialite; Route::get('/auth/callback', function () { $user = Socialite::driver('github')->user(); // OAuth 2.0 providers... $token = $user->token; $refreshToken = $user->refreshToken; $expiresIn = $user->expiresIn; // OAuth 1.0 providers... $token = $user->token; $tokenSecret = $user->tokenSecret; // All providers... $user->getId(); $user->getNickname(); $user->getName(); $user->getEmail(); $user->getAvatar(); });
如果你已经有了一个用户的有效访问令牌,你可以使用 Socialite 的 userFromToken
方法检索其详细信息:
从令牌中检索用户详细信息 (OAuth2)use Laravel\Socialite\Facades\Socialite; $user = Socialite::driver('github')->userFromToken($token);
如果你已经有了一对有效的用户令牌/秘钥,你可以使用 Socialite 的 userFromTokenAndSecret
方法检索他们的详细信息:
无认证状态use Laravel\Socialite\Facades\Socialite; $user = Socialite::driver('twitter')->userFromTokenAndSecret($token, $secret);
stateless
方法可用于禁用会话状态验证。 这在向 API 添加社交身份验证时非常有用: