authentication-authorization

name	authentication-authorization
description	ログイン、セッション、JWT、OAuth、アクセス制御を実装する際に使用。

Authentication & Authorization

📋 実行前チェック(必須)

このスキルを使うべきか?

• ログイン機能を実装する?
• JWT/セッション管理を行う?
• 権限チェックを実装する?
• パスワード処理を行う?

前提条件

• 認証方式(JWT/セッション/OAuth)を決定したか?
• トークンの有効期限を検討したか?
• 必要な権限レベルを定義したか?
• セキュリティ要件を把握しているか?

禁止事項の確認

• パスワードを平文で保存しようとしていないか?
• シークレットをハードコードしようとしていないか?
• トークンをURLに含めようとしていないか?
• フロントエンドのみで認可しようとしていないか?
• httpOnly/secureなしでCookieを設定しようとしていないか?

---

トリガー

• ログイン機能実装時
• JWT/セッション管理時
• 権限チェック実装時
• パスワード処理時

---

🚨 鉄則

認証(誰か) ≠ 認可(何ができるか)。両方必要。

---

認証方式

JWT

// ⚠️ 署名アルゴリズムはHS256以上
const token = jwt.sign({ userId }, SECRET, { 
  expiresIn: '15m',  // 短め
  algorithm: 'HS256'
});

// 検証
const decoded = jwt.verify(token, SECRET);

セッション

// ⚠️ セッションIDは十分なエントロピー
app.use(session({
  secret: process.env.SESSION_SECRET,  // 🚫 ハードコード禁止
  resave: false,
  saveUninitialized: false,
  cookie: {
    httpOnly: true,   // ⚠️ 必須
    secure: true,     // ⚠️ 本番では必須
    sameSite: 'lax'
  }
}));

---

認可

// ⚠️ すべてのエンドポイントで確認
function authorize(requiredRole: string) {
  return (req, res, next) => {
    if (!req.user) return res.status(401).json({ error: 'Unauthorized' });
    if (req.user.role !== requiredRole) {
      return res.status(403).json({ error: 'Forbidden' });
    }
    next();
  };
}

// リソースオーナー確認
if (resource.ownerId !== req.user.id && !req.user.isAdmin) {
  return res.status(403).json({ error: 'Forbidden' });
}

---

パスワード

// ⚠️ bcrypt, saltRounds 12以上
const hash = await bcrypt.hash(password, 12);
const isValid = await bcrypt.compare(password, hash);

---

🚫 禁止事項まとめ

// ❌ パスワード平文保存
user.password = password;

// ❌ トークンをURLに含める
/api/data?token=xxx

// ❌ フロントエンドのみで認可
if (user.role === 'admin') { showAdminPanel(); }

// ❌ シークレットのハードコード
const SECRET = 'my-secret-key';

// ❌ httpOnlyなしのセッションCookie
cookie: { httpOnly: false }