如何解决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,触发服务端的规则校验
参考实现代码
- 生成测试用户 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"]
- 创建带用户身份校验的普通 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
相关产品推荐
相关产品推荐

