TypeScript编写的Google Identity Platform认证阻塞函数部署问题

问题1：代码方法签名是否正确 #

• 核心方法签名符合GCIP阻塞函数的规范：beforeCreateHandler接收user（用户注册信息对象）和context（请求上下文对象）两个入参，抛出HttpsError终止注册流程的逻辑也符合要求。
• 可优化点：
  1. 代码中导入的firebase-functions、firebase-admin两个依赖未使用，可直接删除避免冗余打包。
  2. TypeScript项目建议给两个入参补充类型声明，获得更好的类型校验：

  import type { BeforeCreateUserRecord, AuthEventContext } from 'gcip-cloud-functions';
  exports.beforeCreateBlockingFunction = authClient.functions().beforeCreateHandler((user: BeforeCreateUserRecord, context: AuthEventContext) => {
    // 你的逻辑
  });
  

  3. 当前代码逻辑会禁止所有用户注册，如果你需要保留指定邮箱/域名的注册权限，可以在抛出错误前加判断条件。

问题2：部署命令是否适配TypeScript项目 #

你提供的命令存在几处问题，不适配当前TypeScript项目，调整方案如下：

1. 运行时版本过低：nodejs10已停止维护，且不兼容最新版gcip-cloud-functions SDK，建议替换为--runtime nodejs18或--runtime nodejs20。
2. 缺少TypeScript编译步骤：Node.js无法直接执行TypeScript代码，部署前需要先执行tsc命令将TS源码编译为JS产物，确保部署根目录下存在编译后的index.js文件，且package.json中已声明所有生产依赖。
3. 多余的权限配置：--allow-unauthenticated参数无需添加，GCIP调用阻塞函数时会通过官方专用服务账号鉴权，开放公网无权限访问会带来安全风险，删除该参数后，单独给GCIP服务账号授予Cloud Functions Invoker权限即可。
4. 调整后的参考部署流程：

# 第一步：编译TS为JS
tsc
# 第二步：部署函数（根据你的实际情况修改区域）
gcloud functions deploy beforeCreateBlockingFunction --runtime nodejs18 --region europe-west1 --trigger-http

5. 额外注意：函数部署完成后，需要进入Google Cloud控制台的Identity Platform设置页面，将该函数绑定到beforeCreate阻塞事件上才会正式生效。

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