You need to enable JavaScript to run this app. 如何解决Python程序中Cloud Firestore安全规则不生效的问题
优惠活动
大模型
产品
解决方案
定价
更多

如何解决Python程序中Cloud Firestore安全规则不生效的问题

核心原因说明

Firebase Admin SDK 从设计层面就会完全绕过所有 Firestore 安全规则:

  • 当前代码使用的服务账号凭据,自带项目级最高数据库权限,Firestore 服务端识别到这类特权请求时,会直接跳过所有规则校验流程,不存在任何配置可以让 Admin SDK 遵守安全规则。
  • Firestore 安全规则的校验对象,是所有携带普通 Firebase Auth 用户身份的非特权客户端请求,从设计之初就不覆盖 Admin SDK 这类服务端管理请求。
Python 场景下让安全规则正常生效的实现方案

要触发规则校验,核心是让请求被 Firestore 服务端识别为携带合法用户身份的普通客户端请求,而非服务账号发起的特权请求,具体实现步骤如下:

  • 生成匹配规则要求的测试用户的合法 Firebase Auth ID Token:先在 Firebase Auth 模块创建对应 uid 的测试用户,通过 Admin SDK 的 auth 模块为测试用户生成自定义令牌,再交换为 Firestore 可识别的短期用户 ID Token(自定义令牌本身无法直接访问 Firestore)
  • 不使用 Admin SDK 提供的默认 Firestore 客户端,改用普通 Firestore 客户端,在所有请求中手动携带生成的用户 ID Token,触发服务端的规则校验

参考实现代码

  1. 生成测试用户 ID Token(仅用于开发场景,Admin SDK 仅承担令牌生成功能,不用于数据库操作)
import firebase_admin
from firebase_admin import auth, credentials
import requests

cred = credentials.Certificate('key.json')
firebase_admin.initialize_app(cred)

# 为uid为test的测试用户生成自定义令牌
custom_token = auth.create_custom_token("test")
# 交换为可访问Firestore的用户ID Token
token_resp = requests.post(
    "identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken?key=<你的项目Web API Key>",
    json={"token": custom_token.decode(), "returnSecureToken": True}
)
user_id_token = token_resp.json()["idToken"]
  1. 创建带用户身份校验的普通 Firestore 客户端
from google.cloud import firestore

# 初始化普通Firestore客户端,不挂载服务账号凭据
db = firestore.Client(
    project="<你的Firebase项目ID>",
    credentials=None
)

# 给客户端所有请求添加身份鉴权头,触发规则校验
original_grpc_call = db._firestore._stub._grpc_call
def auth_grpc_call(channel, metadata):
    metadata = dict(metadata)
    metadata["authorization"] = f"Bearer {user_id_token}"
    return original_grpc_call(channel, metadata)
db._firestore._stub._grpc_call = auth_grpc_call

# 执行操作时会严格按照安全规则校验权限
try:
  doc_ref = db.collection('users').document('test')
  doc_ref.set({'password':'testPass','shadow':'testShadow'})
  print('success')
except Exception as e:
  print(f'failed: {e}')
注意事项
  • 上述方式创建的客户端,所有数据库操作都会严格匹配已配置的安全规则:如果规则判断权限不通过,会直接抛出权限不足错误,不会再出现规则被绕过的情况。
  • 按照当前配置的规则逻辑,只有使用uid为test的用户ID Token去操作users/test文档时才会通过校验;如果使用其他uid的Token发起请求,会被规则直接拦截抛出权限错误,可直接验证规则的生效状态。
  • 如果只是快速验证规则逻辑是否正确,不需要编写测试代码,可以直接使用 Firebase Console 内置的规则模拟器完成测试。
  • 服务端发起的管理类操作,不要依赖 Firestore 安全规则做权限限制,这类校验逻辑需要写在自身的业务代码中。

内容的提问来源于stack exchange,提问作者viswa_2k

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 14:06:06