如何初始化V2版Firebase Cloud Functions以使用Firebase Admin SDK服务账号认证

我非常喜爱Google产品，但有时其文档过于简洁或零散。曾看过一篇条理清晰的分步指南，但该指南过于贴合作者的项目，并不适用于我的场景。

将现有Firebase项目中已重构为V2版本的多个云函数克隆到新项目后，遇到了此前从未出现过的权限不足问题。过去所有操作均通过Firebase完成，现在需在Google Cloud中进行，且V2版本大幅强化了安全协议与权限控制，但相关文档未能及时跟进。

以下函数抛出权限不足错误：

const {initializeApp} = require("firebase-admin/app");
const {getAuth} = require("firebase-admin/auth");
const {onDocumentCreated} = require("firebase-functions/v2/firestore");

initializeApp();

exports.assignAdminPrivileges = onDocumentCreated("admins/{docId}", async (event) => {
    try {
        const doc = event.data.data();
        const emailAddress = doc.private.emailAddress;
        const userRecord = await getAuth().getUserByEmail(emailAddress);

        return getAuth().setCustomUserClaims(userRecord.uid, {"admin": true});
    } catch (error) {
        throw new Error(error);
    }
});

据我理解，该函数默认使用Google Cloud中的「默认计算服务账号」进行认证，而该账号权限不足以执行此任务。我认为应改用与Google Cloud账号配套的「Firebase Admin SDK服务账号」。尽管Google警告不要下载该密钥，但目前场景下最适合的方式是下载Firebase Admin SDK服务账号的密钥文件，并在源码中配合Admin SDK的自定义初始化使用。

待完善的初始化代码：

const {initializeApp} = require("firebase-admin/app");

initializeApp({
    credential: // 我知道需要这里配置，但该如何填写？,
});

// 以及该如何处理JSON密钥文件？

我的问题： #

1. 如何在源码中通过Credential正确初始化Admin SDK，使函数使用Firebase Admin SDK服务账号进行认证？
2. 已从GC控制台获取包含Admin SDK服务账号凭证（含私钥）的JSON文件，该如何处理？

步骤1：处理密钥文件 #

• 将下载的JSON密钥文件重命名为service-account-key.json（或自定义名称），放在云函数项目的根目录下。重要提醒：务必将该文件添加到.gitignore中，避免代码仓库泄露敏感密钥。

步骤2：修改Admin SDK初始化代码 #

引入firebase-admin的cert方法，加载本地密钥文件完成初始化，代码示例：

const {initializeApp, cert} = require("firebase-admin/app");
// 引入本地密钥文件，路径根据实际文件位置调整
const serviceAccount = require("./service-account-key.json");

initializeApp({
  credential: cert(serviceAccount)
});

步骤3：额外注意事项 #

• 权限验证：确保你的Firebase Admin SDK服务账号已拥有Firebase Auth Admin权限，可在Google Cloud控制台的IAM页面配置。
• 部署说明：使用Firebase CLI部署时，只要密钥文件在项目目录内且未被.gitignore排除，CLI会自动将其打包部署，无需手动上传。
• 更安全的替代方案（推荐）：如果不想下载密钥文件，可直接为默认计算服务账号添加权限：
  1. 打开Google Cloud控制台IAM页面，找到默认计算服务账号（格式为[项目ID]@appspot.gserviceaccount.com）。
  2. 点击编辑按钮，添加Firebase > Firebase Auth Admin角色。
  3. 保存配置后重新部署云函数即可。

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