如何使用 OAuth 刷新令牌更新访问令牌？

Question

我正在为 Uber 创建简单的应用程序。
我已经通过这个 API 解决了 3 个步骤：https://developer.uber.com/docs/authentication
但现在我想刷新令牌（第 5 步）。
我收到 access_token、refresh_token、expires_in 值，但我不明白如何设置计时器以在 expires_in 时间到期时用 refresh_token 刷新用户的令牌。
这里我提供了我的代码示例，我想用 refresh_token 更新访问令牌。

<?php
session_start();

require_once 'uber_b.php';
require_once 'config.php';


if(isset($_GET['code'])) {
// try to get an access token
$code = $_GET['code'];
$url = 'https://login.uber.com/oauth/token';

/* 
* Create row for function setPostData (uber_b.php)
* All of this rows will be used to build our request
*/
$params = array(
    "code" => $code,
    "client_id" => $client_id,
    "client_secret" => $client_secret,
    "redirect_uri" => $redirect,
    "grant_type" => "authorization_code"
);
//create example of class
$request = new HttpPost($url);
//Connect this class with our settings
$request->setPostData($params);
//Send our request to Uber
$request->send(); 
//Receive response
$responseObj = json_decode($request->getHttpResponse());
//Execute parameters from answer
$user_token = $responseObj->access_token;
//Refresh token 
$refresh_token = $responseObj->refresh_token;
//Time for token
$expires_in = $responseObj->expires_in;

echo "User's token: " . $user_token;
echo "<br>";
echo "Refresh token is: " .$refresh_token ;
echo "<br>";
echo "Time: ".$expires_in;
echo "<br>";
echo "<a href='order.php'>Order a car</a>";
}

//Refresh token
if(isset($responseObj))
{
        $exp_time = time()+2592000;
        try {
            //insert into database
            $stmt = $db->prepare('INSERT INTO token2 (exp_time)
                                      VALUES (:exp_time)
                                    ');
            $stmt->execute(array(
                ':exp_time' => $exp_time
            ));             
        } catch(PDOException $e) {
            echo $e->getMessage();
        }
}
if(time() >= $exp_time)
{
//Parameters for Uber refresh token request(step 5)
$r_params = array(
    "client_id" => $client_id,
    "client_secret" => $client_secret,
    "redirect_uri" => $redirect,
    "grant_type" => "refresh_token",
    "refresh_token" => $refresh_token
    );
 $r_request = new RefreshToken($url);

 $r_request->setPostData($r_params);
 $r_request->send(); 
 $refresh = $refresh_token;
 $r_responseObj = json_decode($r_request->Refresh());

echo "New Refresh token: " . $r_responseObj->refresh_token;
echo "<br>";
}
?>

如您所见，我不提供计时器功能，因为我不明白如何使它正确。
那么，您能解释一下如何使用 refresh_token 正确更新 access_token 吗？
也许我必须使用 setcookie() 或其他方法来解决这个任务？

Answer 1

• 首先，根据STEP FIVE: REFRESHING TOKENS中的Authentication docs，刷新访问令牌需要HTTP POST以下参数：

  client_secret=YOUR_CLIENT_SECRET
  client_id=YOUR_CLIENT_ID
  grant_type=refresh_token
  redirect_uri=YOUR_REDIRECT_URI
  refresh_token=REFRESH_TOKEN

  到https://login.uber.com/oauth/v2/token API 端点

  您还发送了 code 参数，这意味着您将收到一个错误，因为此附加参数无法在 Uber 的服务器上验证。 你得到的错误将是

  HTTP/1.1 401 UNAUTHORIZED
  {"error": "invalid_grant"}  
  

• 为了能够检查令牌的有效性，在您与访问令牌交换代码后，您需要：

  • 在某处保留“access_token”、“expires_in”、“refresh_token”和一个以秒为单位的 UNIX 时间戳，表示当前时间和日期，我们称之为“itime”。

  • 您可以存储此信息的位置多种多样：会话、文件、数据库、内存缓存等，具体取决于您希望如何处理令牌过期和自动用户登录（如果您已经保存了他们的令牌）并且没有过期，就不用让用户重新登录了。

  • 在您向 Uber API 发出每个 HTTP 请求之前，您首先通过从用户访问令牌的存储位置检索“itime”和“expires_in”来检查访问令牌是否未过期，然后确保 time() 如果条件为假，则需要刷新访问令牌。

  • 请记住，刷新访问令牌也会更改刷新令牌，因此您需要为 uuid 标识的当前用户替换当前的“access_token”、“refresh_token”和“expires_in”。

  • 鉴于访问令牌的当前到期时间是 30 天（2592000 秒），我建议您将访问令牌数据存储在数据库表中，因为 PHP 会话是短暂的（默认 session.gc_maxlifetime 为 1440 php.ini 中的秒/24 分钟），用户也不会一直停留在您的应用/网站上。
  • 此外，如果您允许用户从多个设备/地点登录优步，检查过期时间是不够的，因为在每个用户登录后，所有先前的访问/刷新令牌都将失效。因此，在用户在第二台设备上登录后，您可能在第一台设备上拥有无效的访问权限/令牌和有效的过期时间。 在这种情况下，要确定访问令牌是否仍然有效，我建议您使用访问令牌向 GET /v1/me 端点发出额外的 HTTP 请求。如果有效，则令牌仍然有效，否则令牌已过期/失效，您需要在第一台设备上请求用户重新登录。

tl;dr 您不需要计时器，您需要在每次向 Uber API 发出 HTTP 请求之前检查访问令牌是否仍然有效。
为此，您需要保留令牌详细信息 + UNIX 时间戳。