如何为B2C本地登录流程添加可传至API连接器的额外字段？

1. 创建自定义用户属性 #

• 登录Azure AD B2C租户后台，进入用户属性页面，点击添加按钮。
• 填写属性标识名（如CustomInputField）、前端显示名称（如“自定义输入项”），数据类型选择字符串，勾选“在用户流中可用”后保存。系统会自动为该属性添加extension_前缀，最终属性名为extension_CustomInputField。

2. 在SignInOrUp用户流中配置字段收集 #

• 进入用户流页面，找到目标SignInOrUp本地登录流，点击编辑。
• 在用户属性选项卡中，将刚创建的自定义属性添加到“收集的属性”列表；若需要该字段出现在返回令牌中，同时添加到“返回的声明”列表。
• 若要在登录页面显示该字段（默认仅注册页面显示），需启用自定义页面布局：
  • 开启用户流的自定义页面布局开关，上传自定义HTML登录页面，在表单中添加对应输入框，绑定字段名为extension_CustomInputField。
  • 若使用自定义策略，直接在SelfAsserted-LocalSignin技术配置文件中添加该字段的声明定义，无需依赖自定义HTML。

3. 更新API连接器的字段映射 #

• 进入API连接器页面，打开已配置的连接器编辑界面。
• 在请求正文模板中，添加自定义字段的映射规则，示例如下：

  {
    "userEmail": "{{user.email}}",
    "customInputContent": "{{extension_CustomInputField}}"
  }
  

• 确认API连接器的触发时机设置为登录前（确保用户提交登录表单后，字段内容随请求发送到API）。

4. 验证功能 #

• 运行目标用户流，在登录/注册页面填写自定义字段内容并提交。
• 查看API连接器的请求日志，确认自定义字段已成功传递；同时检查返回的令牌，验证API连接器添加的额外声明是否正常生成。

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