使用Azure B2C Identity Experience Framework调用自定义函数的问题咨询

当然可行！Azure B2C的Identity Experience Framework（IEF）原生支持调用自定义HTTP端点（比如你开发的自定义函数），调用失败通常是配置细节没踩对。下面是完整的配置和排查步骤：

1. 检查TrustFrameworkExtensions.xml中的TechnicalProfile配置 #

首先要确保你在<ClaimsProviders>下正确定义了调用自定义函数的TechnicalProfile，示例配置如下：

<ClaimsProvider>
  <DisplayName>Custom Function</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Call-My-Custom-Function">
      <DisplayName>Call My Custom Function</DisplayName>
      <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <Metadata>
        <!-- 替换成你的自定义函数URL -->
        <Item Key="ServiceUrl">https://your-function-app.azurewebsites.net/api/your-function</Item>
        <Item Key="HttpMethod">POST</Item>
        <Item Key="UseClaimAsUsername">false</Item>
        <!-- 如果函数返回JSON，设置这个参数 -->
        <Item Key="ContentType">application/json</Item>
      </Metadata>
      <!-- 如果你的函数需要密钥验证，添加这段 -->
      <Authentication>
        <Item Key="AuthorizationType">FunctionKey</Item>
        <Item Key="FunctionKey">your-function-access-key-here</Item>
      </Authentication>
      <!-- 定义要传给函数的输入声明 -->
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="objectId" PartnerClaimType="userId" />
        <InputClaim ClaimTypeReferenceId="email" PartnerClaimType="userEmail" />
      </InputClaims>
      <!-- 定义函数返回的输出声明 -->
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="customClaimFromFunction" PartnerClaimType="functionResponseClaim" />
      </OutputClaims>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

重点检查：

• ServiceUrl是否是函数的完整可访问URL（包括路由）
• HttpMethod是否和函数的触发方式匹配（比如POST/GET）
• 如果函数需要认证，Authentication节点是否配置正确（比如FunctionKey或者OAuth2）

2. 确保自定义函数的可访问性 #

如果你的函数是Azure Functions，需要：

• 关闭IP限制（或者将Azure B2C的IP地址加入允许列表，可在Azure门户的函数应用>网络>防火墙中配置）
• 确认函数密钥正确，并且在TechnicalProfile中配置的密钥有调用权限
• 直接通过Postman或浏览器测试函数URL，确保能正常返回预期的JSON响应

3. 在用户旅程中添加调用步骤 #

你需要在用户旅程的<OrchestrationSteps>中加入调用这个TechnicalProfile的步骤，比如：

<UserJourney Id="SignUpOrSignIn">
  <OrchestrationSteps>
    <!-- 其他步骤（比如登录/注册） -->
    <OrchestrationStep Order="5" Type="ClaimsExchange">
      <ClaimsExchanges>
        <ClaimsExchange Id="CallCustomFunctionExchange" TechnicalProfileReferenceId="Call-My-Custom-Function" />
      </ClaimsExchanges>
    </OrchestrationStep>
    <!-- 后续步骤（比如生成令牌） -->
  </OrchestrationSteps>
</UserJourney>

注意调整Order值，确保步骤在合适的时机执行（比如用户登录后、令牌生成前）

4. 验证输入输出声明匹配 #

• 确保<InputClaims>中定义的ClaimType已经在<ClaimTypes>中声明
• 函数返回的JSON字段名要和<OutputClaims>中的PartnerClaimType完全匹配，否则B2C无法解析返回的声明

5. 排查错误日志 #

如果还是调用失败，打开Azure B2C的Application Insights日志，搜索包含你的函数URL的请求，查看具体的错误信息：

• 常见错误包括：函数URL不可达、认证密钥无效、输入参数缺失、返回格式不匹配

内容的提问来源于stack exchange，提问作者MIMUSH-MSFTE