ログイン情報の持たせ方
ハンズオンに入る前に、ログイン機能を実装するときにフロントエンド側で判断する主要な論点を整理しておきます。認証と認可の違い、ログイン状態を保存する場所の選択肢、そのなかでCookieが担う役割と押さえておくべき属性を先に確認します。
1. 認証と認可の違い
Webアプリケーションで一緒に語られる「認証」と「認可」は、それぞれ別の役割を持ちます。
認証(Authentication)は、「アクセスしてきた相手が誰であるか」を確かめる仕組みです。ログイン画面でメールアドレスとパスワードを入力し、サーバ側でパスワードを照合して「たしかにこのユーザ本人だ」と識別する処理が該当します。
認可(Authorization)は、「そのユーザが何をしてよいか」を判断する仕組みです。「ログイン済みユーザだけがダッシュボードを見られる」「管理者ロールのユーザだけが管理メニューを開ける」といった判断が認可にあたります。
この2つは順番も役割も違います。まず認証で相手が誰かを特定し、その結果を根拠に認可で操作の可否を判定する、というのが基本の流れです。本章のハンズオンでも、ログインAPI(認証)を先に用意し、その後で「認証済みユーザだけがダッシュボードを見られる」「管理者ロールにだけ管理メニューが見える」という認可を実装します。
2. ログイン状態はどこに持たせるか
ログイン中のユーザ情報をフロントエンドで扱うとき、保存場所には複数の選択肢があります。どこに何を持たせるかで、セキュリティ性・利便性・実装の複雑さが変わります。
| 保存場所 | 主な用途 | 認証トークンに向くか |
|---|---|---|
| ローカルストレージ | ページ間で保持したいユーザ設定など | 向かない。JavaScriptから読めるため、XSSでトークンを盗まれるリスクが高い |
| セッションストレージ | タブ内だけで保持したい一時的な情報 | 向かない。ローカルストレージと同じくJavaScriptから読めてしまう |
Cookie(HttpOnly 付き) |
サーバに自動送信される識別情報 | 向く。HttpOnly を付けるとJavaScriptから読めなくなり、XSSで盗まれにくくなる |
| メモリ上の状態 | 画面表示中のユーザ名・ロールなどの派生情報 | トークン自体は Cookie に任せ、派生情報だけをメモリ上の状態で持つ |
一般的なパターンは、「識別情報(サーバに送って身分を証明するトークン)はhttpOnly Cookieに任せて、フロント側では派生情報(ユーザ名・ロールなど)だけをメモリ上の状態で持つ」という組み合わせです。本章もこのパターンで進めます。
| 📝 XSS とは |
|---|
| XSS(Cross-Site Scripting)は、Webページに悪意のあるJavaScriptが埋め込まれてしまう攻撃の総称です。埋め込みが成立すると、そのページのJavaScriptから読める情報はすべて攻撃者に盗まれる可能性があります。ローカルストレージ・セッションストレージに置いた認証トークンはJavaScriptから読めるため、XSSが1箇所でも成立すると認証情報が丸ごと持ち出される事故につながります。 |
3. Cookieとは
Cookie は、ブラウザに保存される小さなデータです。サーバがレスポンスヘッダで Set-Cookie を返すと、ブラウザはそのCookieを保存し、以降同じドメインへのリクエスト時に自動的にリクエストヘッダに載せて送り返します。
ブラウザとサーバがCookieをやり取りする流れは、以下のようになっています。
Cookieは「サーバがブラウザに識別情報を持たせておき、次回以降のリクエストで自動的に返してもらう仕組み」と捉えると理解しやすくなります。ログイン状態を維持する仕組みは、この「Cookieが毎回自動で送られてくる」性質を土台にしています。
本章のハンズオンでも、ログインAPI(/api/login)が発行した認証トークンをCookieに保存し、以降の現在のユーザ取得API(/api/me)や保護ページへのリクエスト時にブラウザから自動送信させることで、ログイン状態を維持します。フロントエンド側のコードでCookieを直接読み書きする処理は書きません。
4. Cookieの属性
Cookieに認証情報を入れる場合、そのCookieには適切な属性を必ず付けます。属性を付けないと、CookieはJavaScriptから読み書きでき、HTTP通信でも平文で送られる状態になり、盗まれるリスクが跳ね上がります。
代表的なCookie属性は以下の3つです。
| 属性 | 役割 |
|---|---|
HttpOnly |
JavaScriptの document.cookie からCookieに触れなくする。XSSで認証情報を盗まれるのを防ぐ |
Secure |
HTTPS通信のときにだけCookieを送る。HTTP通信で平文のまま送られてCookieが盗聴されるのを防ぐ |
SameSite |
別ドメインからのリクエスト時にCookieを送るかを制御する。Lax(既定)・Strict・None の3値がある。CSRF(他サイトから勝手にリクエストを飛ばされる攻撃)を防ぐ |
本章のハンズオンで発行するログインCookieは、HttpOnly + Secure + SameSite=Lax を付けた状態でセットします。これで、認証情報がフロントのJavaScriptから読めない状態を保てます。