fishawack/laravel-passport-socialite

缺失的laravel passport 社交认证功能

v2.0.0 2019-01-30 09:00 UTC

This package is auto-updated.

Last update: 2024-09-29 05:29:44 UTC


README

laravel passport 缺失的社交认证插件(即 SocialGrant)。

描述

此包帮助使用laravel的本地包(即 passport 和 socialite)集成社交登录。此包允许从laravel/socialite包支持的提供者进行社交登录。

入门指南

要开始使用,请使用以下命令将以下包添加到您的 composer.json 文件中。

composer require schedula/laravel-passport-socialite

配置

当composer成功安装此包后,在您的 config/app.php 配置文件中注册 Schedula\Laravel\PassportSocialite\PassportSocialiteServiceProvider::class

'providers' => [
    // Other service providers...
    Schedula\Laravel\PassportSocialite\PassportSocialiteServiceProvider::class,
],

注意:您需要配置第三方社交提供者的密钥和密钥字符串,具体请参阅laravel socialite文档 https://laravel.net.cn/docs/5.6/socialite#configuration

用法

步骤 1 - 设置用户模型

在您的 User 模型上实现 UserSocialAccount,然后添加方法 findForPassportSocialitefindForPassportSocialite 应接受两个参数,即 $provider$id

$provider - 字符串 - 将是社交提供者,例如facebook、google、github等。

$id - 字符串 - 是社交提供者的用户ID,例如facebook的用户ID 1234567890。

函数应该找到与该信息相关联的用户并返回用户对象,如果没有找到则返回null。

以下是在上述实现之后您的 User 模型的样子。

namespace App;

use Schedula\Laravel\PassportSocialite\User\UserSocialAccount;
class User extends Authenticatable implements UserSocialAccount {
    
    use HasApiTokens, Notifiable;

    /**
    * Find user using social provider's id
    * 
    * @param string $provider Provider name as requested from oauth e.g. facebook
    * @param string $id User id of social provider
    *
    * @return User
    */
    public static function findForPassportSocialite($provider,$id) {
        $account = SocialAccount::where('provider', $provider)->where('provider_user_id', $id)->first();
        if($account) {
            if($account->user){
                return $account->user;
            }
        }
        return;
    }
}

注意:这里的 SocialAccount 是一个laravel模型,我在其中保存提供者和提供者_user_id以及本地数据库用户ID。以下是 social_accounts 表的示例。

步骤 2 - 使用社交提供者获取访问令牌

我建议您不要直接从您的应用程序请求访问令牌,因为社交登录的逻辑/概念是在不存在的情况下创建账户,或者如果已存在则登录。

所以在这种情况下,我们将创建一个自定义路由和一个控制器,该控制器将从您的客户端(即Android、iOS等应用程序)接收访问令牌或授权令牌。 在这里客户端从提供者获取访问令牌/授权令牌

我们的路由可以是这样的

Route::post('/auth/social/facebook', 'SocialLogin@loginFacebook');

以下是我们可以编写的控制器及其方法的示例

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use Route;
class SocialLogin extends Controller {

	public function loginFacebook(Request $request) {
		try {

			$facebook = Socialite::driver('facebook')->userFromToken($request->accessToken);
			if(!$exist = SocialAccount::where('provider',  SocialAccount::SERVICE_FACEBOOK)->where('provider_user_id', $facebook->getId())->first()){
				
				// create user account
			}
			return response()->json($this->issueToken($request, 'facebook', $request->accessToken));
		}
		catch(\Exception $e) {
			return response()->json([ "error" => $e->getMessage() ]);
		}
		
	}
    
	public function issueToken($request, $provider, $accessToken) {
		
		/**
		* Here we will request our app to generate access token 
		* and refresh token for the user using its social identity by providing access token 
		* and provider name of the provider. (I hope its not confusing)
		* and then it goes through social grant and which fetches providers user id then calls 
		* findForPassportSocialite from your user model if it returns User object then it generates 
		* oauth tokens or else will throw error message normally like other oauth requests.
		*/
		$params = [
			'grant_type' => 'social',
			'client_id' => 'your-client-id', // it should be password grant client
			'client_secret' => 'client-secret',
			'accessToken' => $accessToken, // access token from provider
			'provider' => $provider, // i.e. facebook
		];
		$request->request->add($params);
		
		$requestToken = Request::create("oauth/token", "POST");
		$response = Route::dispatch($requestToken);
		
		return json_decode((string) $response->content(), true);
	}
}

注意:SocialGrant 只接受访问令牌,不接受授权令牌,例如 google 在请求服务器授权代码(即离线访问)时提供了授权令牌,所以您需要用访问令牌交换授权代码。请参阅这里: https://github.com/google/google-api-php-client

注意:SocialGrant 与 PasswordGrant 类似,确保在发起 oauth 请求时使用密码授予的客户端ID和密钥

就是这样,朋友们