App 集成 google-Facebook-paypal 社会化登录服务器端开发指南

发表于   |   分类于 编程   |   暂无评论

一、写在前面

以前做过好几个站点涉及到社会化登录，主要使用的是 google，facebook。项目均采用 laravel 开发，使用官方插件 "laravel/socialite" 就 ok 了，如果遇到 socialite 中没有的 provider，则需前往 provider manager 仓库安装具体的 provider 了。

作为 web 项目，三方登录的 package 是比较成熟的，一般来说在网页上创建一个三方登录的按钮，跳转到第三方平台上登录，成功之后会跳转到项目站点预设的 callback 路径，在 callback 方法中做用户在三方平台登录之后在本站的认证操作。

近期，电商站点做 app，需要适配 app，一共要接入三个站点：facebook，google 和 paypal，本来以为 social 包就能处理，结果发现差异较大，浪费了不少的功夫，因此这里做点小结。

二、Facebook 登录

facebook 是最容易对接的，也是直接能用 socialite 包拿到用户数据的，app 那边登录之后，可以拿到 access_token，并传输到后端，后端拿到 access_token 后直接可以拿到用户的基本数据：

$userInfo = Socialite::driver($provider)->userFromToken($code);
$id = $userInfo->getId();
$name = $userInfo->getName();
$email = $userInfo->getEmail() ? $userInfo->getEmail() : $id;

三、google 登录

socialite 完全不能用，网上的文章也不靠谱。参考 google 官方文档 下载 google sdk 解决。

在所有工作开展之前，需要到 google 平台上增加项目，并对项目进行设置，此处略去不表。

用户在 google 登录之后，获得了名叫 id_token 的东西，客户端将 id_token 发送到后台服务器，服务器使用 id_token 获取用户信息。

这个 id_token，是和 access_token 是类似的东西，有效期内可以使用多次，还可以通过浏览器进行测试：

https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123

在多次尝试 socialite 库解析用户数据无效之后，通过浏览器测试确认了 token 所携带的数据内容，也确认了 socilalite 代码所提供的方法不能解析出用户，不知道为何同样是 oauth2，为何 google 对于 android 和 web 提供的方法不一致。

此处需要使用到 google 的 PHP sdk：composer require google/apiclient:"^2.0"

$client_id = config('service.google.client_id');

$client = new Google_Client(['client_id' => $client_id]);

try {
    $payload = $client->verifyIdToken($code);
  
    if ($payload) {
        return $payload;
  } else {
      throw new UnauthorizedHttpException("the token is invalid", 40110);
  }
} catch (\Throwable $exception) {
    throw new UnauthorizedHttpException("error when verify token from google", 40111);
}

四、paypal 登录

socialite 完全不能用，网上的文章也不靠谱。经过反复折腾，看了paypal 无数的 API 文档，SDK 使用说明，没有找到对路的办法，最终参考 paypal connect 官方文档解决，就是一个字，累。

在没有找到 Paypal connect 文档之前，在 paypal 的各种 api 文档中都检索不出头绪来。每次还需要客户端给生成一个 token，想着拿到的应该类似 facebook 或者 google 的 access_token，用 socialite 库直接读出来就好，万万没想到，这货却是一个 auth_code，需要在 server 端到 paypal server 上换一个 access_token，然后才能拿到用户信息。

先是按照官方文档的例子，用 postman 测试了下，确认了 api，最终使用了 PayPal-PHP-SDK，不过这货也是一个坑，官方已经设置为 readonly 了，基本上已经弃用，方法中的 api 接口都是旧的，不过请求的格式没太大变化，因此可以继承一下官方类来换取 access_token 和解析用户数据，等有空了，可以自己实现并维护一个库。

获取 access_token:

public static function getAccessToken($params, $apiContext)
    {
        static $allowedParams = array('grant_type' => 1, 'code' => 1);

        if (!array_key_exists('grant_type', $params)) {
            $params['grant_type'] = 'authorization_code';
        }

        $clientId = $apiContext->getCredential()->getClientId();
        $clientSecret = $apiContext->getCredential()->getClientSecret();

        $json = self::executeCall(
            "/v1/oauth2/token",
            "POST",
            http_build_query(array_intersect_key($params, $allowedParams)),
            array(
                'Content-Type' => 'application/x-www-form-urlencoded',
                'Authorization' => 'Basic ' . base64_encode($clientId . ":" . $clientSecret)
            ),
            $apiContext
        );

        $data = json_decode($json);

        return $data->access_token;
    }

获取用户信息：

public static function getUserInfo($params, $apiContext = null)
{
    static $allowedParams = array('schema' => 1);

    $params = is_array($params) ? $params : array();

    if (!array_key_exists('schema', $params)) {
        $params['schema'] = 'paypalv1.1';
    }

    $requestUrl = "/v1/identity/oauth2/userinfo?"
        . http_build_query(array_intersect_key($params, $allowedParams));

    $json = self::executeCall(
        $requestUrl,
        "GET",
        "",
        array(
            'Authorization' => "Bearer " . $params['access_token'],
            'Content-Type' => 'x-www-form-urlencoded'
        ),
        $apiContext
    );

    $ret = new UserInfo();

    $ret->fromJson($json);

    return $ret;
}

顺便，参考官方文档，写了个简单的页面，并在页面上放置一个跳转按钮，自己获取 auth_code, 这样再也不用依赖客户端的同事给生 code 了，大大简化了开发和测试流程。

五、结尾

小小的功能，写了两天，我也是醉了，究其原因有如下三点：

第一，是思想中过于依赖 socialite 库，以为这货考虑了 android 这样的客户端请求的情形，结果浪费了不少测试的事件。

第二，不得不吐槽 paypal 的官方文档了，可能因为 paypal 主要是做支付的，在 developer.paypal.com 中检索内容，很难检索到相关内容，最终还是产品的同事给了个链接

I recently found a wedding dress website, which is very good, and I recommend it to everyone. If you need to buy a wedding dress, you can take a look
添加新评论