RBAC 授權
規則
- 在每個路由上使用中介軟體檢查權限——切勿讓授權變成可選項
- 預設拒絕:若未明確授予權限,則拒絕存取
- 伺服器端強制執行:隱藏 UI 元素不是安全性措施,請在伺服器端檢查
- 定義角色層級:admin > editor > viewer——較高角色繼承較低權限
- 資源級別檢查:驗證
can(user, "edit", resource)——不僅僅是基於角色的存取
- 審計所有權限檢查——記錄誰在何時存取了什麼,特別是針對管理員操作
- 區分身份驗證(你是誰?)與授權(你能做什麼?)
type Action = "read" | "create" | "update" | "delete";
type Resource = { ownerId: string; [key: string]: any };
function can(user: { id: string; role: string }, action: Action, resource?: Resource): boolean {
const permissions: Record<string, Action[]> = {
admin: ["read", "create", "update", "delete"],
editor: ["read", "create", "update"],
viewer: ["read"],
};
const allowed = permissions[user.role];
if (!allowed?.includes(action)) return false;
if (resource && action !== "read" && user.role !== "admin") {
return resource.ownerId === user.id;
}
return true;
}
function requirePermission(action: Action) {
return (req, res, next) => {
if (!req.user) return res.status(401).json({ error: "未經身份驗證" });
if (!can(req.user, action, req.resource)) {
return res.status(403).json({ error: "禁止存取" });
}
next();
};
}
app.put("/api/posts/:id", loadResource, requirePermission("update"), updatePost);
應避免事項
- 僅在 UI 中檢查權限——攻擊者會直接呼叫你的 API
- 除非明確拒絕,否則允許存取——務必預設拒絕
- 使用單一的
isAdmin 布林值——角色應具有細緻度且可擴展
- 忘記資源級別檢查——「編輯者」不應意味著「可以編輯所有人的內容」
- 在「內部」端點上跳過授權——它們最終會變成公開的