能否通过Firebase Admin Python SDK实现TOTP多因素认证？

核心结论 #

当前Firebase Admin Python SDK（包括最新版本）暂未实现TOTP多因素认证的完整服务端API，官方文档中提到的Admin SDK 11.6.0+支持TOTP MFA，仅针对Node.js版本的SDK。

可行操作方案 #

1. 前端完成TOTP核心流程 #

使用v9.19.1+的模块化Firebase JS SDK完成TOTP MFA的客户端操作，包括：

• 生成TOTP密钥并展示给用户
• 验证用户输入的TOTP验证码
• 为用户启用TOTP MFA因子

这部分流程可完全在前端完成，无需后端介入核心逻辑。

2. Python后端的辅助操作 #

虽然Python Admin SDK无法生成或验证TOTP，但可以处理以下辅助场景：

• 查询用户MFA状态：获取用户已启用的MFA因子列表，判断是否已开启TOTP
• 禁用用户TOTP因子：移除用户的TOTP MFA配置

示例代码片段：

import firebase_admin
from firebase_admin import auth

# 初始化Admin SDK（已完成初始化可跳过）
if not firebase_admin._apps:
    cred = firebase_admin.credentials.Certificate('service-account-key.json')
    firebase_admin.initialize_app(cred)

# 查询用户MFA状态
user = auth.get_user('user-uid')
if user.mfa_info:
    totp_factors = [factor for factor in user.mfa_info if factor.provider_id == 'totp']
    if totp_factors:
        print("用户已启用TOTP MFA")
    else:
        print("用户未启用TOTP MFA")

# 禁用用户的TOTP因子
if totp_factors:
    totp_factor_uid = totp_factors[0].uid
    auth.update_user(
        'user-uid',
        mfa_info=[factor for factor in user.mfa_info if factor.uid != totp_factor_uid]
    )
    print("已禁用用户TOTP MFA")

3. 完整服务端控制的替代方案 #

如果需要在Python后端实现TOTP的生成、验证等核心操作，可以直接调用Identity Platform REST API（Python SDK尚未封装这些接口）。例如：

• 调用projects.accounts.enroll接口为用户生成TOTP密钥
• 调用projects.accounts.signIn接口验证TOTP验证码

可通过requests库发送HTTP请求，使用服务账号密钥生成OAuth 2.0访问令牌进行身份验证。

后续建议 #

持续关注Firebase Admin Python SDK的官方更新日志，一旦SDK添加了TOTP MFA的相关API，即可切换到原生SDK实现。

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