Firebase项目安装Algolia扩展时授予Firebase Service Agent密钥访问权限报错

问题表现 #

• 向Firebase项目安装Algolia扩展时触发权限类报错
• 点击「Create secret」按钮后弹出报错提示：There was an error granting Firebase Service Agent access to your secret
• 对应报错截图：
  
  

修复步骤 #

• 第一步：确认操作账号权限
  你用于操作的Google Cloud账号需要拥有当前Firebase关联GCP项目的所有者(Owner)或者Secret Manager管理员权限，权限不足会导致无法给服务代理分配密钥访问权限
• 第二步：手动配置Firebase服务代理的密钥访问权限
  1. 进入当前项目的Google Cloud控制台，打开IAM权限管理页面
  2. 点击「授予访问权限」，在新成员输入框填写Firebase扩展服务代理账号：service-<你的GCP项目编号>@gcp-sa-firebaseextensions.iam.gserviceaccount.com，项目编号可在GCP项目设置页面查询
  3. 为该服务代理分配Secret Manager 密钥访问者(Secret Accessor)角色，保存配置
• 第三步：重试扩展安装
  回到Firebase扩展安装页面刷新，重新触发创建密钥操作即可完成安装

异常排查 #

如果执行上述步骤后仍然报错，可做两项额外检查：

• 确认GCP项目已启用Secret Manager API，未启用可在GCP的API和服务管理页面搜索Secret Manager API手动开启
• 检查你设置的密钥名称是否包含特殊字符或和已有密钥重名，建议使用纯字母+数字的格式命名

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