OAuthプロバイダー
ルール
- 公開クライアント(SPA、モバイル)向けには、Implicitフローではなく、PKCEを用いたAuthorization Codeフローを使用すること
- ウェブアプリではサーバーサイドでコード交換を行うこと(クライアントシークレットはサーバーから外部に出してはならない)
- Stateパラメータ: ランダムな
state を生成し、セッション/クッキーに保存し、コールバックで検証すること(CSRF対策)
- Google OAuth: スコープ
openid email profile、ユーザー情報は id_token を使用
- GitHub OAuth: スコープ
read:user user:email、トークン交換エンドポイント https://github.com/login/oauth/access_token
- Discord OAuth: スコープ
identify email、トークンエンドポイント https://discord.com/api/oauth2/token
- トークンリフレッシュ:
refresh_token をサーバーサイドに保存し、access_token の期限切れ前にリフレッシュすること
- セッション管理: OAuthコールバック成功時にアプリセッションを作成し、OAuthトークンをクッキーに保存しないこと
- アカウント連携:
accounts テーブルを介して、ユーザーが複数のプロバイダを1つのアカウントに接続できるようにする
パターン
export async function GET(req: Request) {
const { searchParams } = new URL(req.url);
const code = searchParams.get("code");
const state = searchParams.get("state");
if (state !== cookies().get("oauth_state")?.value) {
return new Response("Invalid state", { status: 400 });
}
const tokens = await exchangeCodeForTokens(code);
const userInfo = await fetchUserInfo(tokens.access_token);
const user = await upsertUser(userInfo);
await createSession(user.id);
return redirect("/dashboard");
}
避けるべきこと
- フロントエンドコードにクライアントシークレットを保存すること(常にサーバーサイドでトークン交換を行うこと)
state パラメータを省略すること(CSRF攻撃は現実に存在する)
- 生のOAuthトークンをクッキーに保存すること(サーバーサイドセッションを使用すること)
- プロバイダ連携時に「そのメールアドレスを持つユーザーが既に存在する」ケースの処理を忘れること