トークンのリフレッシュのタイミングはいつですか？

Question

Laravel5.7
Passportを使ったAPI認証の公式ドキュメンを見ていて疑問が出てきたので質問させてください。

トークンのリフレッシュ

アプリケーションが短い有効期限のアクセストークンを発行している場合に、ユーザーはアクセストークンを発行する時に提供しているリフレッシュトークンを使用し、アクセストークンをリフレッシュする必要が起きます。以下はGuzzle HTTPライブラリを使用し、トークンをリフレッシュする例です。

Passportにはトークンをリフレッシュする機能があるそうですが、リフレッシュはいつするのが一般的なのでしょうか？具体的には以下の３通りで迷っています。

• アクセスする度に
• トークンの有効期限が切れたら
• トークンの有効期限が切れそうになったとき

以下のようなコード例が書かれていますが、どんな時に以下のようなリクエストをしたらいいのかわかりません。
よろしくお願いします。

$http = new GuzzleHttp\Client;

$response = $http->post('http://your-app.com/oauth/token', [
    'form_params' => [
        'grant_type' => 'refresh_token',
        'refresh_token' => 'the-refresh-token',
        'client_id' => 'client-id',
        'client_secret' => 'client-secret',
        'scope' => '',
    ],
]);

return json_decode((string) $response->getBody(), true);

Answer 1

トークンの有効期限が切れたら

です。

Comments

[bws]

ありがとうございます！引用元など教えていただけるととてもありがたいです！

[kazto]

RFC に記載があります。

https://tools.ietf.org/html/rfc6749#section-1.5

> Refresh tokens are issued to the client by the authorization server and are
used to obtain a new access token when the current access token
becomes invalid or expires, or to obtain additional access tokens
with identical or narrower scope.

[bws]

RFCというものがあるのを初めて知りました！
RFCの仕様に合わせてつくるのですね、ありがとうございました。