LASSIC Media らしくメディア
アクセストークンとリフレッシュトークンの違い|期限と保存場所
監修・編集責任者:牛尾 昭昌(株式会社LASSIC 執行役員)
この記事の結論
- アクセストークンはAPIに見せる短命の許可証、リフレッシュトークンはそれを取り直すために認可サーバーだけに見せる資格情報です。
- アクセストークンの期限は短くし、リフレッシュトークンは使われない期間と最初の発行からの上限で切ります。
- ブラウザのlocalStorageには置かず、ログアウト時の失効や同時の取り直しの動きまで試験で確かめます。
※ 本記事は2026年10月時点の公式情報(省庁・公的機関、および製品やサービスを提供する事業者が公開している資料)に基づきます。
アクセストークンとリフレッシュトークンは、Web APIやアプリにログインの仕組みを組み込むときによく出てくる言葉です。2つの違いが分からない、期限を何分や何日にすればよいか決めきれない、という声もよく聞かれます。
本記事では、2つのトークンの役割と違い、トークンを取り直す流れ、期限と保存場所の考え方を、表と図で順に整理します。最後に、開発を外部に頼むときに確かめておきたい点もまとめます。
それぞれの役割
どちらも、OAuth 2.0(外部のアプリに、パスワードを渡さずに利用の許可を与える仕組み)で使う文字列です。OAuth 2.0の仕様であるRFC 6749は、2つを次のように定めています。*1
- アクセストークン:「保護されたリソースにアクセスするための資格情報」。APIを呼び出すたびに見せる許可証
- リフレッシュトークン:「アクセストークンを取得するための資格情報」。許可証の期限が切れたときに取り直すために使う
- 発行するかどうか:リフレッシュトークンを出すかは、認可サーバー(トークンを発行するサーバー)の判断に任されていて、発行されない構成もある
2つを組み合わせると、漏れたときの被害を小さく保ちながら、利用者に何度もログインを求めずに済みます。OAuthの全体像は「OAuth入門」で、ログインした本人の情報を受け渡すIDトークンとの区別は「認証と認可の違い」で扱っています。
両者の違い
いちばん大きな違いは、見せる相手と期限の長さです。
| 観点 | アクセストークン | リフレッシュトークン |
|---|---|---|
| 見せる相手 | APIを提供するサーバー | 認可サーバーだけ |
| 期限の長さ | 短い | 長い |
| 使う場面 | APIを呼び出すたび | アクセストークンが切れたときだけ |
| 漏れたときの影響 | 期限が切れるまで使われる | 新しいアクセストークンを作られ続けるおそれがある |
| 主な守り方 | 期限を短くする | 使うたびに入れ替える、不要になったら無効にする |
アクセストークンは多くの場合、持っている人なら誰でも使える形で扱われます。そのためRFC 6750は、1時間以内の短い期限で発行するよう勧めています。*2 漏れても悪用できる時間を限れるからです。
一方、OAuth 2.0の守り方をまとめたRFC 9700は、リフレッシュトークンを攻撃者にとって魅力的な標的としています。*3 許された範囲全体のアクセストークンを作れてしまうため、アクセストークンより厳重に守ります。
トークンを取り直す流れ
登場するのは、APIを呼び出すアプリ(クライアント)、トークンを発行する認可サーバー、APIを提供するリソースサーバーの3者です。RFC 6749の図をもとにすると、流れは次のようになります。
- ステップ1:アプリが、利用者の許可と引き換えに2つのトークンを受け取る
- ステップ2:アクセストークンを付けてAPIを呼び出す
- ステップ3:期限が切れてエラーが返ったら、リフレッシュトークンを認可サーバーに送る
- ステップ4:新しいアクセストークンを受け取る。新しいリフレッシュトークンも届いたら、古いものは捨てる
ステップ4で古いリフレッシュトークンを捨てて新しいものに置き換えることは、RFC 6749が必須としています。*1 リフレッシュトークンは、リソースサーバーには送りません。
期限と保存場所の決め方
期限の値は仕様では決まっていないため、大手の認可サーバーが公開している既定値が手がかりになります。
| 資料 | アクセストークン | リフレッシュトークン |
|---|---|---|
| Microsoft ID プラットフォーム | 60〜90分の間で発行ごとにばらつく(平均75分)*4 | ブラウザだけで動くアプリは24時間、それ以外は90日*5 |
| Google の OAuth 2.0 | 有効期間は限られている | 6か月使われないと働かなくなる*6 |
リフレッシュトークンには、2つの期限を組み合わせるのが基本です。1つは一定期間使われなければ切れる期限で、RFC 9700も、しばらく使われていないものは失効させるべきだとしています。*3 もう1つは最初の発行から数えた上限で、IETFの草案は、入れ替えても最初の期限より先へ延ばしてはならないとしています。*7
保存場所は、アプリの種類で変わります。
- サーバー側で動くWebアプリ:リフレッシュトークンはサーバー側に暗号化して保存し、ブラウザには渡さない
- ブラウザだけで動くアプリ:トークンを預かる画面専用のサーバー(BFF)を置き、ブラウザのlocalStorageには置かない
- スマートフォンアプリ:iOSのKeychainなど、OSが用意する保護された保存領域を使う
localStorageを避けるのは、悪意のあるスクリプトを埋め込まれると読み取られるためで、IETFの草案も、localStorageはこの読み取りを防げないと指摘しています。*7 手口は「XSS(クロスサイトスクリプティング)の仕組みと対策」で解説しています。
外部に頼むときに確認しておきたい点
認可の仕組みを外部の開発会社と作るときは、次の点が設計書や試験の計画にあるかを確かめます。
- 期限の根拠:2つのトークンの期限と、その値を選んだ理由が書かれているか
- 保存場所:アプリの種類ごとに、トークンをどこに置くかが決まっているか
- 同時の取り直し:複数のタブや画面が同時に取り直したとき、利用者が締め出されない作りか
- 失効:ログアウトやパスワード変更のときに、トークンを無効にする手順があるか
- 検証:期限を短くした検証環境で、期限切れからの取り直しを試しているか
認証の基盤ごと組み立てる場合は「KeycloakでSSO認証基盤を外注構築」も参考になります。
まとめ:トークンの設計で確かめたい3つの点
アクセストークンとリフレッシュトークンで確かめておきたい点は3つです。第一に、2つのトークンを見せる相手を分け、アクセストークンの期限を短くすること。第二に、リフレッシュトークンには使われない期限と最初の発行からの上限を設け、取り直すたびに入れ替えること。第三に、アプリの種類ごとに保存場所を決め、ログアウト時の失効まで試験で確かめることです。
よくある質問
アクセストークンの期限が切れる前に取り直してもよいですか
問題ありません。RFC 6749も、期限切れが分かっているならAPIを呼ぶ前にリフレッシュトークンで取り直す流れを示しています。サーバー間の時刻のずれを見込んで、少し早めに取り直すとエラーを減らせます。
サーバー同士の連携でも、リフレッシュトークンは使いますか
原則として使いません。RFC 6749は、アプリが自分の資格情報でアクセストークンを受け取る方式では、リフレッシュトークンを含めるべきではないとしています。期限が切れたら、同じ資格情報で取り直します。
利用者がパスワードを変えたら、発行済みのトークンはどうなりますか
認可サーバーの設定しだいです。RFC 9700は、パスワード変更や認可サーバーでのログアウトをきっかけに、リフレッシュトークンを自動で失効させてよいとしています。使う製品の動きを確かめ、設計書に書いておきます。
アクセストークンとリフレッシュトークンの設計のご相談
元請(プライムベンダー)として、認可の設計と実装から、システムの保守・運用までご提案します。
2006年の創業以来、一次請けのシステムインテグレーターとして、企業のシステム開発と保守・運用を受託してきました。
出典
- *1 参考:IETF「RFC 6749 The OAuth 2.0 Authorization Framework」(https://www.rfc-editor.org/rfc/rfc6749)。出典:1.4節(アクセストークン)・1.5節(リフレッシュトークンと図2)・4.4.3節(クライアントクレデンシャルでは発行しない)・6節(リフレッシュトークンの置き換え)を参照(2026年10月確認)
- *2 参考:IETF「RFC 6750 The OAuth 2.0 Authorization Framework: Bearer Token Usage」(https://www.rfc-editor.org/rfc/rfc6750)。出典:5.3節の推奨事項(1時間以内の短い期限)を参照(2026年10月確認)
- *3 参考:IETF「RFC 9700 Best Current Practice for OAuth 2.0 Security」(2025年1月)(https://www.rfc-editor.org/rfc/rfc9700)。出典:2.2.2節と4.14節(リフレッシュトークンが標的になること、使われないトークンの失効、パスワード変更やログアウトでの失効)を参照(2026年10月確認)
- *4 参考:Microsoft Learn「Access tokens in the Microsoft identity platform」(https://learn.microsoft.com/en-us/entra/identity-platform/access-tokens)。出典:Token lifetime の項(既定の有効期間は60〜90分の間でランダム、平均75分)を参照(2026年10月確認)
- *5 参考:Microsoft Learn「Refresh tokens in the Microsoft identity platform」(https://learn.microsoft.com/en-us/entra/identity-platform/refresh-tokens)。出典:Token lifetime の項(ブラウザだけで動くアプリは24時間、それ以外は90日)を参照(2026年10月確認)
- *6 参考:Google for Developers「Using OAuth 2.0 to Access Google APIs」(https://developers.google.com/identity/protocols/oauth2)。出典:Refresh token expiration の項(6か月使われないと働かなくなる)を参照(2026年10月確認)
- *7 参考:IETF「OAuth 2.0 for Browser-Based Applications」(Internet-Draft draft-ietf-oauth-browser-based-apps-27)(https://datatracker.ietf.org/doc/draft-ietf-oauth-browser-based-apps/)。出典:策定中の文書。6.3.2.3節(リフレッシュトークンの期限の上限)・8.5節(localStorageの性質)を参照(2026年10月確認)