執筆: 神崎 澪(セキュリティアナリスト(AI))監修: 千葉圭介更新日
アクセストークンとは、ログインした後に発行される、一時的な通行証のようなものです。IETFのRFC 6749(OAuth 2.0)は、保護された資源へ入るための資格情報で、アプリに与えられた許可を表す文字列と定めています。
アクセストークンはどんな仕組み?
ホテルのルームキーを思い浮かべてください。チェックインで本人確認と手続きを済ませると、その部屋にだけ入れる鍵を渡されます。鍵は滞在の期間が過ぎれば使えなくなります。アクセストークンは、このルームキーにあたります。
RFC 6749は、登場する役を四つに分けています。資源の持ち主、持ち主に代わって動くアプリ(クライアント)、トークンを発行する認可サーバー、資源を預かるサーバーです。多くの場合、認可サーバーが持ち主の確認と許可を済ませてから、アプリにトークンを渡します。アプリは、そのトークンを添えて、資源を預かるサーバーへ要求します。
トークンは、持ち主が認めた範囲と期間を表す、とRFCは説明しています。文字列の中身は、通常アプリには意味が分からない形です。識別子のこともあれば、署名つきで情報を含むこともあります。API側の認証の失敗例は、API認証の不備で整理しています。
なぜアクセストークンが大事なのですか?
RFC 6750は、ベアラートークン(持参人式のトークン)を持つ人なら、誰でも対応する資源に入れると述べています。鍵を持った人が入れるルームキーと同じ性質です。そのため、保存しているときも、運んでいるときも、外に漏れないよう守る必要があります。
漏れたトークンは、持ち主以外にも使われてしまいます。有効な範囲と期間を絞っておくと、漏れたときの影響を小さくできます。トークンはAPIキーとも似ていますが、多くは利用者の許可に基づいて発行され、アプリ自身の資格で発行される場合もあります。扱いの基本は、次のとおりです。
- 通信は、暗号化された経路(TLS)で送ります。
- 端末やブラウザの中の保存場所を、必要な範囲に限ります。
- 有効な期間と、使える範囲を、必要最小限にします。
- 漏れた疑いがあれば、すぐに失効させる手順を用意します。
関連する言葉
- JWT:ログインした証明を持ち運べる形にした書類です。
- APIキー:サービスの呼び出しを許可されたことを示す長い合言葉です。
- OAuth:パスワードを渡さずに、別のアプリへ許可を与える仕組みです。
- セッション:ログインしてから終えるまでの一連の利用状態です。
次の一手
APIの認証の失敗例はAPI認証の不備にあります。自社のAPIの入口がどう見えるかは無料URLチェックで、トークンの扱いの見直しは無料相談で相談できます。
よくある質問
アクセストークンとJWTは、同じものですか?
同じではありません。RFC 6749は、トークンが識別子のこともあれば、署名つきで情報を含むこともあり、形式もさまざまだと述べています。JWTは、トークンの中身の形式の一つです。アクセストークンがJWTとは限りません。
アクセストークンが盗まれたら、どうなりますか?
RFC 6750は、ベアラートークンを持つ人なら、誰でも対応する資源を使えると述べています。盗まれたトークンは、期限まで使われるおそれがあります。有効期間を短くし、失効の手順を決めておいてください。
よくある質問
アクセストークンとJWTは、同じものですか?
同じではありません。RFC 6749は、トークンが識別子のこともあれば、署名つきで情報を含むこともあり、形式もさまざまだと述べています。JWTは、トークンの中身の形式の一つです。アクセストークンがJWTとは限りません。
アクセストークンが盗まれたら、どうなりますか?
RFC 6750は、ベアラートークンを持つ人なら、誰でも対応する資源を使えると述べています。盗まれたトークンは、期限まで使われるおそれがあります。有効期間を短くし、失効の手順を決めておいてください。