使用 PHP 接入 Apple 登录

小艾

PHP

发布于：Oct 3, 2023

810 words

3 min

想要接入 Apple 第三方登录，有两种方式：

验证 identityToken
验证 authorizationCode

两种方式都可以获取到用户授权的 Apple 信息，但是第一种方式相对简单一些。

验证 identityToken

登录流程图如下：

客户端（APP 端）登录成功之后，会拿到以下信息：

Object {
  "authorizationCode": "c6a79a2b031f343459c9d8f54838e933e.0.rryyt.4EIeY2_SW6qw1fphfGIZ-A",
  "email": null,
  "fullName": Object {
    "familyName": null,
    "givenName": null,
    "middleName": null,
    "namePrefix": null,
    "nameSuffix": null,
    "nickname": null,
  },
  "identityToken": "xxxx.yyyy.zzzz",
  "realUserStatus": 1,
  "state": null,
  "user": "001883.d382005d8c7845a9a5402dd10c398265.0950",
}

其中有一个 identityToken 字段，这个字段的值其实就是一个 JWT，可以看到使用 . 进行分隔，分为header、payload、signature 三部分。

客户端需要把这个 identityToken 传给后端，后端进行验证。

JWT里的 signature部分是苹果使用私钥对其进行的签名，要验证这个签名，需要先获得苹果的公钥，而公钥可以通过JWKSet.Keys（JSON Web Key Set）来转换获得。

如果请求成功，响应对象会包含三个 Apple 的公钥 JWKSet.Keys

该 API 会返回多个密钥，密钥的数量可能随时间而变化，从这组密钥中，选择具有匹配密钥标识符 ( kid) 的密钥来验证 Apple 颁发的任何 JSON Web 令牌 (JWT) 的签名。

因为需要对JWT的签名进行验证，因此需要使用到 firebase/php-jwt 第三方包。


public function loginByApple()
{
    $identityToken = request()->post("identity_token");
    $params = request()->all();
    if (empty($identityToken)) {
        return $this->failed("Apple id token require");
    }

    try {
        // 调用苹果接口获取 JWKS
        $apiResponse = file_get_contents('https://appleid.apple.com/auth/keys');
        $jwkSet = json_decode($apiResponse, true);
        if (!is_array($jwkSet)) {
            throw new AppRuntimeException("Get JWK failed");
        }

        // 将 JWKS 转换为公钥
        try {
            $pubKeys = JWk::parseKeySet($jwkSet);
        } catch (\Exception $e) {
            throw new AppRuntimeException("Parse key set failed:" . $e->getMessage());
        }

        // 使用公钥对JWT进行检验
        try {
            $headers = new \stdClass(['E256']);
            $payload = JWT::decode($identityToken, $pubKeys, $headers);
        } catch (\Exception $e) {
            throw new AppRuntimeException("Decode JWT failed:" . $e->getMessage());
        }

        // todo 登录逻辑
    } catch(AppRuntimeException $e) {
        return $this->failed($e->getMessage());
    } catch (\Exception $e) {
        return $this->failed("Apple logged in failed");
    }
}