Firebase权限控制求助：糖尿病应用管理员登录页面防普通用户登录

针对你遇到的普通用户能访问管理员登录页的问题，我们可以通过角色区分+权限验证的方式来解决，Firebase提供了几种可靠的实现路径，下面一步步给你拆解：

1. 给用户分配角色：用自定义Claims标记管理员 #

Firebase Auth允许我们给用户添加自定义Claims（自定义声明），这是最适合做角色区分的方式，因为Claims会被包含在用户的ID Token里，验证起来高效且安全。

如何设置管理员Claims？ #

管理员账号不能通过普通用户注册流程创建，必须通过Firebase Admin SDK手动设置（或者在Firebase控制台配合云函数）。比如用Node.js的Admin SDK代码示例：

const admin = require('firebase-admin');
admin.initializeApp();

// 给指定用户设置管理员角色
async function setAdminRole(uid) {
  await admin.auth().setCustomUserClaims(uid, {
    role: 'admin'
  });
  console.log(`用户 ${uid} 已设置为管理员`);
}

// 调用示例：替换成你的管理员用户UID
setAdminRole('your-admin-user-uid');

你可以通过Firebase控制台的「Authentication」页面获取管理员用户的UID，或者在创建管理员账号时记录下来。

2. 前端登录时验证管理员权限 #

用户登录后，我们需要解析其ID Token里的Claims，判断是否为管理员，然后控制页面访问：

步骤1：登录后获取并验证Claims #

不管是普通登录还是管理员登录，登录成功后都要检查角色：

// 登录成功后的回调（比如在signInWithEmailAndPassword之后）
firebase.auth().signInWithEmailAndPassword(email, password)
  .then((userCredential) => {
    const user = userCredential.user;
    // 获取用户ID Token并解析Claims
    return user.getIdTokenResult();
  })
  .then((idTokenResult) => {
    // 判断是否是管理员
    const isAdmin = idTokenResult.claims.role === 'admin';
    if (isAdmin) {
      // 跳转到管理员页面
      window.location.href = '/admin-dashboard';
    } else {
      // 普通用户跳转到用户首页，或者如果是访问管理员登录页则提示无权限
      if (window.location.pathname === '/admin-login') {
        alert('你没有管理员权限，请登录普通账号');
        window.location.href = '/user-login';
      } else {
        window.location.href = '/user-dashboard';
      }
    }
  })
  .catch((error) => {
    console.error('登录失败:', error);
  });

步骤2：拦截管理员页面的直接访问 #

即使普通用户手动输入管理员页面的URL，也要在页面加载时验证权限：

// 在管理员页面的初始化代码里添加
firebase.auth().onAuthStateChanged((user) => {
  if (user) {
    user.getIdTokenResult().then((idTokenResult) => {
      if (!idTokenResult.claims.role || idTokenResult.claims.role !== 'admin') {
        // 无权限，强制跳转到普通用户页
        window.location.href = '/user-dashboard';
      }
    });
  } else {
    // 未登录，跳转到登录页
    window.location.href = '/login';
  }
});

3. 补充：管理员账号的创建方式 #

如果你还没有管理员账号，有两种方式创建：

• 方式1：Firebase控制台手动创建：进入「Authentication」→「用户」→「添加用户」，创建管理员邮箱和密码，然后用上面的Admin SDK代码给这个用户设置Claims。
• 方式2：后台专属接口创建：写一个云函数，只有你能调用（比如通过API密钥验证），在云函数里创建用户并设置管理员Claims，避免手动操作。

4. 注意事项 #

• 不要在前端代码里硬编码管理员邮箱/UID，这样不安全，容易被篡改。
• 自定义Claims设置后，用户需要重新登录才能生效，因为旧的ID Token不会包含新的Claims。
• 如果你的应用有后端API或者云函数，也要在服务端验证Claims，比如云函数里：

exports.adminOnlyFunction = functions.https.onCall((data, context) => {
  if (!context.auth?.token.role || context.auth.token.role !== 'admin') {
    throw new functions.https.HttpsError('permission-denied', '只有管理员能调用此函数');
  }
  // 执行管理员操作
});

这样就能彻底实现管理员登录的权限控制，普通用户既无法通过管理员登录页登录，也无法直接访问管理员页面啦。

内容的提问来源于stack exchange，提问作者Dharmesh