使用 BizTalk WCF-WebHttp 发送端口传递 URL 参数时的编码问题

Question

我正在尝试在 BizTalk 中调用 RESTful API。我需要针对以下端点进行 GET：

https://mycompany.com/buyer/sandboxevol/

我的发送端口中配置了以下映射

<BtsHttpUrlMapping>
  <Operation Name='Operation_1' Method='GET' Url='/page.aspx/en/eai/api/supplier/{id}?apikey={apikey}&amp;format={format}' />
</BtsHttpUrlMapping>

参数 apikey 的值为 XXXXXXXXXXzvrpZHbMdKY75zbszhGOu%2bfnmP7Ms%3d。我已经检查了这一点并从暂停的实例中进行了验证。 但错误消息存在不同的 apikey 值。 参考截图错误信息（hkey值突出显示）

字符 % 在错误消息中被编码为 %25。我认为有两个问题

1. 无效的 APi 密钥问题（这篇文章讨论了这个问题）和
2. BizTalk 和第 3 方系统之间打开了一些防火墙/代理（我将与内部管理团队核实）

关于解决此编码/奇怪问题的任何想法

Answer 1

根据错误，它很可能是由于 TLS 版本不匹配而发生的。 BizTalk 2013 默认使用 TLS1.0。现在推荐的版本是使用 TLS1.2 或更高版本。您可以向 API 提供商查询他们使用的 TLS 版本。您可以通过创建自定义发送管道组件来更改 BizTalk 行为，然后在 Execute 方法中使用以下代码设置 TLS 版本。管道组件中的 BizTalk 消息无需更改，只需放置这一行代码并从执行方法返回相同的 pInMsg。

System.Net.SecurityPointManager.SecurityProtocol = SecurityProtocolType.Tls12

引用Microsoft doc

您还可以使用 Postman、Fiddler 等外部工具在 BizTalk 外部测试 API 调用，以确保 API 在 BizTalk 外部工作。

    public IBaseMessage Execute(IPipelineContext pContext, IBaseMessage pInMsg)
    {


        System.Net.SecurityProtocolType protocolType;
        if (!String.IsNullOrEmpty(TlsVersion)
            && Enum.TryParse<System.Net.SecurityProtocolType>(TlsVersion, true, out protocolType))
            System.Net.ServicePointManager.SecurityProtocol = protocolType;
        else
            System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;


        return pInMsg;
    }